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. Project tata kelola Agent Registry memungkinkan Anda menemukan workload yang didukung yang di-deploy dalam project tersebut secara otomatis dan mendaftarkan komponen jarak jauh yang dihosting di project Google Cloud , lingkungan lokal, atau cloud eksternal terpisah secara manual.

Sebelum memulai

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

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 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. 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

Konsol

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

Aktifkan Agent Registry API di project Anda dengan perintah gcloud services enable:

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

Ganti PROJECT_ID dengan project ID 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 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.

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