Melihat rekaman aktivitas agen

Sebelum memulai

Sebelum dapat melihat rekaman aktivitas agen, Anda harus memenuhi persyaratan berikut:

  • Aktifkan API: Pastikan API berikut diaktifkan untuk project Google Cloud Anda:
    • Cloud Trace API
    • Cloud Logging API
    • Telemetry API
  • Konfigurasi pelacakan agen: Agen Anda harus dikonfigurasi untuk mengirim data aktivitas ke Google Cloud. Untuk mengetahui petunjuk tentang cara mengaktifkan pelacakan untuk berbagai jenis agen, lihat Menyiapkan pelacakan.
  • Konfigurasi izin: Untuk melihat rekaman aktivitas dan log, Anda memerlukan peran IAM yang memberikan izin yang diperlukan, seperti peran Cloud Trace User (roles/cloudtrace.user) dan Logs Viewer (roles/logging.viewer). Untuk mengetahui informasi selengkapnya, lihat Kontrol akses Cloud Trace dan Kontrol akses Cloud Logging.

Pelacakan terdistribusi adalah teknik diagnostik yang melacak progres satu permintaan saat melintasi berbagai layanan dan komponen terdistribusi dalam arsitektur Anda. Karena agen AI generatif menggunakan loop penalaran non-deterministik untuk memilih alat dan jalur eksekusi secara dinamis, metrik point-in-time konvensional sering kali tidak cukup untuk proses debug. Trace sangat penting untuk kemampuan pengamatan agen karena memberikan linimasa yang lengkap dan berurutan dari interaksi yang tidak dapat diprediksi ini, sehingga Anda dapat melihat dengan tepat alasan agen membuat keputusan tertentu.

Menjelajahi rekaman aktivitas

Untuk mengakses data eksekusi mendetail untuk agen:

  1. Di konsol Google Cloud , buka halaman Agent Platform > Agent Registry.

    Buka Agent Registry

  2. Pilih agen tertentu Anda.

  3. Klik tab Trace.

Antarmuka ini memungkinkan Anda memeriksa detail eksekusi langkah demi langkah dari agen Anda. Trace adalah catatan faktual dan tidak dapat diubah tentang perilaku agen, termasuk input model, respons, dan panggilan alat. Tampilan rekaman aktivitas mencakup grafik asiklik berarah (DAG) rentang, input dan output, serta atribut metadata-nya.

Tab Tracing menyediakan tiga tampilan berbeda untuk menjelajahi data telemetri Anda:

  • Tampilan sesi: Mengelompokkan eksekusi menurut sesi pengguna individual, sehingga Anda dapat menganalisis percakapan multi-turn dan perilaku agen dari waktu ke waktu.
  • Tampilan rekaman aktivitas: Berfokus pada rekaman aktivitas permintaan end-to-end individual, yang merepresentasikan jalur eksekusi tunggal.
  • Tampilan rentang: Menyediakan daftar terperinci dari setiap operasi (rentang) yang dieksekusi dalam rekaman aktivitas, seperti panggilan model dasar tertentu, permintaan API, atau eksekusi alat eksternal.

Tampilan rekaman aktivitas tunggal (konteks sesi)

Saat Anda memilih sesi tertentu dari Tampilan sesi, panel Detail akan terbuka dengan panel daftar di sisi kiri yang menampilkan semua rekaman aktivitas individual yang ada dalam sesi multi-turn tersebut. Panel utama menggabungkan seluruh konteks sesi, menampilkan input dan pesan asisten yang diformat, beserta metrik sesi keseluruhan seperti durasi, total token AI Generatif, dan skor evaluasi berkelanjutan.

Tampilan trace tunggal (konteks span atau trace langsung)

Atau, jika Anda memilih rekaman aktivitas tertentu dari Tampilan rekaman aktivitas atau rentang berbeda dari Tampilan rentang, panel Detail akan langsung terbuka ke eksekusi tertentu tersebut. Karena Anda melihat satu operasi, bukan sesi yang dikelompokkan, panel daftar di sebelah kiri disembunyikan, sehingga memungkinkan pemeriksaan langsung dan terfokus terhadap latensi, atribut, dan potensi error tertentu dari operasi tersebut.

Penyimpanan data dan kontrol akses

Untuk menjaga keamanan dan kepatuhan, Platform Agen Gemini Enterprise memisahkan metadata operasional dari konten percakapan yang sebenarnya:

  • Metrik & Atribut Eksekusi: Telemetri standar (seperti latensi, kode status, dan metadata struktural) disimpan langsung dalam rentang aktivitas.
  • Perintah & Respons: Data yang berpotensi sensitif, seperti perintah pengguna dan respons model, tidak disimpan dalam rentang. Sebagai gantinya, log tersebut dirutekan ke Cloud Logging atau Cloud Storage, bergantung pada konfigurasi organisasi Anda. Hal ini memungkinkan administrator menerapkan kontrol Identity and Access Management (IAM) terperinci atas data percakapan sensitif.

UI Platform Agen Gemini Enterprise secara otomatis memahami korelasi mendasar antara rentang rekaman aktivitas dan log perintah dan respons yang disimpan dengan aman ini. Saat Anda membuka tampilan detail rekaman aktivitas, platform akan menggabungkan kembali data ini dengan lancar, sehingga menampilkan tampilan terpadu perilaku agen tanpa mengurangi aturan tata kelola data Anda.

Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi tujuan penyimpanan data percakapan, lihat dokumentasi logging respons perintah multi-modal di Google Cloud Observability.

Langkah berikutnya