Pengelolaan armada agen yang efektif memerlukan pemeliharaan akurasi registri dengan melihat dan memperbarui detail agen seiring berkembangnya beban kerja Anda, 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 gcloud CLI dalam dokumen ini, pastikan Anda telah menyiapkan lingkungan Google Cloud 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) di 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 terkaitnya.
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 konsol Google Cloud , buka Agent Registry:
Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.
Pilih tab Agen.
Halaman ini menampilkan daftar semua agen terdaftar. Daftar ini mencakup nama, ID, jenis, deskripsi, versi, runtime, dan lokasi agen.
Untuk melihat detail lengkap agen, klik nama agen.
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 registri.
Memfilter agen terdaftar
Jika Anda memiliki beberapa agen, atau jika Anda ingin mengonfirmasi pendaftaran agen tertentu, Anda dapat memfilter daftar menurut metadata agen:
Konsol
Di konsol Google Cloud , buka Agent Registry:
Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.
Pilih tab Agen.
Halaman ini menampilkan daftar semua agen terdaftar. Daftar ini mencakup nama, ID, jenis, deskripsi, versi, runtime, dan lokasi agen.
Memfilter daftar menurut lokasi agen atau resource runtime-nya:
- Untuk memfilter menurut lokasi, klik menu Lokasi, pilih lokasi yang ingin Anda filter, lalu klik Terapkan.
- Untuk memfilter menurut runtime, klik menu Runtime, pilih runtime yang ingin Anda filter, lalu klik Terapkan.
Halaman ini menampilkan daftar agen terdaftar yang difilter untuk kondisi yang Anda pilih.
gcloud
Filter daftar agen Anda untuk hanya menampilkan resource yang cocok dengan metadata tertentu,
menggunakan tanda --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 menurut nama tampilan, gunakan
displayName='DISPLAY_NAME'. - Untuk menelusuri berdasarkan
ID unik global (URN), gunakan
agentId='urn:agent:AGENT_URN'.
Melihat detail dari agen
Melihat detail dari agen tertentu, termasuk protokol, keterampilan, dan identitasnya:
Konsol
Di konsol Google Cloud , buka Agent Registry:
Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.
Pilih tab Agen.
Halaman ini menampilkan daftar semua agen terdaftar. Daftar ini mencakup nama, ID, jenis, deskripsi, versi, runtime, dan lokasi agen.
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 Sesi, Playground, Memori, dan Evaluasi adalah kemampuan khusus yang ditampilkan untuk agen yang dibangun di runtime terkelola, seperti Vertex AI Agent Engine:
- Ringkasan: Detail inti dari agen, termasuk nama, ID, lokasi, deskripsi, dan runtime agen. Ringkasan ini juga menampilkan keterampilan dan URI resource, yang Anda perlukan untuk membuat kueri dalam grafik topologi.
- Kemampuan observasi: Insight yang berfokus pada aplikasi seperti latensi, traffic, error, dan pembelanjaan token. Tab ini terintegrasi dengan alat Google Cloud Observability untuk menampilkan metrik performa real-time dan penggunaan tingkat sistem untuk membantu Anda mengelola biaya dan pengalaman pengguna. Untuk mengetahui informasi selengkapnya, lihat Ringkasan kemampuan pengamatan.
- Traces: Jalur persis percakapan langkah demi langkah, termasuk pemformatan mendetail 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 rekaman aktivitas 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.
- Topologi: Peta visual hubungan dan alur traffic antara agen, Agent Gateway yang ditetapkan untuknya, 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 grafik untuk agen terdaftar.
- Identitas: Principal agen yang digunakan untuk penegakan kebijakan. Anda menggunakan identitas ini, misalnya, untuk mengonfigurasi binding penyedia auth untuk autentikasi ke alat dan resource.
- Sesi: Histori percakapan persisten dan pelacakan interaksi aktif dengan agen.
- Playground: Antarmuka chat langsung untuk menguji perilaku agen.
- Memori: 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 aktif atau simulasi sintetis.
gcloud
Untuk melihat metadata mendetail dari 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 yang terdaftar secara langsung.
Gunakan Google Cloud CLI dengan flag tertentu untuk mengubah parameter agen:
Perbarui nama tampilan dan deskripsi: Gunakan tanda
--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 registri.
Perbarui URL endpoint: Gunakan tanda
--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.
Perbarui spesifikasi agen: Gunakan tanda
--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 terdaftar secara otomatis ke Agent Registry, Anda harus menghapus agen pokok di runtime Google Cloud -nya yang spesifik. Kemudian, agen akan otomatis dihapus dari registri.
Untuk menghapus agen yang terdaftar secara manual dari registry, Anda harus menghapus
resource Service yang mendasarinya. Tindakan ini 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 registri.
Langkah berikutnya
- Pelajari cara melihat hubungan agen menggunakan diagram topologi.
- Pelajari cara menelusuri agen dan alat menggunakan kueri bahasa alami.