Mendaftarkan agen ADK kustom

Jika Anda membangun agen kustom menggunakan Agent Development Kit (ADK) dan menghostingnya di infrastruktur Anda sendiri, Anda dapat membuatnya dapat ditemukan di Agent Registry dengan mengekspos Kartu Agen dan mendaftarkan endpoint-nya secara manual.

Dokumen ini menjelaskan cara memastikan agen ADK Anda mematuhi protokol Agent2Agent (A2A), sehingga memungkinkan indeks registri keterampilan A2A-nya.

Endpoint Kartu Agen

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

Spesifikasi A2A mewajibkan 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 spesifik ADK untuk mendaftarkan agen, framework dapat otomatis membuat dan menayangkan Kartu Agen ini berdasarkan definisi Agent dan tools yang Anda berikan dalam kode.

Mendaftarkan agen yang diekspos

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

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

Gunakan Google Cloud CLI untuk mendaftarkan agen, 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 untuk 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 mengurai Kartu Agen, membuat resource Agent yang dapat ditemukan, dan mengindeks kemampuan A2A yang ditentukan dalam kode Python ADK Anda sehingga developer lain dapat mencarinya.