Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Kelola agen

Agent Registry memungkinkan Anda memeriksa, memperbarui, dan menghapus agen terdaftar sehingga registry Anda secara akurat mencerminkan kemampuan aktif dalam ekosistem AI Anda. Anda dapat mencantumkan dan melihat semua agen yang terdaftar, memperbarui metadata atau endpoint agen yang terdaftar secara manual, dan menghapus agen yang tidak lagi digunakan.

Sebelum memulai

Menyiapkan Agent Registry.
Untuk penyiapan project tunggal, dapatkan project ID dari project tata kelola tempat Agent Registry diaktifkan. Jika Anda mengonfigurasi batas pengelolaan untuk beberapa project, gunakan ID project pengelolaan Anda untuk penemuan dan pendaftaran di seluruh batas, atau tentukan ID project anggota untuk operasi project tunggal.
Daftarkan agen Anda di Agent Registry.
Untuk menggunakan perintah Google Cloud CLI dalam dokumen ini, siapkan lingkungan gcloud CLI Anda.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengelola agen terdaftar di Agent Registry, minta administrator untuk memberi Anda peran IAM Agent Registry API Editor (roles/agentregistry.editor) di project tata kelola tempat Agent Registry diaktifkan. 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.

Menemukan agen yang tersedia

Setelah mendaftarkan agen, Anda dapat menemukannya di lingkungan Anda dan melihat konfigurasi mendetailnya, seperti endpoint, kemampuan A2A, dan metadata terkait.

Mencantumkan dan melihat semua agen

Anda dapat mencantumkan semua agen yang terdaftar di lingkungan Anda dan melihat konfigurasi mendetailnya, seperti endpoint, keterampilan A2A, dan metadata terkait.

Jika telah mengonfigurasi batas pengelolaan, Anda dapat mencantumkan agen di beberapa project anggota dari project pengelolaan.

Untuk mencantumkan agen, ikuti langkah-langkah berikut:

Konsol

Di konsol Google Cloud , buka Agent Registry:

Buka Agent Registry
Dari pemilih project, pilih project Google Cloud tempat Anda menyiapkan Agent Registry.
Pilih tab Agen.

Halaman ini menampilkan daftar semua agen yang 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, jalankan perintah gcloud agent-registry agents list:

gcloud agent-registry agents list \
    --project=PROJECT_ID \
    --location=REGION

Ganti kode berikut:

PROJECT_ID: project ID. Jika Anda mengonfigurasi batas pengelolaan, tentukan ID project pengelolaan Anda untuk mencantumkan agen di lokasi yang ditentukan di semua project anggota dalam batas tersebut. Setiap nama resource yang ditampilkan mempertahankan ID agen dan menggunakan project yang ditentukan dalam permintaan.
REGION: lokasi registry, seperti us-central1, eu, atau global. Pada project pengelolaan, menentukan lokasi akan menggabungkan agen di lokasi yang sama di semua project anggota dalam batasan.

Memfilter agen terdaftar

Jika Anda memiliki beberapa agen, atau jika Anda ingin mengonfirmasi pendaftaran agen tertentu, Anda dapat memfilter daftar berdasarkan metadata agen:

Konsol

Di konsol Google Cloud , buka Agent Registry:

Buka Agent Registry
Dari pemilih project, pilih project Google Cloud tempat Anda menyiapkan Agent Registry.
Pilih tab Agen.

Halaman ini menampilkan daftar semua agen yang terdaftar. Daftar ini mencakup nama, ID, jenis, deskripsi, versi, runtime, dan lokasi agen.
Filter daftar menurut lokasi, resource runtime, atau ID agen:
- 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 Apply.
- Untuk menampilkan atau menyembunyikan agen Google yang dibuat sistem, klik Show system-created agents atau Hide system-created agents di toolbar tabel. Untuk hanya mencantumkan agen Google bawaan, klik Filter, masukkan urn:agent:googleapis.com: di kolom Agent ID, 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 dengan meneruskan flag --filter ke perintah gcloud agent-registry agents list:

gcloud agent-registry agents list \
    --project=PROJECT_ID \
    --location=REGION \
    --filter="FILTER_EXPRESSION"

Ganti kode berikut:

PROJECT_ID: project ID.
REGION: region registry.
FILTER_EXPRESSION: 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 agen (URN) yang unik secara global, gunakan agentId='urn:agent:AGENT_URN'.
- Untuk mencantumkan hanya agen Google bawaan, gunakan agentId:"urn:agent:googleapis.com:".
- Untuk memfilter menurut project anggota tertentu saat mengkueri project pengelolaan, gunakan agentId:"urn:agent:projects-MEMBER_PROJECT_NUMBER:".

Terraform

Untuk mengambil agen terdaftar tertentu dengan memfilter metadatanya, konfigurasikan sumber data google_agent_registry_agent dengan argumen filter:

data "google_agent_registry_agent" "filtered_agent" {
  location = "REGION"
  filter   = "displayName=\"DISPLAY_NAME\""
}

Ganti kode berikut:

REGION: region registry.
DISPLAY_NAME: nama agen yang dapat dibaca manusia untuk difilter, misalnya, Support Agent.

Melihat detail agen

Melihat detail dari agen tertentu, termasuk protokol, keterampilan A2A, dan identitasnya:

Konsol

Di konsol Google Cloud , buka Agent Registry:

Buka Agent Registry
Dari pemilih project, pilih project Google Cloud tempat Anda menyiapkan Agent Registry.
Pilih tab Agen.

Halaman ini menampilkan daftar semua agen yang terdaftar. Daftar ini mencakup nama, ID, jenis, deskripsi, versi, runtime, dan lokasi agen.
Klik nama agen yang ingin Anda lihat.

Halaman detail menyertakan 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 muncul untuk agen yang dibangun di runtime terkelola, seperti Agent Runtime di Gemini Enterprise Agent Platform:
- Overview: detail inti dari agen, termasuk nama, ID, lokasi, deskripsi, dan runtime agen. Ringkasan ini juga menampilkan keterampilan A2A dan referensi runtime, yang Anda perlukan untuk membuat kueri dalam diagram topologi.
- Kemampuan observasi: insight yang berfokus pada aplikasi seperti latensi, traffic, error, dan pengeluaran token. Tab ini terintegrasi dengan alat Google Cloud Observability untuk menampilkan metrik performa real-time dan pemakaian tingkat sistem guna membantu Anda mengelola biaya dan pengalaman pengguna. Untuk mengetahui informasi selengkapnya, lihat Ringkasan kemampuan observasi.
- Trace: jalur pasti percakapan langkah demi langkah, termasuk pemformatan mendetail pesan input dan asisten untuk men-debug reasoning loop multi-agen yang kompleks atau error panggilan alat secara real time. Untuk mengetahui informasi selengkapnya, lihat Melihat trace 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, Gateway Agen yang ditetapkan, dan server MCP yang berinteraksi dengannya. Untuk mengetahui informasi selengkapnya tentang Gateway Agen, lihat Ringkasan Gateway Agen. Untuk mengetahui informasi selengkapnya tentang topologi, lihat Melihat grafik untuk agen terdaftar.
- Identitas: entitas agen yang digunakan untuk penegakan 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.
- Memori: fitur personalisasi jangka panjang yang menghasilkan atau mengingat detail dari percakapan sebelumnya dengan agen untuk mempertahankan konteks di seluruh interaksi.
- Evaluation: detail semua tugas evaluasi agen. Tab ini memungkinkan Anda membuat tugas evaluasi baru, mengupload metrik, dan mengevaluasi performa kognitif agen dan keandalan model terhadap traffic langsung atau simulasi sintetis.

gcloud

Untuk melihat metadata mendetail dari agen tertentu, jalankan perintah gcloud agent-registry agents describe:

gcloud agent-registry agents describe AGENT_NAME \
    --project=PROJECT_ID \
    --location=REGION

Ganti kode berikut:

AGENT_NAME: nama agen Anda, misalnya, my-custom-agent.
PROJECT_ID: project ID. Dalam batas pengelolaan, Anda dapat menentukan ID project pengelolaan atau ID project anggota tempat agen di-deploy. Nama resource yang ditampilkan mempertahankan ID agen dan menggunakan project yang ditentukan dalam permintaan Anda.
REGION: region registry.

Terraform

Untuk mengambil detail tentang agen terdaftar tertentu menggunakan ID-nya, konfigurasikan sumber data google_agent_registry_agent:

data "google_agent_registry_agent" "my_agent" {
  location = "REGION"
  agent_id = "AGENT_ID"
}

output "agent_create_time" {
  description = "The timestamp when the agent was registered."
  value       = data.google_agent_registry_agent.my_agent.create_time
}

output "agent_update_time" {
  description = "The timestamp when the agent was last updated."
  value       = data.google_agent_registry_agent.my_agent.update_time
}

Ganti kode berikut:

REGION: region registry.
AGENT_ID: ID unik 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.

Di Registry Agen, resource Agent adalah resource penemuan hanya baca. Untuk memperbarui agen yang terdaftar secara manual, Anda harus memperbarui resource Service yang dapat ditulis secara langsung dengan menentukan project ID tempat resource Service tersebut didaftarkan. Untuk agen yang terdaftar secara otomatis, update agen di runtime dasarnya agar Agent Registry menyinkronkan perubahan.

Konsol

Perbarui detail agen yang tersedia dari konsol Google Cloud :

Di konsol Google Cloud , buka Agent Registry:

Buka Agent Registry
Dari pemilih project, pilih project Google Cloud tempat Anda menyiapkan Agent Registry.
Pilih tab Agen.

Halaman ini menampilkan daftar semua agen yang terdaftar. Daftar ini mencakup nama, ID, jenis, deskripsi, versi, runtime, dan lokasi agen.
Klik nama agen yang ingin Anda perbarui.
Di tab Overview agen, klik Edit.
Di panel Edit service, masukkan informasi terbaru agen Anda, seperti nama atau deskripsi barunya.
Klik Simpan.

gcloud

Jalankan perintah gcloud agent-registry services update dengan flag tertentu untuk mengubah parameter agen:

Memperbarui nama tampilan dan deskripsi: gunakan flag --display-name dan --description, misalnya:

gcloud 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.

Perbarui URL endpoint: gunakan flag --interfaces untuk menentukan endpoint baru, misalnya:
```
gcloud agent-registry services update AGENT_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL
```
Ganti kode berikut:
- AGENT_NAME: nama agen Anda, misalnya, my-support-agent.
- PROJECT_ID: project ID.
- REGION: region registry.
- ENDPOINT_URL: URL endpoint agen baru, misalnya, https://new-api.example.com/agent.
- PROTOCOL: binding protokol untuk endpoint. Nilai yang valid adalah http-json, grpc, atau jsonrpc.
Perbarui spesifikasi agen: gunakan flag --agent-spec-content, misalnya, jika Anda memiliki Kartu Agen baru:
```
gcloud agent-registry services update AGENT_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --agent-spec-content=AGENT_SPEC_FILE
```
Ganti kode berikut:
- AGENT_NAME: nama agen Anda, misalnya, my-support-agent.
- PROJECT_ID: project ID.
- REGION: region registry.
- AGENT_SPEC_FILE: jalur ke file spesifikasi agen baru, misalnya, new-agent-card.json. Ukuran file maksimum untuk file spesifikasi adalah 10 KB.

Terraform

Untuk memperbarui metadata, URL endpoint, atau spesifikasi agen terdaftar, ubah parameter resource google_agent_registry_service yang ada dalam konfigurasi Anda, lalu jalankan terraform apply:

resource "google_agent_registry_service" "rest_agent" {
  location     = "REGION"
  service_id   = "AGENT_NAME"
  display_name = "New Display Name"
  description  = "Updated description of the agent's purpose."

  agent_spec {
    type = "NO_SPEC"
  }

  interfaces {
    url              = "ENDPOINT_URL"
    protocol_binding = "PROTOCOL"
  }
}

Ganti kode berikut:

REGION: region registry.
AGENT_NAME: nama unik yang ingin Anda berikan kepada agen, misalnya, my-support-agent.
ENDPOINT_URL: URL endpoint API agen, misalnya, https://api.example.com/v1/agents/1234.
PROTOCOL: binding protokol untuk endpoint. Nilai yang valid adalah HTTP_JSON, GRPC, atau JSONRPC.

Menghapus agen

Untuk menghapus agen yang otomatis terdaftar di Agent Registry, Anda harus menghapus agen yang mendasarinya di runtime Google Cloud tertentu. Agen kemudian akan otomatis dihapus dari registry.

Untuk menghapus agen yang terdaftar secara manual dari registry, Anda harus menghapus resource Service-nya dengan menentukan project ID tempat resource Service tersebut didaftarkan. Tindakan ini akan menghapus agen dari hasil penelusuran dan membuatnya tidak dapat ditemukan oleh alat lain:

Konsol

Di konsol Google Cloud , buka Agent Registry:

Buka Agent Registry
Dari pemilih project, pilih project Google Cloud tempat Anda menyiapkan Agent Registry.
Pilih tab Agen.

Halaman ini menampilkan daftar semua agen yang terdaftar. Daftar ini mencakup nama, ID, jenis, deskripsi, versi, runtime, dan lokasi agen.
Klik nama agen yang ingin Anda hapus.
Di tab Overview agen, klik Delete.
Dalam dialog konfirmasi, masukkan DELETE untuk mengonfirmasi tindakan.
Klik Hapus.

gcloud

Jalankan perintah gcloud agent-registry services delete:

gcloud 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.

Terraform

Hapus resource google_agent_registry_service yang mewakili agen dari konfigurasi Terraform Anda, lalu jalankan terraform apply.

Langkah berikutnya

Pelajari cara melihat hubungan agen menggunakan diagram topologi.
Pelajari cara menelusuri agen, alat, dan keterampilan menggunakan kueri bahasa alami.

Kelola agen Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Sebelum memulai

Peran yang diperlukan

Menemukan agen yang tersedia

Mencantumkan dan melihat semua agen

Konsol

gcloud

Memfilter agen terdaftar

Konsol

gcloud

Terraform

Melihat detail agen

Konsol

gcloud

Terraform

Memperbarui metadata dan endpoint agen

Konsol

gcloud

Terraform

Menghapus agen

Konsol

gcloud

Terraform

Langkah berikutnya

Kelola agen