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

Kelola agen

Pengelolaan yang efektif atas kumpulan agen Anda memerlukan akurasi registri dengan melihat dan memperbarui detail agen seiring berkembangnya ekosistem AI 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 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) 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 semua agen

Anda dapat mencantumkan semua agen yang terdaftar di lingkungan Anda dan melihat konfigurasi detailnya, seperti endpoint, kemampuan A2A, dan metadata terkait:

Konsol

Di konsol Google Cloud , buka Agent Registry:

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 agen, ID, jenis, deskripsi, versi, runtime, dan lokasi.
Untuk melihat detail lengkap agen, klik nama agen.

gcloud

Untuk mencantumkan semua agen di lokasi tertentu, gunakan perintah agents list:

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

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 agen, ID, jenis, deskripsi, versi, runtime, dan lokasi.
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 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'.

Terraform

Untuk mengambil agen terdaftar tertentu dengan memfilter metadata-nya, konfigurasi 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 registri.
DISPLAY_NAME: Nama agen yang dapat dibaca manusia untuk difilter, misalnya, Support Agent.

Melihat detail agen

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

Konsol

Di konsol Google Cloud , buka Agent Registry:

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 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 Sesi, Playground, Memori, dan Evaluasi adalah kemampuan khusus yang ditampilkan untuk agen yang dibangun di runtime terkelola, seperti Agent Runtime di Gemini Enterprise Agent Platform:
- Ringkasan: Detail inti dari agen, termasuk nama, ID, lokasi, deskripsi, dan runtime agen. Ringkasan ini juga menampilkan kemampuan A2A dan URI resource, yang diperlukan untuk membuat kueri di 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 pemanfaatan tingkat sistem guna 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 yang 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 agent-registry agents describe AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION

Ganti AGENT_NAME dengan nama agen Anda, misalnya, my-custom-agent.

Terraform

Untuk mengambil detail tentang agen terdaftar tertentu menggunakan ID-nya, konfigurasi 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 registri.
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.

Untuk Agent Registry API, resource Agent digunakan untuk penemuan. Oleh karena itu, Anda harus memperbarui resource Service yang terdaftar secara langsung.

Konsol

Perbarui detail agen yang tersedia dari konsol Google Cloud :

Di konsol Google Cloud , buka Agent Registry:

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 agen, ID, jenis, deskripsi, versi, runtime, dan lokasi.
Klik nama agen yang ingin Anda perbarui.
Di tab Overview agen, klik Edit.
Di panel Edit layanan, masukkan informasi terbaru agen Anda, seperti nama atau deskripsi barunya.
Klik Simpan.

gcloud

Gunakan gcloud CLI dengan flag tertentu untuk mengubah parameter agen:

Perbarui nama tampilan dan deskripsi: Gunakan tanda --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 registri.

Perbarui URL endpoint: Gunakan tanda --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:
- 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-type dan --agent-spec-content, misalnya, jika Anda memiliki Kartu Agen baru:
```
gcloud agent-registry services update AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --agent-spec-type=a2a-agent-card \
  --agent-spec-content=@AGENT_SPEC_FILE
```
Ganti AGENT_SPEC_FILE dengan jalur ke file spesifikasi agen baru, misalnya, new-agent-card.json. Perhatikan awalan @ yang diperlukan saat meneruskan jalur file ke --agent-spec-content. Ukuran file maksimum untuk file spesifikasi adalah 10 KB.

Terraform

Untuk memperbarui metadata, URL endpoint, atau spesifikasi agen terdaftar Anda, 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 registri.
AGENT_NAME: Nama unik yang ingin Anda berikan ke agen Anda, misalnya, my-support-agent.
ENDPOINT_URL: URL endpoint API agen, misalnya, https://api.remote-service.com/v1/agents/1234.
PROTOCOL: Pengikatan protokol untuk endpoint. Nilai yang valid adalah HTTP_JSON, GRPC, atau JSONRPC.

Menghapus agen

Untuk menghapus agen yang terdaftar secara otomatis ke Agent Registry, Anda harus menghapus agen pokok di runtime Google Cloud tertentu. Agen kemudian akan otomatis dihapus dari pendaftaran.

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:

Konsol

Di konsol Google Cloud , buka Agent Registry:

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 agen, ID, jenis, deskripsi, versi, runtime, dan lokasi.
Klik nama agen yang ingin Anda hapus.
Di tab Ringkasan agen, klik Hapus.
Pada dialog konfirmasi, ketik HAPUS untuk mengonfirmasi tindakan.
Klik Hapus.

gcloud

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

Terraform

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

Langkah berikutnya

Pelajari cara melihat hubungan agen menggunakan grafik topologi.
Pelajari cara menelusuri agen dan alat 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