Ringkasan kemampuan observasi

Kemampuan observasi agen di Platform Agen Gemini Enterprise memberikan visibilitas komprehensif ke dalam performa, perilaku, dan kondisi agen yang di-deploy serta server Model Context Protocol (MCP). Dengan memantau metrik utama, melacak jalur eksekusi, dan mengamati sistem multi-agen secara keseluruhan, Anda dapat mendiagnosis masalah, mengoptimalkan konsumsi resource, dan meningkatkan keandalan agen.

Dokumen ini memberikan ringkasan alat observasi yang tersedia dalam Gemini Enterprise Agent Platform, termasuk topologi seluruh sistem, pemantauan agen individual, dan metrik server MCP.

Penyiapan telemetri

Untuk mengisi dasbor, topologi, dan rekaman aktivitas observability ini, agen Anda harus dikonfigurasi untuk mengirim data telemetri dalam format OpenTelemetry ke sistem penyimpanan di Google Cloud Observability.

Pastikan lingkungan agen dan server MCP Anda dikonfigurasi dengan benar untuk memancarkan data ini. Komponen Google Cloud bawaan otomatis memancarkan telemetri dalam format OpenTelemetry. Misalnya, Model Armor secara native memancarkan telemetri standar, sehingga Anda dapat mengekspos dan memantau pencegatan kebijakan real-time secara lancar langsung dalam data rekaman aktivitas tanpa memerlukan instrumentasi kustom.

Untuk mengetahui petunjuk dan persyaratan penyiapan telemetri agen, lihat referensi berikut:

Topologi agen

Tampilan topologi multi-agen memberikan peta visual di seluruh sistem dari arsitektur sistem multi-agen Anda. Bagian ini menampilkan hubungan dan aliran traffic real-time di semua agen dan server MCP yang diketahui oleh Agent Registry Anda. Tampilan gabungan ini membantu Anda memahami dependensi yang kompleks dan mengidentifikasi potensi hambatan di seluruh ekosistem Anda.

Selain tampilan topologi multi-agen, Anda juga dapat melihat dependensi masuk dan keluar tertentu untuk satu agen. Tampilan topologi satu agen ini didasarkan pada data rekaman aktivitas untuk agen yang dipilih.

Untuk mengetahui petunjuk mendetail tentang cara menavigasi dan menafsirkan grafik topologi agen, lihat Melihat hubungan dan topologi agen.

Sinyal kemampuan observasi

Platform Agen Gemini Enterprise menyediakan kemampuan observasi melalui metrik, rekaman aktivitas, dan log.

Saat Anda memilih agen tertentu dari Registry, tab Observability menyediakan serangkaian dasbor yang ditargetkan untuk memantau kondisi operasional, performa, dan pemanfaatan infrastrukturnya. Gunakan navigasi sebelah kiri dalam tab Observability untuk beralih di antara tampilan berikut:

  • Ringkasan: Melacak penggunaan tingkat tinggi selama jangka waktu yang dipilih, termasuk total sesi, rata-rata putaran per sesi, dan total pemanggilan agen. Diagram deret waktu menampilkan penggunaan token (input versus output), volume traffic agen secara keseluruhan, persentil latensi (p50, p95, p99), dan tingkat error.
  • Evaluasi: Menampilkan monitor online untuk penilaian kualitas berkelanjutan. Hal ini mencakup widget deret waktu yang melacak kualitas respons rata-rata, metrik keamanan, tingkat halusinasi, dan kualitas penggunaan alat.
  • Model: Memerinci performa berdasarkan model dasar yang mendasarinya. Anda dapat memantau latensi p95, jumlah total panggilan, tingkat error, kegagalan kuota, dan penggunaan token yang diisolasi oleh model tertentu.
  • Alat: Memantau alat dan layanan eksternal yang terhubung ke agen. Tampilan ini merinci latensi p95, jumlah panggilan, dan rasio error per alat, serta frekuensi interaksi saat tidak ada alat yang dipanggil.
  • Penggunaan: Menyediakan metrik tingkat infrastruktur untuk lingkungan runtime agen, termasuk alokasi CPU container, alokasi memori container, dan penggunaan token.
  • Log: Menampilkan aliran log agen mentah yang dapat difilter, termasuk keparahan, stempel waktu, dan ringkasan eksekusi untuk pemecahan masalah mendalam. Untuk mengetahui informasi selengkapnya, lihat Melihat log agen.

Selain dasbor di tab Observability, Anda dapat menggunakan tab Traces agen untuk memeriksa eksekusi langkah demi langkah dari sesi tertentu, termasuk grafik asiklik terarah dari rentang dan input/output. Untuk mengetahui informasi selengkapnya, lihat Melihat Rekaman Aktivitas Agen. Anda juga dapat menggunakan tab Topology untuk melihat dependensi masuk dan keluar tertentu untuk satu agen tersebut.

Untuk server MCP, Anda dapat memantau jumlah permintaan dan durasi permintaan p95 untuk melacak pemanfaatan dan responsivitas.

Konvensi AI generatif OpenTelemetry

Log perintah dan respons serta rekaman aktivitas agen sangat bergantung pada Konvensi Semantik OpenTelemetry untuk sistem AI generatif untuk menstandardisasi cara telemetri AI generatif diambil, disusun, dan dilaporkan.

Mematuhi konvensi ini sangat penting untuk pelacakan agen karena menetapkan format universal dan agnostik vendor untuk mendeskripsikan alur kerja agen multi-langkah yang kompleks—seperti eksekusi alat, langkah pengambilan, dan penggunaan token. Standardisasi ini membantu interoperabilitas yang lancar di berbagai backend observabilitas dan alat analisis, baik di dalam maupun di luar Google Cloud.

Langkah berikutnya