Melihat hubungan agen

Anda dapat melihat hubungan agen di Gemini Enterprise Agent Platform, termasuk komunikasi antar-agen dan komunikasi antara agen dan server MCP.

Dengan menggunakan kueri yang disediakan, Anda dapat menjelajahi hasil kueri sebagai grafik topologi atau sebagai tabel. Informasi tentang hubungan agen dapat membantu Anda memahami dependensi dan mendukung tata kelola agen.

Anda dapat melihat data untuk agen yang ditemukan dan agen yang terdaftar di Agent Registry. Gemini Enterprise Agent Platform menentukan hubungan menggunakan data rekaman aktivitas gabungan.

Batasan

  • Hasil kueri hanya menyertakan komponen yang memenuhi kriteria berikut:
    • Agen harus memiliki jenis fungsional yang ditetapkan ke AGENT dan di-deploy menggunakan ADK, Gemini Enterprise, atau Cloud Run; atau di-deploy menggunakan GKE dan didaftarkan dengan Agent Registry.
    • Server MCP harus memiliki jenis fungsional yang ditetapkan ke MCP. Server MCP pihak pertama yang di-deploy menggunakan OneMCP, GKE, atau Cloud Run disertakan. Server MCP lainnya harus terdaftar di Agent Registry agar disertakan.
    • Komponen lain, seperti alat dan model, atau Agen Workspace tidak disertakan dalam hasil.
  • Saat server MCP didaftarkan ke Pendaftaran Agen, server tersebut diklasifikasikan sebagai resource bersama oleh Pusat Aplikasi yang tidak akan menampilkan tepi ke node lain dalam grafik topologi. Batasan ini hanya berlaku jika server MCP diklasifikasikan sebagai resource bersama dan tidak berlaku untuk resource eksklusif aplikasi, seperti konektor data Gemini Enterprise atau server MCP yang dihosting di Cloud Run.

Sebelum memulai

  1. Aktifkan App Hub, App Topology, Observability, dan Trace API.

    Peran yang diperlukan untuk mengaktifkan API

    Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.

    Aktifkan API

    2. Jika Anda telah menambahkan project lain ke cakupan rekaman aktivitas, sebaiknya aktifkan juga Observability API untuk project tersebut. Diagram topologi hanya menampilkan data rekaman aktivitas dari project cakupan rekaman aktivitas yang berada dalam organisasi yang sama dengan project yang dipilih.

  2. Instrumentasikan aplikasi AI Anda dengan OpenTelemetry.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan guna melihat grafik topologi, minta administrator untuk memberi Anda peran IAM berikut pada project:

  • Melihat grafik: App Topology Viewer (roles/apptopology.viewer)
  • Melihat data agen terdaftar: Pelihat Agent Registry API (agentregistry.viewer)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Melihat grafik untuk project

  1. Di konsol Google Cloud , buka halaman Topology.

    Buka Topologi

  2. Di pemilih project, pilih project yang berisi agen Anda.

  3. Di bagian Queries, klik kueri.

  4. Bagian Grafik menampilkan hasil untuk kueri yang dipilih.

    Grafik topologi sepenuhnya interaktif. Anda dapat memperbesar dan memperkecil serta menarik node untuk membantu Anda memvisualisasikan hubungan. Untuk membuka panel yang memberikan detail tambahan tentang node dalam grafik, klik node.

  5. Untuk melihat hasil kueri sebagai tabel, klik Tabel.

    • Untuk memilih kolom yang ditampilkan tabel, klik Opsi tampilan kolom
    • Untuk memfilter tabel menurut properti tertentu, pilih properti di kolom Filter.
    • Anda juga dapat mengurutkan setiap kolom dalam urutan menaik atau menurun.

  6. Untuk menyempurnakan atau menyesuaikan kueri, Anda dapat mengedit kueri yang dipilih dan melihat hasilnya sebagai grafik topologi di Cloud Hub. Klik Edit di Cloud Hub.

Untuk melihat data tambahan tentang agen dalam project yang dipilih, lihat dasbor di Pemantauan Aplikasi.

Melihat grafik untuk agen terdaftar

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

    Buka Agent Registry

  2. Di pemilih project, pilih project yang berisi agen Anda.

  3. Di tab Agen, klik nama agen yang ingin Anda lihat.

  4. Klik tab Topology.

  5. Di bagian Queries, klik kueri.

  6. Bagian Grafik menampilkan hasil untuk kueri yang dipilih.

    Grafik topologi sepenuhnya interaktif. Anda dapat memperbesar dan memperkecil serta menarik node untuk membantu Anda memvisualisasikan hubungan. Untuk membuka panel yang memberikan detail tambahan tentang node dalam grafik, klik node.

  7. Untuk melihat hasil kueri sebagai tabel, klik Tabel.

    • Untuk memilih kolom yang ditampilkan tabel, klik Opsi tampilan kolom
    • Untuk memfilter tabel menurut properti tertentu, pilih properti di kolom Filter.
    • Anda juga dapat mengurutkan setiap kolom dalam urutan menaik atau menurun.

  8. Untuk menyempurnakan atau menyesuaikan kueri, Anda dapat mengedit kueri yang dipilih dan melihat hasilnya sebagai grafik topologi di Cloud Hub. Klik Edit di Cloud Hub.

Untuk melihat data tambahan tentang agen yang dipilih, lihat dasbor di Pemantauan Aplikasi.

Langkah berikutnya