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:
- Vertex AI Agent Engine:
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 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 menggabungkan jalur persis ke resource pokok tersebut. Misalnya, prinsipal agen untuk deployment Vertex AI Agent Engine 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.
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
Kumpulan data atau konteks 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 atau alat MCP yang ada berdasarkan deskripsi, tag, atau keterampilan. Penemuan berdasarkan keterampilan tersedia untuk agen yang mengekspos kemampuannya melalui Kartu Agen, seperti agen yang menerapkan protokol Agent2Agent (A2A).
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 agentik ke registry. Agent Registry menyediakan mekanisme pendaftaran berikut:
- Pendaftaran otomatis: Penyerapan otomatis beban kerja Google Cloudyang didukung, misalnya, di Vertex AI Agent Engine.
- Pendaftaran manual: Orientasi manual untuk workload 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 Vertex AI, deployment 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 workload 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 beban kerja kustom atau
eksternal secara manual ke dalam registry. Service merepresentasikan agen, server MCP, atau endpoint yang ditambahkan secara manual ke registry Anda. Anda membuat dan
mengelola resource Service untuk menentukan endpoint dan metadata untuk beban kerja
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.