Mendaftarkan agen ADK kustom

Agent Registry memungkinkan Anda mendaftarkan agen kustom yang Anda bangun dengan Agent Development Kit (ADK) dan menghostingnya di infrastruktur Anda sendiri sehingga developer dan agen orchestrator lain dapat menemukannya. Dengan mengekspos Kartu Agen yang sesuai dengan protokol Agent2Agent (A2A) dan mendaftarkan endpoint agen secara manual, Anda membuat kemampuan A2A-nya dapat ditemukan di Agent Registry.

Sebelum memulai

  1. Menyiapkan Agent Registry.

  2. Dapatkan project ID untuk project tata kelola tempat Agent Registry diaktifkan.

  3. Untuk menggunakan perintah Google Cloud CLI dalam dokumen ini, siapkan lingkungan gcloud CLI Anda.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mendaftarkan agen ADK kustom di Agent Registry, minta administrator untuk memberi Anda peran IAM Agent Registry API Editor (roles/agentregistry.editor) di project tata kelola tempat Agent Registry diaktifkan. Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Endpoint Kartu Agen

Agar Registry Agen dapat mengindeks kemampuan agen kustom Anda, agen harus mengekspos metadata dan keterampilan A2A yang tersedia menggunakan protokol Agent2Agent (A2A).

Spesifikasi A2A mengharuskan agen untuk menyajikan Kartu Agen, yang merupakan dokumen JSON yang mendeskripsikan identitas dan alat agen, di endpoint tertentu, biasanya /.well-known/agent-card.json.

Saat Anda menggunakan plugin atau modul server A2A khusus ADK untuk mendaftarkan agen, framework dapat otomatis membuat dan menyajikan Kartu Agen ini berdasarkan definisi Agent dan tools yang Anda berikan dalam kode.

Mendaftarkan agen yang terekspos

Setelah Anda men-deploy agen ADK ke lingkungan hosting dan agen tersebut berhasil menyajikan endpoint REST-nya, instruksikan Agent Registry untuk menemukannya.

Karena deployment kustom memerlukan pendaftaran manual, Anda membuat resource Service di registry. Simpan Kartu Agen yang dihasilkan agen Anda sebagai file JSON lokal, misalnya, agent-card.json.

Gunakan gcloud CLI untuk mendaftarkan agen dengan perintah gcloud agent-registry services create, pastikan untuk menentukan jenis spesifikasi a2a-agent-card, dan upload file lokal Anda menggunakan flag --agent-spec-content:

gcloud agent-registry services create AGENT_NAME \
    --project=PROJECT_ID \
    --location=LOCATION \
    --display-name="DISPLAY_NAME" \
    --agent-spec-type=a2a-agent-card \
    --agent-spec-content=agent-card.json

Ukuran file maksimum untuk file spesifikasi adalah 10 KB.

Ganti kode berikut:

  • AGENT_NAME: nama yang ingin Anda berikan ke agen, misalnya, my-custom-agent.
  • PROJECT_ID: project ID.
  • LOCATION: lokasi atau region registry.
  • DISPLAY_NAME: nama agen Anda yang dapat dibaca manusia.

Setelah resource Service dibuat, Agent Registry akan mengurai Kartu Agen, membuat resource Agent hanya baca, dan mengindeks keterampilan A2A yang ditentukan dalam kode Python ADK Anda sehingga developer lain dapat menelusurinya.