Mengelola binding

Di Agent Registry, binding merepresentasikan koneksi antara agen sumber dan resource target, seperti agen lain, server MCP, atau endpoint. Dengan membuat binding, Anda menetapkan hubungan eksplisit yang memungkinkan agen orkestrator Anda berinteraksi dengan kemampuan hilir.

Anda menggunakan binding untuk menangani dua skenario:

  • Koneksi resource: Anda dapat menautkan agen sumber ke resource target, seperti agen lain, server MCP, atau endpoint. Skenario ini memungkinkan Anda memetakan alur kerja multi-agen di mana pengorkestrasi utama mendelegasikan tugas kepada sub-agen atau alat khusus.
  • Izin yang didelegasikan: Anda dapat mengaitkan agen dengan penyedia autentikasi untuk mengizinkan agen Anda terhubung ke target eksternal atau alat kustom menggunakan kredensialnya sendiri atau atas nama pengguna perorangan. Binding ini diperlukan jika agen Anda perlu mengautentikasi ke server atau alat MCP jarak jauh menggunakan token OAuth atau kunci API. Dengan binding, Anda tidak perlu menentukan penyedia autentikasi secara manual dalam kode Anda. Untuk mengetahui petunjuk selengkapnya, lihat Membuat binding penyedia autentikasi dalam dokumen ini.

Dokumen ini menjelaskan cara membuat, melihat, memperbarui, dan menghapus binding di Agent Registry.

Sebelum memulai

Sebelum Anda dapat mengelola binding, selesaikan hal berikut:

  1. Siapkan Agent Registry.
  2. Daftarkan resource sumber dan target. Untuk mengetahui informasi selengkapnya, lihat Mendaftarkan layanan.
  3. Jika Anda ingin mengonfigurasi binding untuk izin yang didelegasikan, buat penyedia otorisasi dengan pengelola otorisasi Identitas Agen. Untuk mengetahui informasi selengkapnya, lihat Mengautentikasi ke alat dan resource.
  4. Untuk menggunakan perintah gcloud CLI dalam dokumen ini, pastikan Anda telah menyiapkan lingkungan Google Cloud CLI.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengelola binding di Agent Registry, minta administrator untuk memberi Anda peran IAM berikut pada project:

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.

Membuat binding

Buat binding untuk menghubungkan agen sumber ke resource target:

gcloud alpha agent-registry bindings create BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --source-identifier="SOURCE_ID" \
  --target-identifier="TARGET_ID"

Ganti kode berikut:

  • BINDING_NAME: Nama yang ingin Anda berikan ke binding, misalnya, my-custom-binding.
  • PROJECT_ID: Project ID.
  • REGION: Region registri.
  • DISPLAY_NAME: Nama yang mudah dibaca yang ingin Anda berikan ke binding, misalnya, My Custom Binding.
  • SOURCE_ID: ID agen sumber dalam format Uniform Resource Name (URN).
  • TARGET_ID: ID resource target dalam format URN, seperti ID server MCP.

Membuat binding penyedia autentikasi

Anda dapat mengaitkan agen dengan penyedia autentikasi untuk izin yang didelegasikan. Sebelum membuat binding ini, Anda harus membuat penyedia autentikasi terlebih dahulu dengan pengelola autentikasi Identitas Agen. Untuk mengetahui informasi selengkapnya, lihat Mengautentikasi ke alat dan resource.

Saat menentukan nama resource --auth-provider, Anda harus menggunakan project ID Anda:

gcloud alpha agent-registry bindings create BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --source-identifier="SOURCE_ID" \
  --auth-provider="projects/PROJECT_ID/locations/REGION/connectors/AUTH_PROVIDER_ID"

Ganti AUTH_PROVIDER_ID dengan ID penyedia autentikasi Anda.

Untuk contoh cara menggunakan binding ini dalam kode agen Anda, lihat Menyelesaikan binding dalam kode ADK Anda.

Mencantumkan pengikatan

Mencantumkan semua binding di lokasi tertentu:

gcloud alpha agent-registry bindings list \
  --project=PROJECT_ID \
  --location=REGION

Melihat detail binding

Mengambil detail satu binding:

gcloud alpha agent-registry bindings describe BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION

Memperbarui binding

Perbarui parameter binding yang ada, seperti nama tampilan atau deskripsinya, menggunakan flag gcloud CLI:

gcloud alpha agent-registry bindings update BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="NEW_DISPLAY_NAME"

Menghapus binding

Untuk menghapus koneksi antar-resource, hapus catatan binding:

gcloud alpha agent-registry bindings delete BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION

Langkah berikutnya