Menyiapkan Agent Registry

Untuk mendaftarkan dan menemukan agen AI, server Model Context Protocol (MCP), kemampuan mandiri, dan endpoint di Agent Registry, Anda harus mengaktifkan Agent Registry API di project Google Cloud Anda. Project tempat Anda mengaktifkan Agent Registry berfungsi sebagai project tata kelola Anda.

Anda dapat menyiapkan Agent Registry dalam satu project tata kelola atau di beberapa project dengan mengonfigurasi batas pengelolaan tempat project pengelolaan pusat berfungsi sebagai project tata kelola Anda.

Sebelum memulai

Konfigurasikan Agent Registry dalam satu project atau di beberapa project:

• Project tunggal: menemukan dan mengelola agen, server MCP, keahlian, dan endpoint dalam satu project tata kelola Google Cloud . Gunakan project yang sudah ada atau buat project, aktifkan Agent Registry API, dan berikan izin.
• Beberapa project (batas pengelolaan): memusatkan penemuan dan tata kelola di beberapa project anggota dalam hierarki resource Google Cloud dengan mengaitkan batas pengelolaan dengan project pengelolaan. Tentukan project Google Cloud yang ada sebagai project pengelolaan Anda atau biarkan Resource Manager membuatnya untuk Anda, aktifkan Resource Manager API, konfigurasikan batas pengelolaan, dan berikan izin.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk menyiapkan Agent Registry, minta administrator untuk memberi Anda peran IAM berikut di project Google Cloud Anda:

• Mengaktifkan Agent Registry API: Service Usage Admin (roles/serviceusage.serviceUsageAdmin)
• Memberikan peran untuk menggunakan Agent Registry API: Project IAM Admin (roles/resourcemanager.projectIamAdmin)
• Mendapatkan akses penuh ke resource Agent Registry API: Agent Registry API Admin (roles/agentregistry.admin)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Menyiapkan lingkungan Google Cloud CLI

Jika Anda berencana menggunakan gcloud CLI untuk Agent Registry, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , aktifkan Cloud Shell.

   Aktifkan Cloud Shell

   Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan terbuka dan menampilkan prompt command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.

2. Update gcloud CLI ke versi terbaru dengan perintah gcloud components update:

   gcloud components update
   

3. Jika Anda berencana menggunakan fitur Pratinjau, instal komponen alpha dengan perintah gcloud components install:

   gcloud components install alpha
   

Mengaktifkan Agent Registry API

• Untuk satu project: aktifkan Agent Registry API di project tata kelola Anda. Setelah mengaktifkan API dan memberikan izin, Anda dapat mulai mendaftarkan dan menemukan agen dalam project tersebut. Anda tidak perlu mengonfigurasi batas pengelolaan.
• Untuk beberapa project (batas pengelolaan): aktifkan Resource Manager API pada project yang Anda gunakan untuk menjalankan perintah konfigurasi. Saat Anda mengonfigurasi batas pengelolaan untuk beberapa project dan membuat konfigurasi kemampuan, Resource Manager akan otomatis mengaktifkan Agent Registry API di project pengelolaan Anda.

Gunakan project ID Anda untuk mengaktifkan API:

Konsol

Untuk satu project, aktifkan Agent Registry API di project Anda:

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

Mengaktifkan API

Untuk beberapa project (batas pengelolaan), aktifkan Resource Manager API di project yang Anda gunakan untuk konfigurasi:

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

Mengaktifkan API

gcloud

• Untuk satu project, aktifkan Agent Registry API di project Anda dengan perintah gcloud services enable:

  gcloud services enable agentregistry.googleapis.com \
      --project=PROJECT_ID
  

• Untuk beberapa project (batas pengelolaan), aktifkan Resource Manager API pada project yang Anda gunakan untuk konfigurasi:

  gcloud services enable cloudresourcemanager.googleapis.com \
      --project=PROJECT_ID
  

Ganti PROJECT_ID dengan project ID project tata kelola mandiri Anda, atau project yang ingin Anda gunakan sebagai project pengelolaan untuk batas pengelolaan Anda.

Catatan: Jika Anda mengintegrasikan Agent Registry dengan Agent Gateway untuk penegakan kebijakan, Anda juga harus mengaktifkan Identity-Aware Proxy API di project Anda. Gateway menggunakan Identity-Aware Proxy API untuk mengautentikasi dan mengizinkan traffic egress dari agen Anda ke tujuan eksternal.

Mengonfigurasi batas pengelolaan untuk beberapa project

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Untuk menggunakan Agent Registry di beberapa project Google Cloud , konfigurasikan batas pengelolaan. Batas pengelolaan mengelompokkan satu atau beberapa project anggota Google Cloud ke dalam project pengelolaan pusat yang berfungsi sebagai project tata kelola Anda sehingga Anda dapat menemukan dan mengatur agen AI, server MCP, dan alat di seluruh project.

Anda menentukan batas pengelolaan di Resource Manager. Untuk mengetahui petunjuk langkah demi langkah, lihat Mengonfigurasi batas pengelolaan dalam dokumentasi Resource Manager.

Untuk ringkasan arsitektur tentang cara kerja resource BoundaryConfig, Boundary, dan CapabilityConfig, lihat Batas lintas project.

Saat Anda membuat resource CapabilityConfig dengan agent-management, Resource Manager akan otomatis mengaktifkan agentregistry.googleapis.com di project pengelolaan. Setelah menetapkan batas pengelolaan:

1. Jika diperlukan untuk operasi lokal dalam setiap project anggota, aktifkan Agent Registry API di project anggota tersebut.
2. Berikan peran dan izin yang diperlukan kepada pengguna dan akun layanan di project pengelolaan.

Saat Anda mencantumkan atau menelusuri agen atau server MCP di suatu lokasi pada project pengelolaan, Agent Registry akan menggabungkan dan menampilkan resource yang ditemukan secara otomatis di lokasi tersebut dari semua project anggota dalam batasan, bersama dengan resource Service terdaftar yang dibuat langsung di lokasi tersebut pada project pengelolaan. Setiap nama resource yang ditampilkan mempertahankan ID komponen dan menggunakan project yang ditentukan dalam permintaan.

Memberikan izin

Untuk melihat dan mengelola resource di Agent Registry, Anda harus memberi pengguna izin Identity and Access Management (IAM) yang sesuai.

Berikan satu atau beberapa peran Agent Registry berikut kepada pengguna Anda:

• Agent Registry API Viewer (roles/agentregistry.viewer): melihat dan menelusuri agen, server MCP, alat, keterampilan mandiri, revisi keterampilan, penerbit, endpoint, dan binding.
• Agent Registry API Editor (roles/agentregistry.editor): melihat dan mengedit resource Agent Registry, termasuk mendaftarkan, memperbarui, dan menghapus agen, server MCP, alat, endpoint, skill mandiri, dan revisi skill.
• Agent Registry API Admin (roles/agentregistry.admin): melakukan semua tindakan pada resource Agent Registry, termasuk mendaftarkan dan mengelola agen, server MCP, alat, endpoint, skill mandiri, revisi skill, binding, dan kebijakan IAM skill.
• Agent Registry User (roles/agentregistry.user): melihat semua resource Agent Registry, serta membuat, memperbarui, dan menghapus skill mandiri dan revisi skill tanpa akses edit ke agen, server MCP, atau endpoint.

Untuk mempelajari cara memberikan peran IAM pada project, lihat Mengelola akses ke project, folder, dan organisasi.

Catatan: Agent Registry dan Agent Gateway memiliki dukungan terbatas untuk Workforce Identity Federation. Jika Anda mengalami error pemuatan atau otorisasi di konsol Google Cloud , akses layanan dengan Akun Google standar yang dikelola melalui Cloud Identity atau Google Workspace.

Mengubah project Agent Registry Anda

Jika Anda ingin mengubah project tempat Anda menggunakan Agent Registry dan menghapus dependensi dari project lama, nonaktifkan Agent Registry API di project lama. Setelah menonaktifkan Agent Registry API di project lama, Anda dapat mengaktifkannya di project lain. Data Anda tidak dimigrasikan, dan Anda harus membuat ulang resource di project baru ini.

Menonaktifkan Agent Registry API

Jika Anda tidak ingin lagi menggunakan Agent Registry, nonaktifkan Agent Registry API di project:

Konsol

1. Di konsol Google Cloud , buka halaman pengelolaan Agent Registry API:

   Buka Agent Registry API

2. Dari pemilih project, pilih project Google Cloud tempat Anda menyiapkan Agent Registry.

3. Klik Disable API.

4. Pada dialog konfirmasi, klik Nonaktifkan.

gcloud

Nonaktifkan Agent Registry API di project Anda dengan perintah gcloud services disable:

gcloud services disable agentregistry.googleapis.com \
    --project=PROJECT_ID

Ganti PROJECT_ID dengan ID project.

Langkah berikutnya

• Pelajari batas lintas project
• Panduan memulai: Mendaftarkan agen
• Mendaftarkan server MCP
• Mendaftarkan keterampilan
• Menelusuri agen, alat, dan keahlian