Dokumen ini menjelaskan istilah dan konsep utama terkait Agent Registry.
Keahlian A2A
Bandingkan dengan keahlian.
Blok metadata kemampuan deklaratif yang direpresentasikan secara inline dalam
Kartu Agen
(agent-card.json) agen. Keahlian A2A menjelaskan antarmuka komunikasi antar-agen
dan kemampuan tingkat tinggi yang dimiliki oleh agen yang mematuhi A2A.
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 keahlian A2A atau keahlian tertentu yang dimilikinya.
ID agen
Nama unik global dan tidak dapat diubah untuk agen. ID logis ini memberikan referensi stabil bagi konsumen untuk memanggil agen, yang tetap konstan terlepas dari perubahan infrastruktur yang mendasarinya.
ID agen dibuat secara otomatis oleh Agent Registry selama penyerapan dan mengikuti format Uniform Resource Name (URN). Format pastinya bergantung pada tempat agen di-deploy. Berikut adalah contohnya:
- Agent Runtime di Gemini Enterprise Agent Platform:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:reasoningEngines:AGENT_ID - Layanan Cloud Run:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:run:services:SERVICE_NAME - Deployment GKE:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:containers:CLUSTER_NAME:namespace:NAMESPACE:deployment:DEPLOYMENT_NAME - Gemini Enterprise:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:discoveryengine:INSTANCE_ID:root - Google Workspace:
urn:agent:googleapis.com:locations:global:workspaceagent:workspaceagent--a2a - Agen yang terdaftar secara manual:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:AGENT_ID
Principal agen
ID Identity and Access Management (IAM) unik yang ditetapkan ke agen, sehingga agen dapat memiliki izin dan diaudit. ID ini berbentuk akun layanan yang dapat diverifikasi Google Cloud atau identitas workload terkelola, seperti SPIFFE ID, yang terikat ke agen atau server.
Karena identitas ini terikat langsung ke resource komputasi runtime agen, string principal menggabungkan jalur yang tepat ke resource yang mendasarinya. Misalnya, principal agen untuk deployment Agent Runtime di Gemini Enterprise Agent Platform terlihat seperti ini:
principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/REGION/reasoningEngines/REASONING_ENGINE_ID
Agent Registry menampilkan identitas ini sebagai atribut khusus output saat Anda melihat detail agen.
Komponen agentic
Entitas modular dan fungsional dalam ekosistem AI yang memungkinkan Anda mendaftarkan, menemukan, dan mengatur komponen tersebut menggunakan Agent Registry. Registry mengategorikan komponen agentic ke dalam empat jenis utama: agen, server MCP, endpoint, dan keahlian.
Alur kerja agentic
Urutan langkah-langkah saat agen AI secara independen menentukan penggunaan alat, penalaran, dan jalur eksekusi untuk menyelesaikan tugas.
Penyedia autentikasi
Konfigurasi dalam pengelola autentikasi Agent Identity untuk menyimpan, memperoleh, 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 pengatur berinteraksi dengan kemampuan hilir. Binding juga digunakan untuk mengaitkan agen dengan penyedia autentikasi guna mendukung izin yang didelegasikan.
Resource data
Konteks data atau set data tertentu yang diekspos oleh server MCP yang dapat diakses agen untuk mendasari responsnya atau menginformasikan tindakannya.
Discovery
Proses kueri registry untuk menemukan agen, alat MCP , atau endpoint yang ada berdasarkan deskripsi, tag, atau keahlian.
Discovery di Agent Registry berfokus pada kemampuan yang berpusat pada konsumsi yang dapat digunakan oleh pengatur AI Anda. Anda menemukan kemampuan yang sudah terdaftar untuk membangun dan mengatur sistem AI.
Proses ini di Agent Registry berbeda dengan discovery infrastruktur, seperti di Pusat Aplikasi, yang mengidentifikasi resource komputasi yang tidak terdaftar di project Anda Google Cloud .
Endpoint
Untuk Agent Registry API, resource yang mewakili URL target, biasanya REST API, yang diakses oleh agen. Dengan mengabstraksi tujuan ini ke dalam resource yang dapat dikelola, Agent Registry memungkinkan Anda mengatur secara terpusat layanan eksternal yang dapat diakses agen.
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 ke agen AI.
ID server MCP
Uniform Resource Name (URN) unik global dan tidak dapat diubah untuk server MCP. Mirip dengan ID agen, nama ini memberikan referensi stabil untuk menemukan rangkaian alat tertentu.
Formatnya bergantung pada apakah itu layanan Google bawaan atau server eksternal terdaftar. Berikut adalah contohnya:
- Google Cloud server MCP jarak jauh:
urn:mcp:googleapis.com:projects:PROJECT_NUMBER:locations:global:SERVER_NAME - Server MCP yang terdaftar secara manual:
urn:mcp:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVER_ID
Pendaftaran
Proses menambahkan komponen agentic, seperti agen, server MCP, atau endpoint, ke registry. Agent Registry menyediakan mekanisme pendaftaran berikut:
- Pendaftaran otomatis: Penyerapan otomatis resource AI yang didukung Google Cloud , seperti di Agent Runtime. Pendaftaran otomatis beroperasi dalam cakupan satu project.
- Pendaftaran manual: Onboarding manual komponen agentic kustom atau eksternal, atau agen yang di-deploy di beberapa Google Cloud project untuk discovery dan tata kelola terpusat.
URI resource
Lokasi runtime fisik atau infrastruktur yang menghosting agen atau server MCP. Uniform Resource Identifier (URI) adalah urutan karakter unik yang mengidentifikasi resource runtime ini. Misalnya, URI resource dapat berupa endpoint Agent Runtime, deployment Google Kubernetes Engine (GKE), atau layanan Cloud Run.
URI resource berbeda dengan ID agen atau ID server MCP. Nilai ini adalah nama unik dalam format URN yang mengidentifikasi agen dan server MCP Anda di registry. Sebaliknya, URI resource mengarah ke resource komputasi sebenarnya tempat agen atau server berjalan.
Jalur ke URI resource agen disematkan dalam string principal agen untuk mengidentifikasi resource tersebut secara unik dalam kebijakan IAM. Untuk pendaftaran lintas project registrations, URI resource mereferensikan project tempat resource komputasi berada.
Agent Registry menampilkan URI ini sebagai atribut khusus output saat Anda melihat detail agen.
Anda dapat menggunakan URI resource untuk membuat kueri dalam grafik topologi
guna memvisualisasikan alur dan hubungan traffic untuk agen tertentu. Di Agent Registry API, nilai ini direpresentasikan oleh atribut agentregistry.googleapis.com/system/RuntimeReference.
Layanan
Untuk Agent Registry API, resource yang dapat ditulis yang digunakan untuk mendaftarkan komponen agentic kustom atau
eksternal secara manual ke registry. 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 agentic 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 khusus baca untuk discovery.
Anda selalu menggunakan resource Service untuk membuat, mengedit, atau menghapus entri registry. Namun, untuk mendapatkan, mencantumkan, atau menelusuri entri tersebut, Anda membuat kueri resource Agent, McpServer, atau Endpoint khusus baca.
Keahlian
Bandingkan dengan keahlian A2A.
Paket mandiri yang dapat dieksekusi dan terdaftar sebagai resource tingkat atas di
Agent Registry yang memperluas kemampuan agen dengan
memberikan petunjuk, bahasa alami, atau kode tertentu untuk menyelesaikan tugas.
Keahlian berisi file petunjuk (SKILL.md), skrip eksekusi runtime, dan aset metadata.
Keahlian diidentifikasi oleh Uniform Resource Name (URN). Format pastinya bergantung pada penayang. Berikut adalah contohnya:
- Keahlian yang dibuat Google:
urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID. Misalnya,urn:skill:discoveryengine.googleapis.com:discoveryengine:report-writing. - Keahlian yang terdaftar secara manual:
urn:skill:projects-PROJECT_NUMBER:locations:LOCATION:private-SKILL_ID. Misalnya,urn:skill:projects-123456789:locations:global:private-create-docs.
Keahlian yang dibuat Google akan langsung terlihat saat Anda menyiapkan Agent Registry. Namun, Anda juga dapat mendaftarkan keahlian Anda sendiri. Anda mendaftarkan keahlian di Agent Registry sebagai resource saudara untuk agen dan server MCP. Setiap keahlian memiliki revisi default dan dapat berisi beberapa revisi keahlian versi.
Administrator platform mengatur keahlian dengan mengelola status siklus prosesnya dan menetapkan pointer versi default untuk resoltime resolusi.
Revisi keahlian
Snapshot paket keahlian skill yang tidak dapat diubah dan diberi versi. Revisi memungkinkan Anda memperbarui petunjuk atau kode keahlian tanpa mengubah ID keahlian induk.
Anda dapat mengelola revisi keahlian untuk memungkinkan kontrol versi keahlian Anda.
Publisher
Entitas yang membuat dan mendaftarkan keahlian di Agent Registry.
Penayang yang telah diisi sebelumnya mencakup penayang Google, seperti cloud.google.com dan discoveryengine.googleapis.com, serta partner terverifikasi. Keahlian yang dibuat Google dari penayang ini akan langsung terlihat saat Anda menyiapkan Agent Registry.
Keahlian yang Anda buat akan otomatis ditetapkan ke private
penayang default, sehingga ID yang dipublikasikan dari keahlian tertentu akan diawali dengan
private-. Anda tidak dapat mendaftarkan resource penayang kustom.
Tinjau dan periksa detail penayang untuk keahlian terdaftar Anda.
Alat
Fungsi deterministik yang disediakan oleh server MCP yang dapat dipanggil oleh agen.