Mendaftarkan agen

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.

Mendaftarkan agen akan mengubahnya menjadi komponen yang dapat ditemukan dalam Registry Agen. Dengan memublikasikan kemampuan agen, Anda membantu developer dan agen orkestrator lainnya di organisasi Anda menemukan dan menggunakan kembali pekerjaan Anda, sehingga mempercepat pengembangan AI secara keseluruhan.

Bergantung pada runtime agen, Registry Agen mendukung dua mekanisme pendaftaran utama: pendaftaran otomatis dan pendaftaran manual.

Dokumen ini membantu Anda memilih mekanisme pendaftaran yang sesuai dengan runtime agen.

Pendaftaran otomatis

Runtime yang didukung mendaftarkan agen Anda ke Registry Agen secara default atau melalui langkah deployment keikutsertaan. Google Cloud

Pendaftaran otomatis didukung untuk runtime berikut: Google Cloud

• Agent Runtime di Gemini Enterprise Agent Platform: Agen yang di-deploy menggunakan SDK didaftarkan tanpa konfigurasi tambahan.
• Agen Google bawaan: Agen yang disediakan langsung oleh Google, seperti agen Google Workspace dan Gemini Enterprise, dapat ditemukan tanpa konfigurasi apa pun.
• Google Kubernetes Engine: Agen dalam container yang di-deploy ke Google Kubernetes Engine (GKE) akan didaftarkan jika menyertakan anotasi jenis fungsional Registry Agen tertentu.

Metadata dan kemampuan agen yang diambil selama pendaftarannya bergantung pada protokol agen:

• Agen yang menerapkan protokol Agent2Agent (A2A): A2A adalah standar terbuka yang memungkinkan agen mendeklarasikan kemampuan dan identitasnya. Jika agen Anda menerapkan protokol ini, Registry Agen akan otomatis mengekstrak kemampuan agen dari Kartu Agen dan mengisi registry.
• Agen yang tidak menerapkan protokol A2A: Registry Agen mendaftarkan agen, tetapi tidak dapat otomatis mengambil metadata seperti URL inferensi dan kemampuan. Untuk memberikan informasi ini agar agen Anda dapat ditemukan, gunakan pendaftaran manual.

Untuk mengetahui informasi tentang Google Cloud runtime yang mendukung pendaftaran otomatis, lihat Menggunakan pendaftaran otomatis.

Pendaftaran manual

Untuk agen yang dihosting di platform eksternal, lokal, atau di Google Cloud runtime yang tidak mendukung penemuan otomatis, Anda harus menggunakan pendaftaran manual.

Untuk mendaftarkan agen secara manual, Anda menggunakan Agent Registry API untuk membuat resource Service yang menentukan endpoint dan konfigurasi agen. Resource yang dapat ditulis ini juga berisi detail spesifik agen. Setelah Service dibuat, registry akan membuat resource Agent hanya baca yang dapat Anda gunakan untuk penemuan.

Anda dapat mendaftarkan dua jenis agen secara manual:

• Agen yang mematuhi A2A: Agen yang menerapkan spesifikasi Agent2Agent (A2A) (A2A_AGENT_CARD). Registry memindai endpoint Kartu Agen (agent-card.json) untuk mengindeks kemampuan mereka.
• Agen REST standar: Agen jarak jauh yang tidak menerapkan spesifikasi A2A (NO_SPEC), seperti endpoint REST API standar.

Untuk mempelajari cara mendaftarkan agen secara manual, lihat Menggunakan pendaftaran manual.