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 di satu project atau batas pengelolaan. Memahami cara Agent Registry memisahkan resource Service yang dapat ditulis dari resource penemuan hanya baca, mencakup resource di seluruh project, serta 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.

Model data lintas project

Saat Anda mengonfigurasi batas pengelolaan, Agent Registry memusatkan penemuan dan tata kelola di semua project anggota dari project pengelolaan Anda.

Saat Anda membuat kueri, membuat daftar, atau menelusuri resource dari project pengelolaan, Agent Registry menerapkan aturan cakupan berikut untuk menyediakan katalog gabungan tanpa menduplikasi resource atau membuat tabrakan endpoint:

Kategori fasilitas Cakupan dalam batas pengelolaan Deskripsi
Resource yang ditemukan secara otomatis Digabungkan dari project anggota Agen dan server MCP yang otomatis ditemukan di project anggota akan digabungkan ke dalam tampilan project pengelolaan saat Anda mencantumkan atau menelusurinya di lokasi pada project pengelolaan. Saat melihat, mencantumkan, atau menelusuri agen atau server MCP, Anda dapat menentukan project ID pengelolaan atau project ID anggota dalam permintaan. Nama resource mempertahankan ID yang ditetapkan Agent Registry ke komponen dan menggunakan project yang ditentukan dalam permintaan.
Resource yang didaftarkan secara manual Dicakupkan ke project tempat resource tersebut dibuat Agen kustom, server MCP eksternal, dan endpoint yang didaftarkan secara manual sebagai resource Service dicakupkan ke project tempat agen, server, dan endpoint tersebut dibuat. Buat resource tersebut di project pengelolaan agar dapat dilihat di seluruh batas pengelolaan, atau di project anggota agar hanya dapat dilihat dalam satu project tersebut.
Binding Dicakupkan ke project tempat resource tersebut dibuat Resource Binding dicakupkan ke project tempat resource tersebut dibuat. Buat di project pengelolaan untuk visibilitas seluruh batas, atau di project anggota untuk visibilitas project tunggal.
Skill dan penayang mandiri Dicakupkan ke project tempat resource tersebut dibuat Resource Skill, SkillRevision, dan Publisher mandiri kustom dicakupkan ke project tempat resource tersebut dibuat dan tidak digabungkan dari project anggota ke project pengelolaan. Kemampuan mandiri yang dikelola Google dapat ditemukan di semua project secara otomatis saat Anda menyiapkan Agent Registry.
Aplikasi AI Dicakupkan ke project tempat resource tersebut dibuat Resource AiApplication hanya baca dan tampilan komponen tertautnya dicakupkan ke project dan lokasi tempat aplikasi dibuat.

Produk dan komponen yang didukung

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

Pendaftaran otomatis

Agent Registry otomatis menemukan dan menyerap workloadGoogle Cloud yang didukung yang di-deploy dalam project Anda atau di seluruh project anggota dalam batas pengelolaan Anda. Untuk agen yang menerapkan protokol Agent2Agent (A2A) terbuka, registry akan otomatis mengekstrak keterampilan dan kemampuan A2A mereka dari Kartu Agen mereka. Keterampilan 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

Komponen jarak jauh adalah agen, server MCP, atau endpoint yang dihosting di luar project tata kelola atau batas pengelolaan Anda, seperti di project Google Cloud terpisah tanpa batas, infrastruktur lokal, atau cloud eksternal. Anda mendaftarkan komponen jarak jauh tersebut secara manual di project tata kelola menggunakan resource Service. Anda juga menggunakan resource Service untuk mendaftarkan komponen secara manual pada runtime yang tidak didukung atau untuk agen 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
Endpoints REST API target eksternal atau URL layanan yang diatur sebagai endpoint
Keahlian Keterampilan mandiri Anda sendiri yang dibuat oleh organisasi Anda

Langkah berikutnya