Model data Agent Registry

Agent Registry mengatur ekosistem AI Anda menjadi resource standar sehingga Anda dapat mendaftarkan, menemukan, dan mengatur agen, server MCP, endpoint, dan kemampuan. Memahami cara Agent Registry memisahkan resource Service yang dapat ditulis dari resource penemuan hanya baca, serta produk mana yang mendukung pendaftaran otomatis dan manual, akan membantu Anda mendesain dan mengatur registry.

Komponen agentic

Agent Registry memungkinkan Anda mendaftarkan, menemukan, dan mengatur jenis komponen agentic berikut:

  • Agen: aktor AI otonom yang menjalankan tugas tertentu, memanggil alat, dan berkolaborasi dengan agen lain.
  • Server MCP: program yang mengimplementasikan Model Context Protocol (MCP) untuk mengekspos resource dan alat data standar. 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 mengatur secara terpusat API eksternal mana yang dapat diakses oleh agen Anda.
  • Keterampilan: kemampuan modular yang memperluas hal yang dapat dilakukan agen. Keterampilan mandiri adalah paket petunjuk dan skrip opsional yang diatur langsung di registry. Kemampuan A2A adalah deskripsi kapabilitas di Kartu Agen yang memberi tahu agen lain kapan dan cara berkomunikasi dengannya. Untuk mengetahui informasi selengkapnya, lihat Arsitektur keterampilan.

Resource layanan dan resource penemuan

Cara Agent Registry merepresentasikan komponen bergantung pada jenis komponen dan model pendaftarannya. Untuk mengetahui informasi selengkapnya tentang siklus proses dan penemuan komponen, lihat Siklus proses dan penemuan komponen.

Agen, server MCP, dan endpoint

Terlepas dari apakah agen, server MCP, atau endpoint didaftarkan secara otomatis atau manual, Agent Registry akan merepresentasikannya sebagai resource penemuan Agent, McpServer, atau Endpoint hanya baca. Konsumen, seperti agen orchestrator, aplikasi klien, dan developer, menggunakan resource penemuan ini untuk mencantumkan, menelusuri, dan melihat komponen terdaftar.

Untuk komponen yang terdaftar secara otomatis, Agent Registry menyerap metadata langsung dari runtime yang didukung dan membuat resource penemuan tanpa resource Service.

Saat Anda mendaftarkan secara manual agen, server MCP, atau endpoint, Agent Registry memisahkan operasi pengelolaan dari penemuan komponen dengan membuat item berikut:

  • Resource Service yang dapat ditulis: menyimpan metadata komponen, termasuk jenis komponen agentic, URL antarmuka, deskripsi, binding protokol, dan spesifikasi kemampuan. Anda membuat, memperbarui, atau menghapus resource Service untuk operasi pengelolaan seperti memperbarui metadata atau membatalkan pendaftaran komponen, tanpa mengubah atau menghapus deployment yang mendasarinya.
  • Resource penemuan: saat Anda membuat atau memperbarui resource Service, Agent Registry akan membaca metadata dan otomatis membuat atau memperbarui resource penemuan Agent, McpServer, atau Endpoint yang mewakili komponen di registry Anda.

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

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

Pasangan flag ini tidak dapat muncul bersamaan; menentukan flag dari lebih dari satu pasangan akan menampilkan error. Jika Anda menentukan pasangan flag untuk jenis komponen yang salah, Agent Registry akan membuat resource penemuan dalam koleksi yang cocok dengan flag yang Anda tentukan. Misalnya, meneruskan --agent-spec-type=no-spec saat mendaftarkan endpoint akan membuat resource Agent, bukan resource Endpoint, sehingga kueri dan kebijakan tata kelola khusus jenis tidak akan berlaku seperti yang diharapkan.

Keterampilan mandiri

Skill mandiri tidak menggunakan resource Service terpisah. Sebagai gantinya, Anda mendaftarkan, membuat versi, dan mengkueri skill secara langsung menggunakan resource Skill level teratas, resource SkillRevision turunan, dan resource 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: otomatis atau manual.

Pendaftaran otomatis

Registry Agen otomatis menemukan dan menyerap workloadGoogle Cloud yang didukung yang di-deploy dalam project Anda. Untuk agen yang menerapkan protokol Agent2Agent (A2A) terbuka, registry akan otomatis mengekstrak keterampilan dan kemampuan A2A mereka dari Kartu Agen mereka. Kemampuan mandiri yang dikelola Google juga dapat ditemukan di semua project saat Anda menyiapkan Agent Registry.

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

Jenis komponen Produk yang didukung
Agen
Server MCP
Keahlian Keahlian yang dikelola Google dapat ditemukan dari semua project

Pendaftaran manual

Untuk komponen jarak jauh, yang merupakan agen, server MCP, atau endpoint yang dihosting di luar project tata kelola Anda dalam project Google Cloud terpisah, infrastruktur lokal, atau cloud eksternal, Anda mendaftarkan komponen secara manual di project tata kelola menggunakan resource Service. Anda juga menggunakan resource Service untuk mendaftarkan komponen secara manual pada runtime atau agen yang tidak didukung yang tidak menerapkan protokol A2A. 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, GKE, Cloud Run, sistem lokal, atau cloud eksternal
Server MCP Komponen agentic kustom pada runtime yang tidak didukung atau server MCP eksternal
Endpoint REST API target eksternal atau URL layanan yang diatur sebagai endpoint
Keahlian Keterampilan mandiri Anda sendiri yang dibuat oleh organisasi Anda

Langkah berikutnya