Pengelolaan armada agen Anda yang efektif memerlukan akurasi registry dengan melihat dan memperbarui detail agen saat ekosistem AI Anda berkembang, mengganti metadata, atau menghapus agen yang tidak lagi digunakan.
Dokumen ini menjelaskan cara melihat dan mengubah detail serta konfigurasi agen terdaftar Anda.
Sebelum memulai
Sebelum mengelola agen, pastikan agen Anda terdaftar di Agent Registry. Anda juga memerlukan project ID Anda untuk melakukan tugas ini.
Untuk menggunakan perintah Google Cloud CLI dalam dokumen ini, pastikan Anda telah menyiapkan lingkungan gcloud CLI.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan guna mengelola agen terdaftar di Agent Registry, minta administrator untuk memberi Anda peran IAM Agent Registry API Editor (roles/agentregistry.editor) pada project.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Menemukan agen yang tersedia
Setelah mendaftarkan agen, Anda dapat menemukannya di lingkungan Anda dan melihat konfigurasi detailnya, seperti endpoint, kemampuan, dan metadata terkait.
Mencantumkan dan melihat agen
Anda dapat mencantumkan semua agen yang terdaftar di lingkungan Anda dan melihat konfigurasi detailnya, seperti endpoint, kemampuan, dan metadata terkait:
Konsol
Di Google Cloud konsol, buka Agent Registry:
Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.
Pilih tab Agents.
Halaman ini menampilkan daftar semua agen terdaftar. Daftar ini mencakup nama agen, ID, jenis, deskripsi, versi, runtime, dan lokasi.
Untuk melihat detail lengkap agen, klik nama agen's.
gcloud
Untuk mencantumkan semua agen di lokasi tertentu, gunakan perintah agents list:
gcloud alpha agent-registry agents list \
--project=PROJECT_ID \
--location=REGION
Ganti kode berikut:
PROJECT_ID: Project ID.REGION: Region registry.
Memfilter agen terdaftar
Jika Anda memiliki beberapa agen, atau jika ingin mengonfirmasi pendaftaran agen tertentu, Anda dapat memfilter daftar berdasarkan metadata agen:
Konsol
Di Google Cloud konsol, buka Agent Registry:
Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.
Pilih tab Agents.
Halaman ini menampilkan daftar semua agen terdaftar. Daftar ini mencakup nama agen, ID, jenis, deskripsi, versi, runtime, dan lokasi.
Filter daftar berdasarkan lokasi agen atau resource runtime-nya:
- Untuk memfilter berdasarkan lokasi, klik menu Location, pilih lokasi yang ingin Anda filter, lalu klik Apply.
- Untuk memfilter berdasarkan runtime, klik menu Runtime, pilih runtime yang ingin Anda filter, lalu klik Apply.
Halaman ini menampilkan daftar agen terdaftar yang difilter untuk kondisi yang Anda pilih.
gcloud
Filter daftar agen Anda agar hanya menampilkan resource yang cocok dengan metadata tertentu, menggunakan flag --filter:
gcloud alpha agent-registry agents list \
--project=PROJECT_ID \
--location=REGION \
--filter="FILTER_EXPRESSION"
Ganti FILTER_EXPRESSION dengan ekspresi filter untuk agen yang ingin Anda filter. Misalnya, Anda dapat menggunakan filter berikut:
- Untuk memfilter berdasarkan nama tampilan, gunakan
displayName='DISPLAY_NAME'. - Untuk menelusuri berdasarkan ID unik global
identifier (URN), gunakan
agentId='urn:agent:AGENT_URN'.
Melihat detail dari agen
Lihat detail dari agen tertentu, termasuk protokol, kemampuan, dan identitasnya:
Konsol
Di Google Cloud konsol, buka Agent Registry:
Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.
Pilih tab Agents.
Halaman ini menampilkan daftar semua agen terdaftar. Daftar ini mencakup nama agen, ID, jenis, deskripsi, versi, runtime, dan lokasi.
Klik nama agen yang ingin Anda lihat.
Halaman detail mencakup tab untuk detail agen.
Klik tab yang sesuai untuk melihat detail agen tertentu.
Ketersediaan fitur bergantung pada runtime Anda. Tab seperti Sessions, Playground, Memories, dan Evaluation adalah kemampuan khusus yang ditampilkan untuk agen yang dibuat di runtime terkelola, seperti Agent Runtime di Gemini Enterprise Agent Platform:
- Ikhtisar: Detail inti dari agen, termasuk nama, ID, lokasi, deskripsi, dan runtime agen. Ringkasan ini juga menampilkan kemampuan dan URI resource, yang Anda perlukan untuk membuat kueri dalam diagram topologi.
- Observability: Insight yang berpusat pada aplikasi seperti latensi, traffic, error, dan pengeluaran token. Tab ini terintegrasi dengan alat Google Cloud Observability untuk menampilkan metrik performa real-time dan penggunaan tingkat sistem guna membantu Anda mengelola biaya dan pengalaman pengguna. Untuk mengetahui informasi selengkapnya, lihat Ringkasan kemampuan observasi.
- Traces: Jalur percakapan yang tepat langkah demi langkah, termasuk format detail pesan input dan asisten untuk men-debug loop penalaran multi-agen yang kompleks atau error pemanggilan alat secara real time. Untuk mengetahui informasi selengkapnya, lihat Melihat pelacakan agen.
- Keamanan: Temuan dari Model Armor dan Security Command Center, termasuk pelanggaran kebijakan konten, risiko kebocoran data, dan penilaian kepatuhan. Untuk mengetahui informasi selengkapnya tentang keamanan, lihat Melihat temuan keamanan.
- Topology: Peta visual hubungan dan alur traffic antara agen, Agent Gateway yang ditetapkan, dan server MCP yang berinteraksi dengannya. Untuk mengetahui informasi selengkapnya tentang Agent Gateway, lihat Ringkasan Agent Gateway. Untuk mengetahui informasi selengkapnya tentang topologi, lihat Melihat diagram untuk agen terdaftar.
- Identitas: Prinsipal agen yang digunakan untuk penerapan kebijakan. Anda menggunakan identitas ini, misalnya, untuk mengonfigurasi binding penyedia autentikasi untuk autentikasi ke alat dan resource.
- Sesi: Histori percakapan persisten dan pelacakan interaksi aktif dengan agen.
- Playground: Antarmuka chat langsung untuk menguji perilaku agen.
- Memories: Fitur personalisasi jangka panjang yang membuat atau mengingat detail dari percakapan sebelumnya dengan agen untuk mempertahankan konteks di seluruh interaksi.
- Evaluasi: Detail semua tugas evaluasi agen. Tab ini memungkinkan Anda membuat tugas evaluasi baru, mengupload metrik, dan mengevaluasi performa kognitif agen serta keandalan model terhadap traffic langsung atau simulasi sintetis.
gcloud
Untuk melihat metadata detail agen tertentu, gunakan perintah agents describe:
gcloud alpha agent-registry agents describe AGENT_NAME \
--project=PROJECT_ID \
--location=REGION
Ganti AGENT_NAME dengan nama agen Anda, misalnya, my-custom-agent.
Memperbarui metadata dan endpoint agen
Jika URL runtime agen Anda berubah, atau Anda ingin mengganti nama tampilan, deskripsi, atau spesifikasinya, Anda dapat memperbarui metadata agen.
Untuk Agent Registry API, resource Agent digunakan untuk penemuan. Oleh karena itu, Anda harus memperbarui resource Service terdaftar secara langsung.
Gunakan gcloud CLI dengan flag tertentu untuk mengubah parameter agen:
Memperbarui nama tampilan dan deskripsi: Gunakan flag
--display-namedan--description, misalnya:gcloud alpha agent-registry services update AGENT_NAME \ --project=PROJECT_ID \ --location=REGION \ --display-name="New display name" \ --description="Updated description of the agent's purpose."Ganti kode berikut:
AGENT_NAME: Nama agen Anda, misalnya,my-support-agent.PROJECT_ID: Project ID.REGION: Region registry.
Memperbarui URL endpoint: Gunakan flag
--interfacesuntuk menentukan endpoint baru, misalnya:gcloud alpha agent-registry services update AGENT_NAME \ --project=PROJECT_ID \ --location=REGION \ --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOLGanti kode berikut:
ENDPOINT_URL: URL endpoint agen baru, misalnya,https://new-api.example.com/agent.PROTOCOL: Binding protokol untuk endpoint. Nilai yang valid adalahHTTP_JSON,GRPC, atauJSONRPC.
Memperbarui spesifikasi agen: Gunakan flag
--agent-spec-content, misalnya, jika Anda memiliki Kartu Agen baru:gcloud alpha agent-registry services update AGENT_NAME \ --project=PROJECT_ID \ --location=REGION \ --agent-spec-content=AGENT_SPECGanti
AGENT_SPECdengan nama spesifikasi agen baru, misalnya,new-agent-card.json.
Menghapus agen
Untuk menghapus agen yang otomatis terdaftar ke Agent Registry, Anda harus menghapus agen yang mendasarinya di runtime Google Cloud tertentu. Agen tersebut kemudian akan otomatis dihapus dari registry.
Untuk menghapus agen yang terdaftar secara manual dari registry, Anda harus menghapus resource Service yang mendasarinya. Tindakan ini akan menghapus agen dari hasil penelusuran dan membuatnya tidak dapat ditemukan oleh alat lain:
gcloud alpha agent-registry services delete AGENT_NAME \
--project=PROJECT_ID \
--location=REGION
Ganti kode berikut:
AGENT_NAME: Nama agen yang ingin Anda hapus, misalnya,my-support-agent.PROJECT_ID: Project ID.REGION: Region registry.
Langkah berikutnya
- Pelajari cara melihat hubungan agen menggunakan diagram topologi.
- Pelajari cara menelusuri agen dan alat menggunakan kueri bahasa alami.