Dokumen ini menjelaskan istilah dan konsep utama terkait Agent Registry.
Keahlian A2A
Bandingkan dengan keterampilan.
Deskripsi kemampuan yang tercantum secara inline dalam
Kartu Agen
agen (agent-card.json). Kemampuan A2A mendeskripsikan tugas yang dapat dilakukan agen dan antarmuka komunikasinya sehingga agen lain tahu kapan dan bagaimana cara mendelegasikan pekerjaan kepadanya.
Agent Registry mendukung versi 0.3 dan 1.0 dari
spesifikasi Agent2Agent (A2A).
Agen
Aktor otonom dalam ekosistem AI Anda, yang ditentukan oleh ID dan keterampilan A2A atau keterampilan tertentu yang dimilikinya.
ID agen
Nama Resource Seragam (URN) yang unik secara global dan tidak dapat diubah untuk agen. ID ini memberikan referensi yang stabil bagi konsumen untuk mencari dan memanggil agen, yang tetap konstan terlepas dari perubahan infrastruktur dasar atau pembaruan kode.
Untuk format sintaksis URN yang mendetail di seluruh runtime yang didukung, lihat ID agen.
Agent Registry menggunakan ID agen untuk pelacakan inventaris, penemuan pendaftaran, dan pemfilteran. Jika Anda ingin mengatur akses dan autentikasi di IAM, gunakan principal agen.
Principal agen
Identitas Identity and Access Management (IAM) unik yang ditetapkan ke agen, sehingga agen dapat memiliki izin, mengakses resource hilir, dan membuat log audit. Mengambil bentuk akun layanan Google Cloud atau Workload Identity terkelola yang dapat diverifikasi, seperti ID SPIFFE, yang terikat langsung ke runtime komputasi agen.
String utama menggabungkan jalur resource runtime dan mendukung tiga cakupan: instance mesin, set utama di seluruh project, dan set utama di seluruh organisasi.
Untuk mengetahui sintaksis lengkap dan panduan kontrol akses, lihat Principal agen.
Komponen agentic
Entitas fungsional modular dalam ekosistem AI yang memungkinkan Anda mendaftarkan, menemukan, dan mengatur Agent Registry. Registry mengategorikan komponen agen ke dalam empat jenis utama: agen, server MCP, endpoint, dan keahlian.
Agentic workflow
Serangkaian langkah di mana agen AI secara mandiri menentukan penggunaan alat, penalaran, dan jalur eksekusi untuk menyelesaikan tugas.
Penyedia Auth
Konfigurasi dalam pengelola autentikasi Identitas Agen untuk menyimpan, mendapatkan, dan mengelola kredensial, seperti kunci API atau token OAuth, untuk menghubungkan agen Anda ke alat dan aplikasi eksternal tertentu serta menentukan jenis autentikasi.
Binding
Koneksi antara agen sumber dan resource target, seperti agen lain, server MCP, atau endpoint. Dengan membuat binding, Anda menetapkan hubungan eksplisit yang memungkinkan agen orkestrator berinteraksi dengan kemampuan hilir. Binding juga digunakan untuk mengaitkan agen dengan penyedia autentikasi untuk mendukung izin yang didelegasikan.
Resource data
Konteks atau set data tertentu yang diekspos oleh server MCP yang dapat diakses oleh agen untuk mendasari respons atau menginformasikan tindakannya.
Discovery
Proses mengkueri registry untuk menemukan agen, alat MCP, atau endpoint yang ada berdasarkan deskripsi, tag, atau keterampilan.
Penemuan di Agent Registry berfokus pada kemampuan yang berpusat pada penggunaan yang dapat digunakan oleh orkestrator AI Anda. Anda menemukan kemampuan yang sudah terdaftar untuk membangun dan mengatur sistem AI.
Proses ini di Agent Registry berbeda dengan penemuan infrastruktur, seperti di App Hub, yang mengidentifikasi resource komputasi yang tidak terdaftar di project Google Cloud Anda.
Endpoint
Untuk Agent Registry API, resource yang merepresentasikan URL target, biasanya REST API, yang diakses oleh agen. Dengan mengabstraksi tujuan ini menjadi resource yang dapat dikelola, Agent Registry memungkinkan Anda mengatur secara terpusat layanan eksternal yang dapat diakses oleh agen.
ID endpoint
Nama Resource Seragam (URN) yang unik secara global dan tidak dapat diubah untuk endpoint yang terdaftar. Mirip dengan ID agen dan ID server MCP, URN ini memberikan referensi registri yang stabil untuk menemukan tujuan API target. Untuk mengetahui informasi selengkapnya, lihat ID endpoint.
Cakupan tata kelola
Batas geografis dan arsitektur tempat resource Agent Registry didaftarkan dan diatur.
Server MCP yang dikelola Google didaftarkan secara eksklusif di lokasi global.
Anda dapat mendaftarkan agen, server MCP, dan endpoint secara manual, serta membuat binding, di lokasi regional yang didukung atau lokasi global. Gateway regional dapat mengatur dan merutekan traffic ke resource regional dan server MCP global.
Untuk mengetahui aturan cakupan regional lengkap dan persyaratan kebijakan, 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 (atau server)
Layanan yang menerapkan Model Context Protocol (MCP) untuk menyediakan alat dan resource data standar kepada agen AI.
ID server MCP
Nama Resource Seragam (URN) yang unik secara global dan tidak dapat diubah untuk server MCP. Mirip dengan ID agen, URN ini memberikan referensi stabil untuk menemukan toolset tertentu.
ID server MCP adalah nama logis yang digunakan untuk pencarian registri dan pengelolaan inventaris. Untuk mengetahui informasi selengkapnya, lihat ID server MCP.
Pendaftaran
Proses menambahkan komponen agen, seperti agen, server MCP, atau endpoint, ke registry. Agent Registry menyediakan mekanisme pendaftaran berikut:
- Pendaftaran otomatis: Penyerapan otomatis resource AI Google Cloud yang didukung, seperti di Agent Runtime. Pendaftaran otomatis beroperasi dalam cakupan satu project.
- Pendaftaran manual: Pengaktifan manual komponen agentik kustom atau eksternal, atau agen yang di-deploy di beberapa Google Cloud project untuk penemuan dan tata kelola terpusat.
Referensi runtime
Lokasi runtime fisik atau infrastruktur komputasi yang menghosting
agen, server MCP, atau endpoint, yang direpresentasikan
di Agent Registry API oleh atribut
agentregistry.googleapis.com/system/RuntimeReference. Misalnya,
referensi runtime dapat mengarah ke mesin penalaran Agent Runtime, deployment GKE, atau layanan Cloud Run.
Jalur referensi runtime disematkan dalam principal agen untuk evaluasi kebijakan IAM. Untuk mengetahui informasi selengkapnya, lihat Referensi runtime.
Layanan
Untuk Agent Registry API, resource yang dapat ditulis digunakan untuk mendaftarkan
komponen agentik kustom atau eksternal secara manual ke dalam registry. A
Service mewakili agen, server MCP, atau endpoint yang ditambahkan secara manual
ke registry Anda. Anda membuat dan mengelola resource Service untuk menentukan
endpoint dan metadata untuk komponen agentik yang tidak
diserap secara otomatis oleh Agent Registry.
Bergantung pada spesifikasi yang Anda berikan, Agent Registry secara otomatis
memproyeksikan Service ini ke sisi konsumen sebagai resource Agent,
McpServer, atau Endpoint hanya baca untuk penemuan.
Anda selalu menggunakan resource Service untuk membuat, mengedit, atau menghapus entri
registri. Namun, untuk mendapatkan, mencantumkan, atau menelusuri entri tersebut, Anda membuat kueri resource Agent, McpServer, atau Endpoint hanya baca.
Keahlian
Bandingkan dengan kemampuan A2A.
Paket mandiri yang terdaftar sebagai resource tingkat teratas di Agent Registry yang memperluas kemampuan agen dengan memberikan petunjuk spesifik dan skrip opsional untuk menyelesaikan tugas. Keterampilan berisi file
petunjuk (SKILL.md), skrip opsional, dan aset metadata.
Keterampilan diidentifikasi dengan Uniform Resource Name (URN). Format yang tepat bergantung pada penayang. Berikut adalah contohnya:
- Keterampilan buatan Google:
urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID. Misalnya:urn:skill:discoveryengine.googleapis.com:discoveryengine:report-writing. - Keterampilan yang didaftarkan secara manual:
urn:skill:projects-PROJECT_NUMBER:locations:LOCATION:private-SKILL_ID. Misalnya:urn:skill:projects-123456789:locations:global:private-create-docs.
Keterampilan buatan Google akan langsung terlihat saat Anda menyiapkan Agent Registry. Namun, Anda juga dapat mendaftarkan keahlian Anda sendiri. Anda mendaftarkan kemampuan di Agent Registry sebagai resource saudara ke agen dan server MCP. Setiap skill memiliki revisi default dan dapat berisi beberapa revisi skill yang diberi versi.
Administrator platform mengatur keahlian dengan mengelola status siklus prosesnya dan menetapkan penunjuk versi default untuk penyelesaian runtime.
Revisi keahlian
Snapshot paket skill yang tidak dapat diubah dan diberi versi. Dengan revisi, Anda dapat memperbarui petunjuk atau skrip skill tanpa mengubah ID skill induk.
Anda dapat mengelola revisi skill untuk memungkinkan kontrol versi skill Anda.
Publisher
Entitas yang membuat dan mendaftarkan keterampilan di Agent Registry.
Penayang yang sudah diisi mencakup penayang Google, seperti cloud.google.com
dan discoveryengine.googleapis.com, serta partner terverifikasi. Skill buatan Google dari penerbit ini akan langsung terlihat saat Anda menyiapkan Pendaftaran Agen.
Keterampilan yang Anda buat otomatis ditetapkan ke penayang private
default, sehingga ID yang dipublikasikan dari keterampilan tertentu diawali dengan
private-. Anda tidak dapat mendaftarkan resource penayang kustom.
Tinjau dan periksa detail penayang untuk keterampilan terdaftar Anda.
Alat
Fungsi deterministik yang disediakan oleh server MCP yang dapat dipanggil oleh agen.