Model data Agent Registry

Agent Registry mengategorikan komponen agentic ekosistem Anda ke dalam empat jenis resource utama yang dapat Anda kelola dan temukan:

  • Agen: Aktor AI otonom yang menjalankan tugas tertentu, memanggil alat, dan berkolaborasi dengan agen lain.
  • Server MCP: Penyedia resource data dan alat terstandarisasi. Alat adalah fungsi deterministik yang diekspos oleh server MCP yang dapat dipanggil agen untuk melakukan tindakan tertentu.
  • Endpoint: URL target, biasanya REST API, yang diakses oleh agen. Dengan mengabstraksi tujuan ini menjadi resource yang dapat dikelola, Agent Registry memungkinkan Anda mengelola secara terpusat API eksternal yang dapat diakses agen Anda.
  • Keterampilan: Kemampuan modular yang memperluas kemampuan agen. Agent Registry membedakan antara keterampilan mandiri, yang merupakan paket petunjuk dan skrip opsional yang diatur langsung di registry, dan keterampilan A2A, yang merupakan deskripsi kemampuan yang tercantum di Kartu Agen agen yang memberi tahu agen lain kapan dan cara berkomunikasi dengannya.

Untuk mengetahui informasi selengkapnya tentang konsep ini dan konsep lainnya yang digunakan Agent Registry, lihat Konsep utama.

Resource API

Agent Registry API memisahkan operasi baca dan tulis untuk agen, endpoint, dan server MCP:

  • Resource API yang dapat ditulis: Anda mengelola komponen agentik ini dengan membuat, memperbarui, atau menghapus resource Service secara manual di registry.
  • Resource API hanya baca: Untuk membuat kueri, mencantumkan, atau menelusuri komponen agen ini, Anda meminta resource Agent, McpServer, atau Endpoint hanya baca ke Agent Registry API.

Flag spesifikasi yang Anda gunakan saat membuat Service menentukan kumpulan resource hanya baca yang dihasilkan:

Flag Pengumpulan resource Kasus penggunaan Nilai valid
--agent-spec-type
--agent-spec-content		 Agent (agents) Agen jarak jauh (agen REST standar atau yang kompatibel dengan A2A) a2a-agent-card, no-spec
--endpoint-spec-type
--endpoint-spec-content		 Endpoint (endpoints) REST API atau URL layanan target eksternal no-spec
--mcp-server-spec-type
--mcp-server-spec-content		 McpServer (mcp-servers) Server Model Context Protocol (MCP) eksternal tool-spec

Pasangan tanda ini tidak dapat muncul bersamaan. Jika Anda menentukan tanda yang tidak valid, resource Anda akan dibuat dalam koleksi yang salah dan mungkin tidak berfungsi dengan kebijakan khusus jenis.

Keterampilan mandiri tidak menggunakan model proyeksi Service. Sebagai gantinya, Anda dapat mengelola, mengontrol versi, dan mencantumkan skill secara langsung menggunakan resource API Skill, SkillRevision, dan Publisher.

Untuk memulai, lihat Menyiapkan Agent Registry. Untuk mengetahui informasi selengkapnya tentang Agent Registry API, lihat dokumentasi referensi API.

Produk dan komponen yang didukung

Agent Registry mengategorikan produk dan komponen yang didukung berdasarkan cara pendaftarannya: secara otomatis atau manual.

Pendaftaran otomatis

Agent Registry otomatis menemukan dan memproses workloadGoogle Cloud yang didukung yang di-deploy dalam project Anda. Untuk agen yang menerapkan protokol Agent2Agent (A2A) terbuka, registry akan otomatis mengekstrak kemampuan dan keahlian A2A mereka dari Kartu Agen mereka. Keterampilan mandiri buatan Google juga dapat ditemukan secara global saat Anda menyiapkan Pendaftaran Agen.

Tabel berikut mencantumkan produk dan komponen yang didaftarkan secara otomatis oleh Agent Registry:

Jenis komponen Produk yang didukung
Agen
Server MCP
Keahlian Keterampilan publik Google dapat ditemukan secara global dari semua project

Pendaftaran manual

Untuk workload kustom, runtime cloud eksternal, infrastruktur lokal, atau agen yang tidak menerapkan A2A protocol, Anda mendaftarkan komponen secara manual menggunakan resource Service yang dapat ditulis. Untuk skill mandiri kustom, Anda menggunakan resource Skill.

Tabel berikut mencantumkan produk dan komponen yang Anda daftarkan secara manual:

Jenis komponen Resource yang didukung
Agen Agen jarak jauh yang di-deploy di Compute Engine, Google Kubernetes Engine, Cloud Run, sistem lokal, atau cloud eksternal
Server MCP Komponen agentik kustom pada runtime yang tidak didukung atau server MCP eksternal
Endpoints REST API target eksternal atau URL layanan yang diatur sebagai endpoint
Keahlian Keterampilan mandiri Anda sendiri yang dibuat oleh organisasi Anda

Langkah berikutnya