Agent Registry menggunakan terminologi standar untuk mendeskripsikan komponen, resource, dan mekanisme tata kelola di seluruh ekosistem AI Anda. Memahami konsep dasar ini akan membantu Anda mendaftarkan, menemukan, menghubungkan, dan mengatur agen, server MCP, endpoint, dan keahlian di Agent Registry.
Keterampilan A2A
Bandingkan dengan keterampilan.
Deskripsi kemampuan yang tercantum secara inline dalam agent-card.json
Kartu Agen agen. Kemampuan A2A
menjelaskan tugas yang dapat dilakukan agen dan antarmuka komunikasinya sehingga
agen lain tahu kapan dan cara mendelegasikan pekerjaan kepadanya.
Registry Agen mendukung versi 0.3 dan 1.0 dari
spesifikasi Agent2Agent (A2A). Untuk perbandingan
dengan kemampuan mandiri, lihat
Perbedaan antara kemampuan mandiri dan A2A.
Agen
Aktor otonom dalam ekosistem AI Anda yang merencanakan, menalar, memanggil alat,
dan berkolaborasi dengan agen lain. Agen ditentukan oleh
ID agen-nya
dan setiap kemampuan A2A atau kemampuan mandiri yang dimilikinya. Di
Agent Registry, agen terdaftar direpresentasikan sebagai resource penemuan Agent
hanya baca.
Entitas agen
Identitas Identity and Access Management (IAM) unik yang ditetapkan ke agen, sehingga agen dapat memiliki izin, mengakses resource downstream, dan membuat log audit. Identitas ini berbentuk akun layanan atau workload identity terkelola yang dapat diverifikasi, seperti ID SPIFFE, yang terikat langsung ke runtime komputasi agen. Google Cloud
String akun utama menggabungkan jalur referensi runtime dan mendukung tiga cakupan: instance mesin, set akun utama di seluruh project, dan set akun utama di seluruh organisasi.
Untuk mengetahui sintaksis lengkap dan panduan kontrol akses, lihat Entitas agen.
Komponen agentic
Entitas fungsional modular dalam ekosistem AI yang dapat Anda daftarkan, temukan, dan kelola dengan Agent Registry. Registry mengategorikan komponen agen menjadi empat jenis utama: agen, server MCP, endpoint, dan kemampuan.
Untuk mengetahui informasi selengkapnya, lihat Siklus proses dan penemuan komponen.
Alur kerja agentic
Serangkaian langkah yang memungkinkan agen AI menentukan penggunaan alat, penalaran, dan jalur eksekusi secara mandiri untuk menyelesaikan tugas.
Penyedia autentikasi
Konfigurasi dalam pengelola autentikasi Agent Identity untuk menyimpan, memperoleh, dan mengelola kredensial, seperti kunci API atau token OAuth, guna menghubungkan agen Anda ke alat eksternal dan layanan downstream.
Untuk mengetahui informasi selengkapnya tentang cara mengikat agen ke penyedia autentikasi, lihat Hubungan komponen.
Binding
Koneksi terarah antara agen sumber dan resource target, seperti agen lain, server MCP, atau endpoint. Binding membuat jalur delegasi eksplisit antara komponen dan mengaitkan agen dengan penyedia autentikasi untuk izin yang didelegasikan.
Untuk mengetahui informasi selengkapnya, lihat Binding.
Resource data
Konteks data atau set data tertentu yang diekspos oleh server MCP yang dapat diakses oleh agen untuk mendasarkan responsnya atau menginformasikan tindakannya.
Discovery
Proses mengkueri Agent Registry untuk menemukan agen, alat MCP, endpoint, atau kemampuan yang terdaftar menggunakan penelusuran bahasa alami, tag, atau ID registry.
Penemuan di Agent Registry berfokus pada penemuan konsumsi, yang mengidentifikasi kemampuan dan komponen yang dapat dipanggil oleh agen orchestrator Anda saat runtime. Untuk mengetahui informasi selengkapnya, lihat Jenis penemuan.
Endpoint
URL target, biasanya REST API, yang diakses oleh agen. Di
Registry Agen, endpoint terdaftar direpresentasikan sebagai resource penemuan Endpoint
hanya baca, sehingga Anda dapat mengatur secara terpusat layanan eksternal mana yang dapat
diakses agen.
Project tata kelola
Project Google Cloud tempat Anda mengaktifkan Agent Registry API untuk membuat katalog, menemukan, dan mengatur komponen agentic secara terpusat. Untuk mengetahui informasi selengkapnya tentang konfigurasi project tunggal dan lintas project, lihat Menentukan project tata kelola untuk registry pusat.
Cakupan tata kelola
Batas geografis dan arsitektur tempat resource Agent Registry didaftarkan dan diatur.
Agent Registry menggunakan Google Cloud project tata kelola pusat, tempat Anda mengaktifkan Agent Registry API untuk membuat katalog dan mengatur komponen agen Anda. Pendaftaran otomatis menemukan workload yang didukung yang di-deploy dalam project tata kelola tersebut. Untuk mengatur komponen jarak jauh, yang merupakan agen, server MCP, atau endpoint yang dihosting di luar project tata kelola dalam project Google Cloud terpisah, lingkungan lokal, atau cloud eksternal, Anda harus mendaftarkannya secara manual di registry project tata kelola.
Saat Agent Registry otomatis mendaftarkan server MCP Google atau Google Cloud
jarak jauh, Agent Registry akan membuat resource McpServer hanya di lokasi global, bukan di masing-masing region. Anda dapat mendaftarkan agen, server MCP, dan endpoint secara manual, serta membuat binding, di wilayah yang didukung atau lokasi global. Gateway regional dapat mengatur dan merutekan traffic ke
resource regional dan server MCP global.
Untuk mengetahui aturan cakupan regional dan persyaratan kebijakan selengkapnya, lihat Lokasi Agent Registry.
Model Context Protocol (MCP)
Standar terbuka yang digunakan untuk menghubungkan model AI ke sumber data dan alat, menggantikan plugin khusus.
Server MCP
Program yang mengimplementasikan
Model Context Protocol (MCP)
untuk mengekspos kemampuan alat dan resource data
yang terstandardisasi ke agen AI. Di Agent Registry, server MCP yang terdaftar direpresentasikan sebagai resource penemuan McpServer hanya baca.
Publisher
Entity yang membuat dan mendaftarkan kemampuan, yang direpresentasikan sebagai
resource Publisher di Agent Registry. Penayang menetapkan kepemilikan
dan sintaksis
ID keahlian
untuk sebuah keahlian.
Keahlian yang dikelola Google menggunakan domain layanan. Kemampuan yang dibuat secara manual
akan otomatis dicakupkan ke penayang private dengan awalan private-.
Untuk mengetahui informasi selengkapnya, lihat Penayang.
Pendaftaran
Proses penambahan komponen agen, seperti agen, server MCP, endpoint, atau keahlian, ke Registry Agen.
Agent Registry mendukung dua model pendaftaran:
- Pendaftaran otomatis: penyerapan otomatis agen, server MCP, dan keahlian yang dikelola Google dari runtime Google Cloud yang didukung, seperti Agent Runtime di Gemini Enterprise Agent Platform, yang di-deploy di project tata kelola tempat Agent Registry diaktifkan.
- Pendaftaran manual: pendaftaran eksplisit agen jarak jauh atau kustom, server MCP, endpoint, dan skill mandiri pribadi, termasuk komponen yang dihosting di project Google Cloud terpisah, lingkungan lokal, cloud eksternal, atau runtime yang tidak didukung, dengan membuat resource di registry project tata kelola.
Untuk perbandingan arsitektur yang mendetail, lihat Model pendaftaran.
ID registry
Uniform Resource Name (URN) unik global dan tidak dapat diubah yang ditetapkan oleh Agent Registry ke komponen agen terdaftar. ID ini memberikan referensi yang stabil bagi konsumen dan agen orchestrator untuk menemukan, memfilter, dan menelusuri komponen di Registry Agen, yang tetap konstan terlepas dari perubahan infrastruktur dasar atau update kode.
Untuk mengetahui format sintaksis URN yang mendetail, lihat ID registry.
Referensi runtime
Lokasi runtime fisik atau infrastruktur komputasi yang menghosting
agen, server MCP, atau endpoint, yang direpresentasikan
di Agent Registry oleh
atribut agentregistry.googleapis.com/system/RuntimeReference. Misalnya,
referensi runtime dapat mengarah ke
mesin penalaran Agent Runtime, deployment
Google Kubernetes Engine (GKE), atau layanan Cloud Run.
Jalur referensi runtime disematkan dalam entitas agen untuk evaluasi kebijakan IAM. Untuk mengetahui informasi selengkapnya, lihat Referensi runtime.
Resource layanan
Resource yang dapat ditulis di Agent Registry, yang diidentifikasi dengan
nama resource-nya sendiri, yang
Anda gunakan untuk operasi pengelolaan saat mendaftarkan
agen, server MCP, atau endpoint secara manual. Resource
Service menyimpan metadata komponen, termasuk jenis
komponen agentic dan detail konfigurasi seperti URL antarmuka,
deskripsi, binding protokol, dan spesifikasi kemampuan. Komponen yang terdaftar secara otomatis atau skill mandiri tidak menggunakan resource Service.
Anda membuat, memperbarui, atau menghapus resource Service untuk mendaftarkan, memperbarui metadata, atau membatalkan pendaftaran komponen yang terdaftar secara manual di Agent Registry tanpa mengubah atau menghapus deployment yang mendasarinya. Saat Anda membuat atau memperbarui resource Service, Agent Registry akan membaca metadata dan otomatis membuat atau memperbarui resource penemuan Agent, McpServer, atau Endpoint yang sesuai. Di Agent Registry, konsumen, seperti agen orchestrator,
aplikasi klien, dan developer, menggunakan resource penemuan hanya baca ini untuk
mencantumkan, menelusuri, dan melihat komponen agentic. Untuk mengetahui informasi selengkapnya, lihat
Representasi komponen agentic di Agent Registry.
Keahlian
Bandingkan dengan keahlian A2A.
Paket mandiri yang terdaftar sebagai resource Skill level teratas di
Agent Registry yang memperluas kemampuan agen dengan
memberikan petunjuk spesifik dan skrip opsional untuk menyelesaikan tugas. Skill
berisi file petunjuk SKILL.md, skrip opsional, dan aset
metadata.
Keterampilan diidentifikasi oleh ID keterampilan yang dicakup oleh penerbit dan nama resource standar. Setiap keahlian mempertahankan pointer revisi default dan memiliki satu atau beberapa snapshot berversi, yang masing-masing direpresentasikan sebagai revisi keahlian.
Untuk mengetahui detail arsitektur, pengemasan, dan siklus proses, lihat Arsitektur keterampilan.
Revisi keahlian
Snapshot paket kemampuan yang tidak dapat diubah dan memiliki versi, yang direpresentasikan sebagai
resource SkillRevision di Agent Registry. Revisi keterampilan memungkinkan Anda memperbarui
petunjuk keterampilan atau skrip opsional tanpa mengubah
ID keterampilan induk
atau merusak dependensi agen yang ada.
Untuk mengetahui informasi selengkapnya tentang pembuatan versi dan keabadian revisi, lihat Revisi skill.
Alat
Fungsi deterministik yang disediakan oleh server MCP yang dapat dipanggil oleh agen.