Dokumen ini menjelaskan istilah dan konsep utama terkait Registry Agen.
Agen
Aktor otonom dalam ekosistem AI Anda, yang ditentukan oleh ID dan keterampilan spesifik 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 Registry Agen selama penyerapan dan mengikuti format Uniform Resource Name (URN). Format pastinya 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:SERVICE_ID
Akun utama agen
ID 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 utama menggabungkan jalur yang tepat ke resource yang mendasarinya. Misalnya, akun utama 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
Registry Agen menampilkan identitas ini sebagai atribut khusus output saat Anda melihat detail agen.
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 Identitas Agen 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 orkestrator 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 atau alat MCP yang ada berdasarkan deskripsi, tag, atau keterampilan. Discovery 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 mewakili URL target, biasanya REST API, yang diakses oleh agen. Dengan mengabstraksi tujuan ini ke dalam resource yang dapat dikelola, Registry Agen memungkinkan Anda mengontrol 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:SERVICE_NAME - Server MCP yang terdaftar secara manual:
urn:mcp:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVICE_ID
Pendaftaran
Proses menambahkan layanan ke registry. Registry Agen menyediakan mekanisme pendaftaran berikut:
- Pendaftaran otomatis: Penyerapan otomatis workload yang didukung Google Cloud, misalnya, di Vertex AI Agent Engine.
- Pendaftaran manual: Onboarding manual workload kustom atau eksternal.
URI resource
Lokasi runtime atau infrastruktur 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 di registry. Sebaliknya, URI resource mengarah ke resource komputasi sebenarnya tempat agen atau server berjalan.
Jalur ke URI resource agen disematkan dalam string agen utama untuk mengidentifikasi workload tersebut secara unik dalam kebijakan IAM.
Registry Agen 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 workload kustom atau eksternal secara manual ke registry. Layanan 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 workload yang tidak diserap secara otomatis oleh Registry Agen.
Bergantung pada spesifikasi yang Anda berikan, Registry Agen secara otomatis memproyeksikan layanan 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 akan mengkueri resource Agent, McpServer, atau Endpoint khusus baca.
Keterampilan
Kemampuan tingkat tinggi yang dimiliki oleh agen A2A agen. Keterampilan diekstrak dari kartu agen A2A dan berfungsi sebagai titik data utama untuk discovery agen.
Alat
Fungsi deterministik yang disediakan oleh server MCP yang dapat dipanggil oleh agen.