Menggunakan pendaftaran otomatis

Agent Registry dapat menemukan dan mendaftarkan agen yang dihosting di runtimeGoogle Cloud yang didukung 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.

Mendaftarkan agen dari Vertex AI Agent Engine

Jika Anda mengembangkan agen dengan Vertex AI Agent Engine dan men-deploy-nya menggunakan Vertex AI SDK, 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 Vertex AI Agent Engine. 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 Vertex AI Agent Engine, Agent Registry akan otomatis menyinkronkan perubahan tersebut.

Mendaftarkan agen Google bawaan

Agen Google bawaan, seperti agen Google Workspace dan Gemini Enterprise, otomatis diintegrasikan dengan 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 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 workload 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

  1. Di konsol Google Cloud , buka Agent Registry:

    Buka Agent Registry

  2. Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.

  3. Pilih tab Agen.

    Halaman ini menampilkan daftar semua agen terdaftar dan detailnya, seperti nama, ID, deskripsi, runtime, dan lokasi.

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

Jika Anda memiliki beberapa agen, atau jika Anda ingin mengonfirmasi pendaftaran agen tertentu, seperti agen yang terdaftar secara otomatis, Anda dapat memfilter daftar menurut metadata agen.

Untuk melakukannya, pastikan Anda telah menyiapkan lingkungan Google Cloud CLI untuk Agent Registry, lalu jalankan:

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

Layanan 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:*'"