Agent Registry dapat mendaftarkan agen yang dihosting di runtime yang didukung Google Cloud tanpa mengharuskan Anda memanggil Agent Registry API secara manual. Bergantung pada runtime, proses pendaftaran ini terjadi secara otomatis atau memerlukan langkah konfigurasi keikutsertaan selama deployment.
Dokumen ini menjelaskan cara mengaktifkan penemuan untuk agen di runtime yang didukung. Jika Anda menghosting agen secara eksternal atau di runtime yang tidak didukung, lihat Menggunakan pendaftaran manual.
Metadata dan kemampuan yang diekstrak dari agen selama pendaftarannya bergantung pada protokol agen. Untuk mengetahui informasi selengkapnya, lihat Mendaftarkan agen.
Sebelum memulai
Sebelum mendaftarkan agen, siapkan Agent Registry. Anda memerlukan project ID Anda untuk memverifikasi pendaftaran.
Untuk menggunakan perintah Google Cloud CLI dalam dokumen ini, pastikan Anda telah menyiapkan lingkungan gcloud CLI.
Mendaftarkan agen dari Agent Runtime
Jika Anda mengembangkan dan men-deploy agen dengan Agent Runtime di Gemini Enterprise Agent Platform, pendaftaran di Agent Registry akan otomatis.
Protokol Agent2Agent (A2A) adalah standar terbuka yang memungkinkan agen mendeklarasikan kemampuan dan identitasnya. Contoh berikut menunjukkan cara men-deploy agen yang menerapkan A2A protocol ke Agent Runtime. Untuk mengetahui informasi selengkapnya, lihat Men-deploy agen.
# Create and deploy the agent
# This action automatically registers the agent in Agent Registry
remote_agent = client.agent_engines.create(
agent=my_a2a_agent, # Your defined A2A object
config={
"display_name": "my-support-agent",
"description": "An agent that handles support tickets.",
"requirements": ["google-cloud-aiplatform[agent_engines,langchain]"],
},
)
Saat Anda memperbarui atau menghapus agen di Agent Runtime, Agent Registry akan otomatis menyinkronkan perubahan tersebut.
Mendaftarkan agen Google bawaan
Agen Google bawaan, seperti Google Workspace dan Gemini Enterprise agen, otomatis terdaftar di Agent Registry. Anda tidak perlu melakukan langkah konfigurasi atau deployment apa pun. Agen ini di-ingest dan tersedia untuk penemuan dalam registry Anda.
Mendaftarkan agen dari GKE
Anda dapat mendaftarkan agen yang di-deploy di
Google Kubernetes Engine (GKE)
dengan menambahkan label registry.gke.io/functional-type: "AGENT" ke
deployment Anda. Label ini mengidentifikasi deployment sebagai agen AI, sehingga Agent Registry dapat melakukan pemindaian introspeksi.
Untuk mengaktifkan penemuan otomatis kemampuan agen, Anda juga harus memberikan anotasi a2a-protocol.org/agent-card. Pengontrol ingestion menggunakan anotasi ini untuk membuat kueri Kartu Agen A2A. Selain itu, konfigurasi Workload Identity menggunakan anotasi iam.gke.io/spiffe-identity-type: agent-identity untuk membantu mengaktifkan komunikasi yang diautentikasi secara aman.
Contoh berikut menunjukkan manifes deployment agen GKE menggunakan konfigurasi ini. Untuk mengetahui informasi selengkapnya, lihat Men-deploy dan mengatur agen AI.
apiVersion: apps/v1
kind: Deployment
metadata:
name: my-agent
labels:
# GKE takes this label and registers the agent to Agent Registry
registry.gke.io/functional-type: "AGENT"
annotations:
# A2A protocol metadata annotation for automated Agent Card discovery
a2a-protocol.org/agent-card: |
card:
endpoint: /.well-known/agent-card.json
protocol: HTTP
port: 8080
spec:
selector:
matchLabels:
app: my-agent
template:
metadata:
annotations:
# Workload Identity annotation for identity and access management
iam.gke.io/spiffe-identity-type: agent-identity
labels:
app: my-agent
spec:
containers:
- name: server
image: gcr.io/my-project/my-agent:1.0.0
ports:
- containerPort: 8080
env:
- name: PORT
value: "8080"
---
apiVersion: v1
kind: Service
metadata:
name: my-agent-service
labels:
app: my-agent
spec:
type: ClusterIP
ports:
- port: 8080
targetPort: 8080
protocol: TCP
name: http
selector:
app: my-agent
Saat deployment diterapkan, cluster GKE akan otomatis mencoba mengambil metadata dari agen dan menyinkronkannya langsung ke model data Agent Registry.
Memverifikasi pendaftaran
Anda dapat memverifikasi bahwa Agent Registry berhasil mendaftarkan agen Anda dengan mencantumkannya:
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 dan detailnya, seperti nama, ID, deskripsi, runtime, dan lokasi.
Filter daftar menurut lokasi agen atau resource runtime-nya:
- Untuk memfilter menurut lokasi, klik menu Location, pilih lokasi yang ingin Anda filter, lalu klik Apply.
- Untuk memfilter menurut 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
Anda dapat memfilter daftar menurut metadata agen. Pastikan Anda telah menyiapkan lingkungan Google Cloud CLI untuk Agent Registry, lalu jalankan:
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, untuk memfilter menurut nama tampilan, Anda dapat menggunakandisplayName='DISPLAY_NAME'. Untuk memfilter menurut ID unik global (URN), Anda dapat menggunakanagentId='urn:agent:AGENT_URN'.
Agen Google bawaan menggunakan format URN yang bergantung pada tempat agen di-deploy. Misalnya, Anda dapat menemukan agen Google Workspace bawaan dengan
memfilter daftar untuk penayang googleapis.com menggunakan
--filter="agentId:'urn:agent:googleapis.com:*'"
Terraform
Referensi agen terdaftar Anda dalam konfigurasi Terraform lainnya menggunakan sumber data google_agent_registry_agent:
data "google_agent_registry_agent" "my_agent" {
location = "REGION"
filter = "displayName=\"DISPLAY_NAME\""
}
output "agent_urn" {
value = data.google_agent_registry_agent.my_agent.urn
}
Ganti kode berikut:
REGION: Region registry.DISPLAY_NAME: Nama tampilan agen yang dapat dibaca manusia.