AI-translated from English; not yet reviewed by a fluent editor.

# Audit satu sesi agen pemrograman dengan AgentsView

> Temukan transkrip lokal agen pemrograman yang sudah diketahui di AgentsView, periksa token tercatat dan asal angka biaya, lalu baca laporan harian dengan cakupan terbatas tanpa menganggap estimasi sebagai tagihan.

By BIG CHANGE Editorial

Published: 2026-10-17T17:20:34.907Z
Updated: 2026-10-17T17:20:34.907Z
Canonical: https://bigchange.ai/blog/audit-coding-agent-session-agentsview

![Conceptual charcoal illustration of a local computer with one blank transcript line highlighted and an external drive beside it.](https://bigchange.ai/api/media/file/agentsview-local-session-audit-concept-v1.png)
AI-generated conceptual illustration by BIG CHANGE; no actual AgentsView interface, transcript, usage figure or billing result is depicted.

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](https://www.agentsview.io/docs/quickstart/) 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](https://www.agentsview.io/docs/quickstart/). Untuk CLI mandiri, pemasangan Python permanen yang didokumentasikan adalah:

```sh
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](https://github.com/kenn-io/agentsview/releases/tag/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](https://www.agentsview.io/docs/configuration/#disabling-session-providers) 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](https://www.agentsview.io/docs/configuration/#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](https://www.agentsview.io/docs/quickstart/#docker) 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](https://github.com/kenn-io/agentsview/blob/main/docker-compose.prod.yaml). 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:

```sh
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](https://www.agentsview.io/docs/quickstart/). 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](https://www.agentsview.io/docs/token-usage/) 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](https://www.agentsview.io/) 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:

```sh
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](https://www.agentsview.io/docs/quickstart/) 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](https://github.com/kenn-io/agentsview/releases/tag/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](https://www.agentsview.io/docs/quickstart/): jalur pemasangan yang didukung, perintah server dan daemon, konfigurasi sumber, serta kontrol pencarian lokal.
- [Konfigurasi AgentsView](https://www.agentsview.io/docs/configuration/): penemuan sumber, pengecualian penyedia, lokasi arsip, dan batas kontrol tersebut.
- [Penggunaan Token dan Biaya AgentsView](https://www.agentsview.io/docs/token-usage/): cakupan sumber, laporan penggunaan, asal harga, mode offline, dan keterbatasan pelaporan yang diketahui.
- [Repositori AgentsView](https://github.com/kenn-io/agentsview): kode sumber dan lisensi MIT; repositori menggambarkan arsip bawaan sebagai lokal.

## Sources

- [Catatan rilis AgentsView v0.45.0](https://github.com/kenn-io/agentsview/releases/tag/v0.45.0) — Rilis bertanggal serta perubahan fitur dan cakupan.
- [AgentsView Quick Start](https://www.agentsview.io/docs/quickstart/) — Pemasangan, menjalankan, pemilihan sumber, dan kontrol pencarian.
- [Konfigurasi AgentsView](https://www.agentsview.io/docs/configuration/) — Penemuan sumber, pengecualian penyedia, direktori data, dan batas kontrol.
- [Penggunaan Token dan Biaya AgentsView](https://www.agentsview.io/docs/token-usage/) — Pelaporan penggunaan eksperimental, asal harga, dan keterbatasan.
- [Repositori kode sumber AgentsView](https://github.com/kenn-io/agentsview) — Kode sumber, deskripsi proyek, dan lisensi MIT.