Menggunakan pendaftaran otomatis

Agent Registry dapat menemukan dan 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.

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 mendeklarasikan kemampuan 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 Google Workspace dan Gemini Enterprise agen, otomatis terintegrasi dengan 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 dengan menambahkan apphub.cloud.google.com/functional-type: "AGENT" anotasi 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.

Memverifikasi pendaftaran

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

Konsol

  1. Di Google Cloud konsol, buka Agent Registry:

    Buka Agent Registry

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

  3. Pilih tab Agents.

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

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

Jika Anda memiliki beberapa agen, atau jika 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 registry.
  • 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 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 Google Workspace bawaan dengan memfilter daftar untuk penayang googleapis.com menggunakan --filter="agentId:'urn:agent:googleapis.com:*'"