Dokumen ini menjelaskan istilah dan konsep utama yang terkait dengan Agent Registry.
Agen
Aktor otonom dalam ekosistem AI Anda, yang ditentukan oleh ID dan keterampilan spesifik yang dimilikinya.
ID agen
Nama yang unik secara global dan tidak dapat diubah untuk agen. ID logis ini memberikan referensi yang 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 yang tepat 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. Identitas ini berbentuk akun layanan Google Cloud yang dapat diverifikasi atau identitas workload terkelola, seperti ID SPIFFE, yang terikat ke agen atau server.
Karena identitas ini terikat langsung ke resource komputasi runtime agen, string utama menyertakan jalur persis ke resource yang mendasarinya. Misalnya, prinsipal 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 hanya output saat Anda melihat detail agen.
Komponen agentik
Entitas fungsional modular dalam ekosistem AI yang memungkinkan Anda mendaftarkan, menemukan, dan mengatur Agent Registry. Registry mengategorikan komponen agen ke dalam tiga jenis utama: agen, server MCP, dan endpoint.
Alur kerja agentic
Serangkaian langkah yang dilakukan agen AI secara mandiri untuk menentukan penggunaan alat, penalaran, dan jalur eksekusi untuk menyelesaikan tugas.
Penyedia autentikasi
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 mana yang dapat diakses oleh 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 sumber data terstandarisasi 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, nama ini memberikan referensi yang stabil untuk menemukan toolset 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 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 manual: Pengaktifan manual komponen agentik kustom atau eksternal.
URI Resource
Lokasi atau infrastruktur runtime fisik 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 dalam registri. 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.
Agent Registry menampilkan URI ini sebagai atribut hanya output saat Anda melihat detail agen.
Anda dapat menggunakan URI resource untuk membuat kueri di grafik
topologi untuk
memvisualisasikan alur traffic dan hubungan untuk agen tertentu. Di
Agent Registry API, nilai ini diwakili oleh atribut
agentregistry.googleapis.com/system/RuntimeReference.
Layanan
Untuk Agent Registry API, resource yang dapat ditulis digunakan untuk mendaftarkan komponen agentik kustom atau eksternal secara manual ke dalam 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 bagi komponen agentik yang tidak otomatis di-ingest 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
Kemampuan tingkat tinggi yang dimiliki oleh agen A2A. Kemampuan diekstrak dari kartu agen A2A dan berfungsi sebagai titik data utama untuk penemuan agen.
Alat
Fungsi deterministik yang disediakan oleh server MCP yang dapat dipanggil oleh agen.