Mendaftarkan agen ADK kustom

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Jika Anda membuat 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 sesuai dengan protokol Agent2Agent (A2A), sehingga registry dapat mengindeks kemampuannya.

Endpoint Kartu Agen

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

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

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

Mendaftarkan agen yang diekspos

Setelah Anda men-deploy agen ADK ke lingkungan hosting dan berhasil menayangkan endpoint REST-nya, instruksikan 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 alpha 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 Anda, 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 yang dapat ditemukan, dan mengindeks kemampuan yang ditentukan dalam kode Python ADK Anda sehingga developer lain dapat menelusurinya.