Memeriksa sesi dan melacak penggunaan
Periksa sesi di Claude Console, baca penggunaan token dan biaya daftarnya, serta debug perilaku agen yang tidak terduga.
Gunakan penampil sesi di Claude Console untuk memeriksa apa yang dilakukan agen dalam sebuah sesi, tanpa menulis kode apa pun. Gunakan total usage sesi untuk melihat apa yang dikonsumsi oleh pekerjaan tersebut.
Memeriksa sesi di Console
Penampil sesi hanya dapat diakses oleh Developer dan Admin. Untuk membukanya, buka sidebar Console dan pilih Sessions di bawah Managed Agents. Daftar tersebut menampilkan setiap sesi di workspace beserta status, agen, penggunaan token, biaya, dan waktu pembuatannya. Pilih sebuah sesi untuk membukanya.
Penampil sesi menampilkan:
- Timeline minimap: Ikhtisar aktivitas sesi dari waktu ke waktu yang dapat diperbesar, dengan satu jalur per thread dalam sesi multiagen. Pilih sebuah jalur untuk melihat thread tersebut, atau pilih sebuah penanda untuk melompat ke event-nya.
- Transcript: Percakapan yang dikelompokkan berdasarkan permintaan model, termasuk pemikiran, panggilan alat beserta input dan hasilnya, serta teks pesan saat di-streaming. Anda dapat memfilter event dan menyalin atau mengunduhnya sebagai JSON.
- Inspector: Panel samping yang dapat diubah ukurannya dengan detail tentang sesi, dalam lima tab.
| Tab Inspector | Apa yang ditampilkan |
|---|---|
| Session | Detail dan metadata sesi, biaya kumulatifnya dari waktu ke waktu, dan pengeluaran terhadap anggaran sesi jika ditetapkan. |
| Events | Setiap event mentah pada thread saat ini, dalam urutan yang dikirim oleh server. Pilih sebuah event untuk melihat JSON-nya. Pesan yang di-streaming saat halaman terbuka juga memiliki tampilan Deltas dari event delta-nya. |
| Tools | Alat yang dikonfigurasi untuk agen-agen sesi, beserta jumlah panggilan, kegagalan, dan durasi median. Pilih sebuah alat untuk melihat panggilannya dan melompat ke salah satunya di transkrip. |
| Resources | File, repositori, dan memory store yang di-mount pada path container-nya, termasuk memori di setiap store dan perubahan yang dibuat sesi ini terhadapnya. Juga mencantumkan file yang ditulis agen ke /mnt/session/outputs dan skill yang dilampirkan ke agen-agen sesi. |
| Threads | Setiap thread beserta status, ukuran konteks, dan biayanya. Pilih sebuah thread untuk melihat detailnya, seperti agen, model, penggunaan konteks, dan biaya. |
Tambahkan ?event={event_id} ke URL sesi untuk membuka sesi pada event tertentu.
Dengan ant beta:sessions connect, Anda dapat membuka penampil yang sama dari CLI ant atau mengikuti sesi di terminal Anda. Lihat Terhubung ke sesi Managed Agents dari terminal Anda.
Melacak penggunaan
Objek sesi menyertakan field usage dengan penggunaan kumulatif sesi: jumlah token, penggunaan alat server, waktu aktif, dan biaya daftar yang dilacak. Ambil sesi setelah sesi tersebut menjadi idle untuk membaca total terbaru.
{
"id": "sesn_01...",
"status": "idle",
"usage": {
"input_tokens": 5000,
"output_tokens": 3200,
"cache_read_input_tokens": 20000,
"cache_creation": {
"ephemeral_5m_input_tokens": 2000,
"ephemeral_1h_input_tokens": 0
},
"list_cost": {
"amount": "187",
"currency": "USD"
},
"active_seconds": 342.5,
"server_tool_use": {
"web_search_requests": 3,
"web_fetch_requests": 0
}
}
}| Field | Deskripsi |
|---|---|
input_tokens | Token input yang tidak di-cache di seluruh panggilan model dalam sesi. |
output_tokens | Total token output di seluruh panggilan model dalam sesi. |
cache_read_input_tokens | Token yang dibaca dari cache prompt. |
cache_creation | Token pembuatan cache, dirinci berdasarkan masa berlaku cache (ephemeral_5m_input_tokens dan ephemeral_1h_input_tokens). |
list_cost | Konsumsi kumulatif sesi yang dihargai dengan tarif daftar publik, sebagai bilangan bulat sen dalam string, dengan kode mata uang. |
active_seconds | Waktu kumulatif selama sesi memiliki setidaknya satu thread yang berjalan. Aktivitas yang tumpang tindih dari thread yang berjalan bersamaan dihitung sekali. Biaya runtime sesi dihargai berdasarkan durasi ini. |
server_tool_use | Jumlah permintaan alat yang dieksekusi server, untuk penetapan harga. Permintaan pencarian web dihargai ke dalam biaya daftar per permintaan. Permintaan web fetch tidak dikenakan biaya per permintaan dan tidak diukur, sehingga web_fetch_requests bernilai 0. |
Entri cache menggunakan TTL 5 menit secara default, sehingga giliran berturut-turut dalam jendela waktu tersebut mendapat manfaat dari pembacaan cache, yang mengurangi biaya per token.
Objek stats sesi memiliki active_seconds sendiri, yang menjumlahkan waktu aktif masing-masing thread alih-alih menghitung aktivitas yang tumpang tindih sekali.
Penggunaan per thread
usage milik setiap thread sesi juga memuat list_cost dan active_seconds. Angka per thread dibulatkan secara independen dan tidak mencakup biaya waktu berjalan sesi, sehingga jumlahnya tidak persis sama dengan list_cost sesi. Angka sesi adalah angka yang otoritatif.
Membaca penggunaan dari stream
Anda tidak perlu melakukan polling pada sesi untuk mengamati total ini. Event session.usage membawa snapshot kumulatif yang sama pada stream sesi dan dalam riwayat event. Snapshot tersebut berisi objek usage ditambah budget sesi, yang bernilai null jika sesi tidak memilikinya.
Event ini dipancarkan pada transisi idle, bukan berdasarkan timer:
- Sesi memancarkan satu event tepat sebelum menjadi idle, apa pun alasan berhentinya.
- Sesi memancarkan satu event ketika sebuah thread berhenti sementara pada anggaran sesi.
Menerapkan batas pengeluaran
Untuk menerapkan batas pengeluaran, tetapkan anggaran sesi alih-alih melakukan polling penggunaan dan menghentikan sesi sendiri. Platform menghitung harga konsumsi sesi secara terus-menerus, dan menjeda setiap thread sebelum permintaan model berikutnya setelah biaya daftar mencapai batas. Lihat Ketika sesi mencapai anggarannya untuk melihat seperti apa hal tersebut pada stream.
Tips debugging
- Periksa event sesi: Sesi melaporkan error melalui event
session.error. - Tinjau hasil alat: Kegagalan eksekusi alat sering kali menjelaskan perilaku agen yang tidak terduga. Tab Tools di Inspector menampilkan kegagalan setiap alat.
- Gunakan prompt sistem: Tambahkan instruksi logging ke prompt sistem agar agen merangkum apa yang dilakukannya dan apa yang ditemukannya.
- Pecahkan masalah pratinjau: Jika stream yang memilih untuk menggunakan event delta tidak berperilaku seperti yang Anda harapkan, lihat Memecahkan masalah pratinjau.
Langkah selanjutnya
Kirim event, streaming respons, dan interupsi atau arahkan ulang sesi Anda di tengah eksekusi.
Batasi pengeluaran sesi dengan anggaran dolar yang ketat dan diberlakukan berdasarkan tarif daftar publik.
Was this page helpful?