Mengelola binding

Di Agent Registry, binding mewakili 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 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 tempat orkestrator utama mendelegasikan tugas ke sub-agen atau alat khusus.
  • Izin yang didelegasikan: Anda dapat mengaitkan agen dengan penyedia autentikasi untuk memungkinkan agen Anda terhubung ke target eksternal atau alat kustom menggunakan kredensialnya sendiri atau atas nama pengguna perorangan. Binding ini diperlukan jika agen Anda perlu melakukan autentikasi 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. 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 dapat mengelola binding, selesaikan hal berikut:

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

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengelola binding di Agent Registry, minta administrator Anda 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 

gcloud 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:

Terraform

Untuk membuat binding antara agen sumber dan resource target, konfigurasi resource google_agent_registry_binding. Binding memerlukan blok target:

resource "google_agent_registry_binding" "agent_binding" {
  location     = "REGION"
  binding_id   = "BINDING_NAME"
  display_name = "DISPLAY_NAME"
  description  = "Connects a source agent to a target resource."

  source {
    identifier = "urn:agent:my-publisher:my-namespace:SOURCE_AGENT_NAME"
  }

  target {
    identifier = "urn:mcp:my-publisher:my-namespace:TARGET_RESOURCE_NAME"
  }
}

Ganti kode berikut:

  • REGION: Region registry.
  • BINDING_NAME: Nama unik yang ingin Anda berikan ke binding.
  • DISPLAY_NAME: Nama binding yang dapat dibaca manusia.
  • SOURCE_AGENT_NAME: Nama agen sumber.
  • TARGET_RESOURCE_NAME: Nama resource target, seperti server atau endpoint 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 dengan pengelola autentikasi Agent Identityterlebih dahulu. Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi ke alat dan resource.

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

gcloud 

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

Terraform

Untuk mengonfigurasi binding penyedia autentikasi di Terraform, tentukan blok auth_provider_binding dengan jalur resource lengkap penyedia autentikasi konektor Anda, beserta cakupan dan URI lanjutannya:

resource "google_agent_registry_binding" "auth_binding" {
  location     = "REGION"
  binding_id   = "BINDING_NAME"
  display_name = "DISPLAY_NAME"

  source {
    identifier = "urn:agent:my-publisher:my-namespace:SOURCE_AGENT_NAME"
  }

  target {
    identifier = "urn:mcp:my-publisher:my-namespace:TARGET_RESOURCE_NAME"
  }

  auth_provider_binding {
    auth_provider = "projects/PROJECT_ID/locations/REGION/connectors/AUTH_PROVIDER_ID"
    scopes        = [SCOPES]
    continue_uri  = "CONTINUE_URI"
  }
}

Ganti kode berikut:

  • REGION: Region registry.
  • BINDING_NAME: Nama unik yang ingin Anda berikan ke binding.
  • DISPLAY_NAME: Nama binding yang dapat dibaca manusia.
  • SOURCE_AGENT_NAME: Nama agen sumber.
  • TARGET_RESOURCE_NAME: Nama resource target, seperti server atau endpoint MCP.
  • PROJECT_ID: Project ID.
  • AUTH_PROVIDER_ID: ID penyedia autentikasi konektor.
  • SCOPES: Daftar cakupan OAuth2 yang dipisahkan koma, misalnya, "https://www.googleapis.com/auth/cloud-platform".
  • CONTINUE_URI: URI lanjutan penyedia autentikasi, misalnya, https://example.com/continue.

Untuk contoh cara menggunakan binding ini dalam kode agen, lihat Menyelesaikan binding dalam kode Agent Development Kit (ADK).

Mencantumkan binding

Cantumkan semua binding di lokasi tertentu:

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

Melihat detail binding

Ambil detail satu binding:

gcloud 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 

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

Terraform

Untuk memperbarui nama tampilan atau deskripsi binding menggunakan Terraform, ubah resource google_agent_registry_binding yang ada dalam konfigurasi Anda, lalu jalankan terraform apply.

Menghapus binding

Untuk menghapus koneksi antar-resource, hapus data binding:

gcloud 

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

Terraform

Hapus resource google_agent_registry_binding yang mewakili binding dari konfigurasi Terraform Anda, lalu jalankan terraform apply.

Langkah berikutnya