Menyiapkan Agent Registry

Untuk mendaftarkan dan menemukan agen AI serta server Model Context Protocol (MCP) di Agent Registry, Anda harus mengaktifkan Agent Registry API di project Anda. Google CloudAgent 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 sudah ada atau buat project baru.

Peran yang diperlukan

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

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 Google Cloud , aktifkan Cloud Shell.

    Aktifkan Cloud Shell

    Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan perintah 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 resource di Agent Registry, Anda harus memberikan izin Identity and Access Management yang sesuai kepada pengguna.

Beri pengguna Anda satu atau beberapa peran Agent Registry berikut:

  • Pelihat Agent Registry API (roles/agentregistry.viewer): Melihat agen, alat, dan atributnya.
  • Editor Agent Registry API (roles/agentregistry.editor): Mengedit akses ke resource Agent Registry.
  • Admin Agent Registry API (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 konsol Google Cloud , 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. Pada dialog konfirmasi, klik Nonaktifkan.

gcloud 

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

Ganti PROJECT_ID dengan ID project.

Langkah berikutnya