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 mendeklarasikan kemampuan dan identitasnya. Agent Registry mendukung versi 0.3 dan 1.0 dari spesifikasi A2A. Untuk mengetahui informasi selengkapnya, lihat
Skema Kartu Agen.
Bergantung pada runtime agen Anda, Agent Registry mendukung dua mekanisme pendaftaran utama: pendaftaran otomatis dan pendaftaran manual.
Pilih mekanisme pendaftaran yang sesuai dengan runtime agen Anda.
Pendaftaran otomatis
Runtime Google Cloud yang didukung mendaftarkan agen Anda dengan 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 Google Cloud project lain.
Pendaftaran otomatis didukung untuk Google Cloud runtime berikut:
- Agent Runtime di Gemini Enterprise Agent Platform: Agen yang di-deploy menggunakan SDK akan didaftarkan tanpa konfigurasi tambahan. Untuk mengetahui informasi selengkapnya, lihat Mendaftarkan agen dari Agent Runtime.
- Agen Google bawaan: Agen yang disediakan langsung oleh Google, seperti agen Google Workspace dan Gemini Enterprise, dapat ditemukan tanpa konfigurasi apa pun. Untuk mengetahui informasi selengkapnya, lihat Mendaftarkan agen Google bawaan.
- Google Kubernetes Engine: Agen dalam container yang di-deploy ke Google Kubernetes Engine (GKE) akan didaftarkan saat dikonfigurasi dengan label jenis fungsi agen AI dan anotasi Kartu Agen. Pengontrol runtime cluster GKE menjalankan pemindaian introspeksi dan memublikasikan metadata ke Agent Registry. Untuk mengetahui informasi selengkapnya, lihat Mendaftarkan agen dari GKE.
- Cloud Run: Agen dalam container yang di-deploy ke
layanan atau tugas Cloud Run akan didaftarkan saat di-deploy dengan flag jenis fungsi dan identitas. Cloud Run otomatis mendaftarkan nama, URL, dan jenis agen (
AGENT) dengan Agent Registry. Untuk mengetahui informasi selengkapnya, lihat Mendaftarkan agen dari Cloud Run.
Metadata dan kemampuan yang diindeks untuk agen selama pendaftaran bergantung pada apakah agen menerapkan protokol Agent2Agent (A2A):
- Agen yang menerapkan A2A protocol: Sistem akan mengkueri Kartu Agen agen (
/.well-known/agent-card.json) untuk otomatis mengekstrak kemampuan dan kapabilitas A2A yang diiklankan ke dalam katalog registry. - Agen yang tidak menerapkan A2A protocol (endpoint REST atau gRPC standar): Sistem akan mendaftarkan URL antarmuka dan binding transportasi agen, tetapi tidak dapat otomatis mengekstrak kapabilitas semantik. Untuk mengaitkan kemampuan dengan endpoint non-A2A, Anda dapat mendeskripsikannya menggunakan pendaftaran manual atau menautkannya ke kemampuan mandiri dan server MCP dalam aplikasi AI.
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 Google Cloud runtime yang tidak mendukung penemuan otomatis, atau di berbagai Google Cloud project, Anda harus menggunakan pendaftaran manual.
Untuk mendaftarkan agen secara manual, gunakan 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
hanya baca Agent yang dapat Anda gunakan untuk penemuan.
Anda dapat mendaftarkan dua jenis agen secara manual:
- Agen yang mematuhi A2A: Agen yang menerapkan spesifikasi A2A
(
A2A_AGENT_CARD). Registry memindai endpoint Kartu Agen (agent-card.json) untuk mengindeks kemampuan A2A-nya. - 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 spoke atau workload.
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 kemampuan mandiri
Agent Registry memungkinkan Anda mengelola dan mengatur kemampuan mandiri
untuk agen sebagai resource tingkat atas.
Kemampuan mandiri didaftarkan sebagai Skill resource di registry Anda,
sehingga administrator dapat menerapkan kebijakan akses terperinci dan mengelola
histori versi menggunakan revisi kemampuan.
Saat membuat dan mengelola agen di Gemini Enterprise, Anda dapat mereferensikan kemampuan terdaftar ini untuk memperluas kemampuan agen Anda. Untuk mengetahui informasi tentang cara mendaftarkan dan mengelola kemampuan mandiri, lihat Mendaftarkan kemampuan dan Mengelola kemampuan.