Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Menggunakan pendaftaran otomatis

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 Pendaftaran Agen. Anda memerlukan ID project 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 menyatakan kapabilitas dan identitasnya. Contoh berikut menunjukkan cara men-deploy agen yang menerapkan protokol A2A 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 menyelaraskan perubahan tersebut.

Mendaftarkan agen Google bawaan

Agen Google bawaan, seperti agen Google Workspace dan Gemini Enterprise, otomatis terdaftar di Agent Registry. Anda tidak perlu melakukan langkah-langkah konfigurasi atau deployment apa pun. Agen ini di-ingest dan tersedia untuk penemuan dalam registri Anda.

Mendaftarkan agen dari GKE

Anda dapat mendaftarkan agen yang di-deploy di Google Kubernetes Engine (GKE) dengan menambahkan anotasi apphub.cloud.google.com/functional-type: "AGENT" ke deployment Anda. Anotasi ini mengidentifikasi deployment sebagai agen AI, sehingga Agent Registry dapat melakukan pemindaian introspeksi.

Contoh berikut menunjukkan manifes deployment agen GKE. Untuk mengetahui informasi selengkapnya, lihat Men-deploy dan mengatur agen AI.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-agent
  annotations:
    # Identifies the deployment as an AI agent
    apphub.cloud.google.com/functional-type: "AGENT"
spec:
  selector:
    matchLabels:
      app: my-agent
  template:
    metadata:
      labels:
        app: my-agent
    spec:
      containers:
      - name: server
        image: gcr.io/my-project/my-agent:1.0.0

Saat deployment diterapkan, cluster GKE akan otomatis mencoba mengambil metadata dari agen dan menyinkronkannya langsung ke model data Agent Registry.

Verifikasi pendaftaran

Anda dapat memverifikasi bahwa Agent Registry berhasil mendaftarkan agen Anda dengan mencantumkannya:

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 dan detailnya, seperti nama, ID, deskripsi, 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

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 registri.
FILTER_EXPRESSION: Ekspresi filter untuk agen yang ingin Anda filter. Misalnya, untuk memfilter menurut nama tampilan, Anda dapat menggunakan displayName='DISPLAY_NAME'. Untuk memfilter menurut ID unik secara global (URN), Anda dapat menggunakan agentId='urn:agent:AGENT_URN'.

Agen Google bawaan menggunakan format URN yang bergantung pada tempat agen di-deploy. Misalnya, Anda dapat menemukan agen bawaan Google Workspace dengan memfilter daftar untuk penayang googleapis.com menggunakan --filter="agentId:'urn:agent:googleapis.com:*'"

Terraform

Mereferensikan agen terdaftar Anda dalam konfigurasi Terraform lain 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
}