Mendaftarkan agen akan mengubahnya menjadi komponen yang dapat ditemukan dalam Agent Registry. Dengan memublikasikan kemampuan A2A agen Anda, Anda membantu developer dan agen pengelola lainnya di organisasi Anda menemukan dan menggunakan kembali pekerjaan Anda, sehingga mempercepat pengembangan AI secara keseluruhan.
Agent Registry terintegrasi dengan lancar dengan protokol Agent2Agent (A2A) dan spesifikasinya. A2A adalah standar terbuka yang memungkinkan agen menyatakan kemampuan dan identitas mereka. Agent Registry mendukung versi 0.3 dan 1.0 dari spesifikasi A2A. Untuk mengetahui informasi selengkapnya, lihat
Skema Kartu Agen.
Bergantung pada runtime agen, Agent Registry mendukung dua mekanisme pendaftaran utama: pendaftaran otomatis dan pendaftaran manual.
Dokumen ini membantu Anda memilih mekanisme pendaftaran yang sesuai dengan runtime agen Anda.
Pendaftaran otomatis
Runtime Google Cloud yang didukung mendaftarkan agen Anda ke Agent Registry dalam project yang sama, baik secara default maupun melalui langkah deployment keikutsertaan. Pendaftaran otomatis beroperasi di tingkat project dan tidak otomatis menemukan agen yang di-deploy di project Google Cloud lain.
Pendaftaran otomatis didukung untuk runtime Google Cloud berikut:
- 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) didaftarkan saat menyertakan label jenis fungsi Agent Registry tertentu.
Metadata dan kemampuan A2A agen yang diambil selama pendaftarannya bergantung pada protokol agen:
- Agen yang menerapkan protokol Agent2Agent (A2A): A2A adalah standar terbuka yang memungkinkan agen menyatakan kemampuan dan identitasnya. Jika agen Anda menerapkan protokol ini, Agent Registry akan otomatis mengekstrak kemampuan A2A agen dari Kartu Agen dan mengisi registry.
- Agen yang tidak menerapkan A2A protocol: Agent Registry mendaftarkan agen, tetapi tidak dapat otomatis mengambil metadata seperti URL inferensi dan kemampuan A2A. 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, di runtime Google Cloud yang tidak mendukung penemuan otomatis, atau di berbagai projectGoogle Cloud , Anda harus menggunakan pendaftaran manual.
Untuk mendaftarkan agen secara manual, Anda menggunakan Agent Registry API, Google Cloud CLI, atau Terraform untuk membuat resource Service yang menentukan endpoint dan konfigurasi agen. Resource Service 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 kompatibel dengan A2A: Agen yang menerapkan spesifikasi A2A
(
A2A_AGENT_CARD). Registry memindai endpoint Kartu Agen (agent-card.json) untuk mengindeks keterampilan A2A mereka. - Agen REST standar: Agen jarak jauh yang tidak menerapkan spesifikasi A2A (
NO_SPEC), seperti endpoint API REST standar.
Untuk mempelajari cara mendaftarkan agen secara manual, lihat Menggunakan pendaftaran manual.
Pertimbangan pendaftaran lintas project
Jika organisasi Anda menggunakan arsitektur tata kelola terpusat dengan Agent Gateway, Anda dapat men-deploy gateway keluar Agent-to-Anywhere di project tata kelola pusat dan mendaftarkan agen yang di-deploy di beberapa project workload atau spoke.
Karena pendaftaran otomatis hanya menemukan resource di project lokal, Anda harus mendaftarkan agen jarak jauh secara manual di registry project tata kelola pusat. Pendaftaran lintas project memungkinkan gateway pusat menemukan dan mengatur agen. Untuk mengetahui petunjuknya, lihat Mendaftarkan agen dari project lain.
Mengintegrasikan keahlian mandiri
Agent Registry memungkinkan Anda mengelola dan mengatur keterampilan mandiri untuk agen sebagai resource tingkat teratas.
Keterampilan mandiri terdaftar sebagai resource Skill di registri Anda, sehingga administrator dapat menerapkan kebijakan akses terperinci dan mengelola histori versi menggunakan revisi keterampilan.
Saat membangun dan mengelola agen di Gemini Enterprise, Anda dapat merujuk pada kemampuan terdaftar ini untuk memperluas kemampuan agen Anda. Untuk mengetahui informasi tentang cara mendaftarkan dan mengelola skill mandiri, lihat Mendaftarkan skill dan Mengelola skill.