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 alur kerja AI tertentu. Agen memahami kemampuan alur kerjanya dengan memiliki keterampilan tertentu. Di Agent Registry, kemampuan agen ditampilkan sebagai metadata deklaratif (kemampuan A2A) atau sebagai paket yang dapat dieksekusi dan modular (Kemampuan).
  • Server MCP: Penyedia alat dan sumber data terstandarisasi. Alat adalah fungsi deterministik yang diekspos oleh server MCP yang dapat dipanggil oleh 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: Paket petunjuk, kode, dan metadata yang dapat dieksekusi secara mandiri yang dikelola langsung dalam Agent Registry. Keahlian mandiri berbeda dengan keahlian A2A, yang merupakan manifes blok metadata deklaratif yang dideklarasikan secara inline dalam Kartu Agen agen.

Untuk mengetahui informasi selengkapnya tentang hal ini dan konsep lain 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.

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.

Mendaftarkan komponen agentic di registry Anda

Agent Registry mengelola katalog agen dan server MCP Anda melalui dua mekanisme pendaftaran: otomatis dan manual.

Agent Registry secara otomatis mendaftarkan agen dan server yang di-deploy di runtime Google Cloud yang didukung. Daftarkan dan kelola agen, server MCP, dan endpoint Anda dengan mengaktifkan Agent Registry API. Skill buatan Google juga langsung terlihat saat Anda menyiapkan Agent Registry.

Selain itu, Anda dapat menggunakan resource Service untuk membuat, memperbarui, dan menghapus entri secara manual. Kemudian, Anda membuat kueri resource Agent, McpServer, atau Endpoint hanya baca untuk mendapatkan, mencantumkan, dan menelusuri agen, server, dan endpoint terdaftar Anda. Untuk pendaftaran dan penelusuran skill secara manual, gunakan resource Skill.

Mekanisme pendaftaran Deskripsi Komponen terdaftar Produk Google Cloud yang didukung
Pendaftaran otomatis Anda dapat mengonfigurasi dan menggunakan Agent Registry untuk otomatis menemukan dan memasukkan resource tertentu yang di-deploy di runtime Google Cloud yang didukung. Untuk agen yang menerapkan protokol Agent2Agent (A2A) terbuka, registri juga secara otomatis mengekstrak kemampuan dan keahlian A2A mereka dari Kartu Agen mereka. Agen
Server MCP
Keahlian Keterampilan publik Google dapat ditemukan secara global dari semua project
Pendaftaran manual Untuk resource eksternal, komponen agentik kustom pada runtime yang tidak didukung, atau agen REST standar yang tidak menerapkan protokol A2A, Anda harus mendaftarkannya secara manual dengan membuat resource Service di registry. Untuk skill mandiri, Anda menggunakan resource Skill. Agen Agen jarak jauh
Server MCP Komponen agentik kustom pada runtime yang tidak didukung atau server MCP eksternal
Keahlian Keterampilan mandiri Anda sendiri

Langkah berikutnya