Dokumen ini menjelaskan istilah dan konsep utama terkait Agent Registry.
Agen
Aktor otonom dalam ekosistem AI Anda, yang ditentukan oleh ID-nya dan keterampilan tertentu yang dimilikinya.
ID agen
Nama yang unik secara 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 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. 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 dapat Anda daftarkan, temukan, dan atur dengan Agent Registry. Registry mengategorikan komponen agentic ke dalam tiga jenis utama: agen, server MCP, dan endpoint.
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 keterampilan.
Discovery di Agent Registry berfokus pada kemampuan yang berpusat pada penggunaan 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) yang unik secara 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 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 Google Cloud AI yang didukung, seperti di Agent Runtime.
- Pendaftaran manual: Onboarding manual komponen agentic kustom atau eksternal.
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.
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 diwakili oleh atribut agentregistry.googleapis.com/system/RuntimeReference.
Layanan
Untuk Agent Registry API, resource yang dapat ditulis 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
Kemampuan tingkat tinggi yang dimiliki oleh agen. Keahlian diekstrak
dari Kartu Agen Agent2Agent (A2A)
dan berfungsi sebagai titik data utama untuk discovery agen.
Agent Registry mendukung versi 0.3 dan 1.0 dari spesifikasi A2A.
Alat
Fungsi deterministik yang disediakan oleh server MCP yang dapat dipanggil oleh agen.