AgentsView dapat menggabungkan log sesi agen pemrograman dari beberapa alat ke dalam satu arsip lokal yang dapat dicari. Panduan ini ditujukan bagi pemimpin tim rekayasa yang perlu menemukan satu tugas yang sudah diketahui, memeriksa kolom penggunaan yang benar-benar dicatat agennya, dan mengidentifikasi sumber setiap angka biaya.

Ini adalah panduan berbasis dokumentasi untuk rilis AgentsView v0.45.0 tanggal 9 Oktober 2026 serta panduan mulai cepat dan penggunaan token saat ini, yang diperiksa pada 17 Oktober. BIG CHANGE belum memasang AgentsView, mengimpor transkrip, atau menguji langkah-langkah ini. Periksa versi yang Anda pasang karena dokumentasi dan daftar rilis dapat berubah.

Sebelum memulai

Anda memerlukan sesi agen pemrograman yang telah selesai dan boleh Anda baca, frasa khas atau ID sesi dari tugas itu, serta izin membaca direktori log lokalnya. Quick Start mencantumkan unduhan desktop untuk macOS, Windows, dan Linux, dengan paket wheel CLI untuk Linux x86_64 dan aarch64, macOS x86_64 dan arm64, serta Windows x86_64 dan arm64. Aplikasi desktop sudah dibundel; kompilasi dari sumber memiliki persyaratan Go, Node, dan CGO tersendiri. Menurut panduan mulai cepat, pengarsipan lokal dasar tidak memerlukan akun layanan terhos atau kunci API.

Log sesi dapat berisi prompt, kode sumber, masukan alat, dan rahasia. Pilih hanya direktori yang diizinkan tim untuk Anda periksa. Tentukan penyedia dan direktori akar mana yang boleh dimasukkan ke arsip sebelum pertama kali dijalankan: menjalankan agentsview serve tanpa opsi langsung menemukan dan menyinkronkan sumber bawaan yang didukung. Pertahankan antarmuka web pada alamat loopback yang didokumentasikan untuk latihan ini. Jangan aktifkan sinkronisasi data mentah terhos, pengiriman ke PostgreSQL atau ClickHouse, publikasi Gist, wawasan yang dihasilkan, ataupun endpoint embedding terhos hanya untuk menjawab pertanyaan ini. Pencarian semantik bersifat opsional; pencarian teks lengkap biasa bekerja dengan indeks lokal.

1. Pasang dan identifikasi berkas eksekusinya

Pilih satu metode dalam panduan pemasangan. Untuk CLI mandiri, pemasangan Python permanen yang didokumentasikan adalah:

Terminal
pip install agentsview
agentsview --version

Panduan juga menawarkan uvx agentsview untuk menjalankan tanpa pemasangan permanen, pemasang khusus platform, dan paket desktop. Pada macOS, cask Homebrew menautkan CLI yang dibundel aplikasi; aplikasi yang dipasang dari DMG mungkin memerlukan direktori CLI-nya ditambahkan ke PATH. Pastikan berkas eksekusi mana yang ditemukan shell sebelum mempercayai versinya. GitHub memberi label v0.45.0 sebagai rilis 9 Oktober, tetapi gunakan hasil --version Anda sendiri saat menafsirkan layar dan skema laporan.

2. Batasi sumber sebelum sinkronisasi pertama

Untuk pemasangan CLI atau desktop di host, siapkan direktori data baru beserta config.toml sebelum memulai AgentsView. Panduan konfigurasi mendokumentasikan disabled_agents untuk mengecualikan penyedia sistem berkas lokal dan [agents.<id>].dirs untuk mengganti akar bawaan satu penyedia. Cantumkan semua ID penyedia lainnya dari tabel Session Discovery dalam panduan itu ke disabled_agents, lalu atur dirs milik satu-satunya penyedia yang diizinkan ke akar yang disetujui. Misalnya, [agents.codex] dengan dirs = ["/approved/codex/sessions"] mengganti direktori bawaan Codex; sesuaikan jalurnya dengan sistem Anda. Jika daftar pengecualian belum lengkap, jangan mulai daemon host dahulu. Satu penimpaan CODEX_SESSIONS_DIR atau CLAUDE_PROJECTS_DIR mengubah akar penyedia itu, tetapi membiarkan penyedia lain tetap memenuhi syarat untuk penemuan bawaannya sendiri.

Gunakan AGENTSVIEW_DATA_DIR baru untuk audit ini jika arsip yang ada mungkin sudah berisi sesi yang tidak terkait. Panduan konfigurasi mengatakan sesi yang sudah diarsipkan dari penyedia yang dinonaktifkan tetap tersedia, sehingga perubahan pengaturan tidak membersihkan arsip lama. Panduan itu juga menyebut disabled_agents mencakup penemuan dan pemantauan lokal, bukan impor atau ekspor jarak jauh; biarkan host jarak jauh dan tujuan ekspor tidak dikonfigurasi untuk tugas lokal ini.

Kontainer terisolasi merupakan alternatif ketika memelihara daftar pengecualian semua penyedia lain tidak praktis. Contoh Docker dalam Quick Start memublikasikan antarmuka hanya pada 127.0.0.1, memasang sumber satu agen dalam mode hanya baca, dan menggunakan volume data terpisah. Pasang hanya akar sumber yang diizinkan dan atur variabel direktori yang sesuai di dalam kontainer baru; hilangkan pemasangan lain dalam contoh Compose proyek. Kontainer hanya melihat direktori sesi host yang dipasang secara eksplisit. Citra Docker yang diterbitkan mencakup Linux amd64 dan arm64; jalur ini memerlukan pemasangan Docker yang berfungsi.

3. Bangun arsip lokal

Untuk CLI host dengan cakupan sumber terbatas, mulai server latar depan yang didokumentasikan:

Terminal
agentsview serve

Setelah menerapkan dan memeriksa cakupan sumber pada langkah 2, tindakan ini menginisialisasi ~/.agentsview/sessions.db —atau direktori data yang dipilih—, menemukan log agen yang diaktifkan, menyinkronkannya, memantau perubahan, dan membuka http://127.0.0.1:8080. Biarkan terminal itu terbuka. Jika lebih memilih proses latar belakang, gunakan agentsview daemon start dan agentsview daemon status; aplikasi desktop mengelola backend-nya sendiri. Server kompatibel yang sudah berjalan mungkin hanya melaporkan URL-nya, jadi periksa daemon yang sedang berjalan sebelum menganggap konfigurasi baru mengatur pemasukan data.

Jika memilih kontainer terisolasi, mulai dengan perintah Docker yang didokumentasikan setelah memeriksa satu pemasangan sumber hanya baca dan volume data baru. Gunakan antarmuka loopback-nya dan jalankan laporan CLI agentsview berikutnya di dalam kontainer itu agar membaca arsip yang sama. Jangan jalankan serve host tanpa pembatasan cakupan secara bersamaan.

Periksa apakah sumber tugas yang diketahui muncul dan penyedia yang tidak diinginkan tidak muncul. Jika sesinya hilang, periksa jalur yang disetujui, pengaturan penyedia, dan status sinkronisasi sebelum menyimpulkan bahwa tidak ada sesi. Jalankan agentsview sync jika berkas yang baru berubah perlu dimasukkan sebelum laporan dibuat; server juga memantau perubahan. Periksa kembali cakupan yang dikonfigurasi sebelum setiap sinkronisasi ulang penuh.

4. Temukan tugas dan verifikasi transkrip

Dalam antarmuka web, gunakan Ctrl/Cmd+K untuk mencari frasa literal khas dari tugas yang diketahui. Persempit daftar menurut proyek, agen, atau tanggal, lalu buka kandidat dan periksa pesan serta pemanggilan alatnya. Jika sudah memiliki ID sesi lengkap atau UUID, Ctrl/Cmd+G membukanya secara langsung. Kontrol ini didokumentasikan dalam Quick Start. Catat agen, ID sesi, dan tanggal agar hasil penggunaan terhubung ke percakapan yang benar.

Jika pencarian literal tidak menemukan tugas, coba frasa lebih pendek dan pastikan agen asal menulis transkrip lokal ke direktori yang dapat dibaca AgentsView. Tugas yang hanya ada di layanan jarak jauh, format yang tidak didukung, atau direktori di luar akar yang dikonfigurasi tidak dapat dipulihkan hanya dengan mencari lebih keras. Jangan aktifkan pengindeksan semantik atau unggahan transkrip sebagai perbaikan rutin untuk sumber lokal yang hilang.

5. Periksa kolom penggunaan sesi

Buka tampilan penggunaan sesi yang cocok dan identifikasi kolom model, masukan, keluaran, pembuatan cache, serta pembacaan cache yang tercatat dan tersedia. Panduan penggunaan token memberi label pelaporan biaya sebagai eksperimental dan masih berkembang. AgentsView mengambil metadata model dan token dari log sumber serta menyimpan penggunaan token mentah pada baris pesan. Aplikasi memakai biaya eksplisit yang dilaporkan sumber jika tersedia; jika tidak, biaya dihitung dari token yang dapat digunakan dan tarif model. Catatan asal dalam JSON menyebutnya reported, computed, atau mixed.

Jika ingin menyimpan catatan yang dapat dibaca mesin untuk satu sesi itu, contoh CLI proyek menggunakan agentsview session usage SESSION_ID --format json. Ganti SESSION_ID dengan ID yang telah Anda verifikasi dalam transkrip, lalu simpan JSON bersama catatan tugas. Periksa model yang dilaporkan, kelompok token, dan sumber biaya dalam keluaran itu sebelum mengutip total apa pun.

Perlakukan kolom kosong atau model yang hilang sebagai tidak diketahui. AgentsView tidak dapat merekonstruksi penggunaan yang tidak pernah ditulis agen. Catatan rilisnya mengatakan pemasukan Junie CLI mengecualikan percakapan dan pemanggilan alat yang hanya ada di IDE, sedangkan cadangan teks biasa Antigravity berisi transkrip tanpa penggunaan token atau biaya. Ini contoh nyata mengapa sesi yang dapat dicari belum tentu memiliki angka pengeluaran lengkap. Jumlah yang dilaporkan sumber juga dapat menggambarkan total sesi, sementara alokasi per model tetap merupakan estimasi.

6. Batasi laporan harian

Gunakan filter tanggal, proyek, dan agen pada halaman Usage untuk memeriksa hari yang memuat sesi. Halaman itu juga menawarkan tabel Top Sessions by Cost yang menautkan ke transkrip masing-masing. Untuk laporan terminal yang dapat diaudit, gantikan tanggal lokal dan nama agen sesi dalam:

Terminal
agentsview usage daily --since YYYY-MM-DD --until YYYY-MM-DD --agent codex --breakdown

Tabel harian memisahkan masukan tanpa cache, keluaran, pembuatan cache, dan pembacaan cache, dengan baris per model saat --breakdown diaktifkan. Tanggal dikelompokkan menurut zona waktu sistem kecuali --timezone diberikan. Total harian dapat mencakup sesi lain dari agen itu; ini pemeriksaan cakupan dan besaran, bukan biaya satu tugas. Sertakan ID sesi bersama laporan harian dan periksa baris mana yang benar-benar miliknya.

Untuk laporan tanpa mengambil katalog harga, tambahkan --offline. AgentsView mengatakan ini membaca arsip yang ada tanpa sinkronisasi sumber atau memulai daemon, serta menggunakan harga cadangan yang tertanam. Segarkan arsip terlebih dahulu jika perubahan sesi terbaru penting; laporan offline tidak dapat menemukan log baru. Perintah penggunaan normal mungkin mengambil harga LiteLLM dan OpenRouter, sedangkan katalog tertanam menua seiring usia rilis yang dipasang.

7. Tafsirkan angka dan hentikan layanan

Beri label setiap angka sesuai asalnya. Computed berarti AgentsView mengalikan token tercatat dengan tarif yang dipilih. Reported berarti sumber memberikan biaya eksplisit. Mixed berarti laporan menggabungkan jenis-jenis tersebut. Bahkan angka yang dilaporkan sumber bukan bukti bahwa tagihan penyedia untuk seluruh akun telah direkonsiliasi. Bandingkan secara independen catatan penagihan atau paket penyedia terkait, terutama ketika tingkat layanan, diskon, atau jatah langganan berpengaruh. Dokumentasi AgentsView mengatakan aplikasi tidak dapat menyimpulkan harga Batch, Flex, Priority, regional, atau cache satu jam jika penggunaan yang disimpan tidak menyebut tingkat tersebut. Sebagian token di sisi alat tidak ada dalam transkrip lokal.

Pemeriksaan keberhasilan adalah transkrip yang cocok, dengan agen, ID, dan tanggal yang sesuai tampilan penggunaan terpilih; kolom model dan token yang tersedia dicatat, sedangkan yang tidak tersedia ditandai tidak diketahui. Hasilnya berupa arsip lokal yang dapat dicari dan catatan penggunaan tugas atau hari dengan cakupan terbatas, bukan tagihan. Hentikan agentsview serve di latar depan dengan Ctrl+C, atau hentikan server latar belakang dengan agentsview daemon stop. Quick Start mengatakan menghentikan daemon akan menghentikan antarmuka web sekaligus pemantau sesi.

Perubahan besar

Transkrip lokal memberi titik awal yang dapat ditelusuri untuk pembahasan biaya. Pemimpin tim rekayasa dapat mengikuti sebuah angka kembali ke tugas tertentu yang tercatat dan melihat apakah angka itu berasal dari agen atau katalog harga. Jika log tidak lengkap, laporan harus mempertahankan kekosongan tersebut.

Sumber dan bacaan lanjutan

  • Catatan rilis AgentsView v0.45.0: perubahan bertanggal pada dukungan agen, kartu Usage, sinkronisasi, dan perilaku harga. Catatan rilis merupakan catatan vendor, bukan pengujian BIG CHANGE.
  • AgentsView Quick Start: jalur pemasangan yang didukung, perintah server dan daemon, konfigurasi sumber, serta kontrol pencarian lokal.
  • Konfigurasi AgentsView: penemuan sumber, pengecualian penyedia, lokasi arsip, dan batas kontrol tersebut.
  • Penggunaan Token dan Biaya AgentsView: cakupan sumber, laporan penggunaan, asal harga, mode offline, dan keterbatasan pelaporan yang diketahui.
  • Repositori AgentsView: kode sumber dan lisensi MIT; repositori menggambarkan arsip bawaan sebagai lokal.