Menyiapkan Agent Registry

Untuk mendaftarkan dan menemukan server Model Context Protocol (MCP) dan agen AI Anda di Agent Registry, Anda harus mengaktifkan Agent Registry API di Google Cloud project Anda. Agent Registry beroperasi di tingkat project, sehingga Anda dapat menemukan dan mengelola agen yang di-deploy dalam project tertentu tempat API diaktifkan.

Dokumen ini menjelaskan cara menyiapkan Agent Registry dan mengaktifkan API yang diperlukan.

Sebelum memulai

Untuk menyiapkan Agent Registry, gunakan project yang ada atau buat project baru.

Peran yang diperlukan

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

  • 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 gcloud CLI

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

  1. Di konsol, aktifkan Cloud Shell. Google Cloud

    Aktifkan Cloud Shell

    Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai 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. Instal komponen alpha:

    gcloud components install alpha

  3. Pastikan Google Cloud CLI versi terbaru telah diinstal:

    gcloud components update

Mengaktifkan Agent Registry API

Konsol

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.

Mengaktifkan API

gcloud

Aktifkan Agent Registry API di project Anda:

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

Ganti PROJECT_ID dengan ID project Anda.

Setelah mengaktifkan Agent Registry API, Anda dapat mulai mendaftarkan dan menemukan agen di project ini.

Memberikan izin

Untuk melihat dan mengelola layanan di Agent Registry, Anda harus memberikan izin Identity and Access Management yang sesuai kepada pengguna.

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

  • Agent Registry API Viewer (roles/agentregistry.viewer): Melihat agen, alat, dan atributnya.
  • Agent Registry API Editor (roles/agentregistry.editor): Mengedit akses ke resource Agent Registry.
  • Agent Registry API Admin (roles/agentregistry.admin): Melakukan semua tindakan, termasuk mendaftarkan agen secara manual dan memperbarui metadata.

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

Mengubah project Agent Registry

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

Menonaktifkan Agent Registry API

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

Konsol

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

    Buka Agent Registry API

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

  3. Klik Disable API.

  4. Di dialog konfirmasi, klik Disable.

gcloud 

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

Ganti PROJECT_ID dengan ID project.

Langkah berikutnya