Di Agent Registry, binding memungkinkan agen orchestrator Anda terhubung ke agen downstream, server MCP, dan endpoint tanpa melakukan hardcoding detail koneksi atau autentikasi dalam kode Anda. Anda dapat membuat, melihat, memperbarui, dan menghapus binding di Agent Registry untuk mengelola koneksi resource dan izin yang didelegasikan.
Sebelum memulai
- Menyiapkan Agent Registry.
Untuk penyiapan project tunggal, dapatkan project ID dari project tata kelola tempat Agent Registry diaktifkan. Jika Anda mengonfigurasi batas pengelolaan untuk beberapa project, gunakan ID project pengelolaan Anda untuk penemuan dan pendaftaran di seluruh batas, atau tentukan ID project anggota untuk operasi project tunggal.
Daftarkan komponen sumber dan target. Untuk mengetahui informasi selengkapnya, lihat Model pendaftaran.
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.
Untuk menggunakan perintah Google Cloud CLI dalam dokumen ini, siapkan lingkungan gcloud CLI Anda.
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 tata kelola tempat Agent Registry diaktifkan:
-
Membuat, memperbarui, dan menghapus binding:
Agent Registry API Admin (
roles/agentregistry.admin) -
Lihat binding:
Agent Registry API Viewer (
roles/agentregistry.viewer)
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.
Skenario binding
Anda dapat menggunakan binding untuk menghubungkan resource dan mendelegasikan izin. Misalnya, Anda dapat menggunakan binding dalam skenario berikut:
- Koneksi resource: menautkan agen sumber ke resource target, seperti agen lain, server MCP, atau endpoint. Skenario ini memungkinkan Anda memetakan alur kerja multi-agen, dengan orchestrator utama mendelegasikan tugas ke subagen atau alat khusus.
- Izin yang didelegasikan: 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 mendetail, lihat Membuat binding penyedia autentikasi dalam dokumen ini.
Anda dapat membuat dan mengelola binding di lokasi regional yang didukung, multi-region yang didukung, atau lokasi global. Untuk mengetahui informasi selengkapnya tentang lokasi yang didukung, lihat Lokasi Agent Registry.
Membuat binding
Buat binding untuk menghubungkan agen sumber ke resource target:
gcloud
Jalankan perintah gcloud agent-registry bindings create:
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:
BINDING_NAME: nama yang ingin Anda berikan ke binding, misalnya,my-custom-binding.PROJECT_ID: project ID.REGION: region registry.DISPLAY_NAME: nama yang dapat dibaca manusia yang ingin Anda berikan ke binding, misalnya,My Custom Binding.SOURCE_ID: ID agen agen sumber dalam format Uniform Resource Name (URN).TARGET_ID: ID registry resource target dalam format URN, seperti ID agen, ID server MCP, atau ID endpoint.
Terraform
Untuk membuat binding antara agen sumber dan resource target, konfigurasikan
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 = "SOURCE_ID"
}
target {
identifier = "TARGET_ID"
}
}
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_ID: ID agen agen sumber dalam format URN.TARGET_ID: ID registry resource target dalam format URN.
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. Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi ke alat dan resource.
Saat menentukan nama resource --auth-provider-binding, Anda harus menggunakan project ID Anda:
gcloud
Jalankan perintah
gcloud agent-registry bindings create
dengan flag --auth-provider-binding:
gcloud agent-registry bindings create BINDING_NAME \
--project=PROJECT_ID \
--location=REGION \
--display-name="DISPLAY_NAME" \
--source-identifier="SOURCE_ID" \
--target-identifier="TARGET_ID" \
--auth-provider-binding="projects/PROJECT_ID/locations/REGION/authProviders/AUTH_PROVIDER_ID"
Ganti kode berikut:
BINDING_NAME: nama unik yang ingin Anda berikan ke binding.PROJECT_ID: project ID.REGION: region registry.DISPLAY_NAME: nama binding yang dapat dibaca manusia.SOURCE_ID: ID agen agen sumber dalam format URN.TARGET_ID: ID registry resource target dalam format URN.AUTH_PROVIDER_ID: ID penyedia autentikasi Anda.
Terraform
Untuk mengonfigurasi binding penyedia autentikasi di Terraform, tentukan
blok auth_provider_binding dengan nama resource penyedia autentikasi 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 = "SOURCE_ID"
}
target {
identifier = "TARGET_ID"
}
auth_provider_binding {
auth_provider = "projects/PROJECT_ID/locations/REGION/authProviders/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_ID: ID agen agen sumber dalam format URN.TARGET_ID: ID registry resource target dalam format URN.PROJECT_ID: project ID.AUTH_PROVIDER_ID: ID penyedia autentikasi.SCOPES: daftar cakupan OAuth 2.0 yang dipisahkan koma, misalnya,"https://www.googleapis.com/auth/cloud-platform".CONTINUE_URI: URI lanjutkan penyedia autentikasi, misalnya,https://example.com/continue.
Untuk contoh cara menggunakan binding ini dalam kode agen Anda, lihat Menyelesaikan binding dalam kode Agent Development Kit (ADK) Anda.
Mencantumkan pengikatan
Cantumkan semua binding di lokasi tertentu dengan menjalankan perintah
gcloud agent-registry bindings list:
gcloud agent-registry bindings list \
--project=PROJECT_ID \
--location=REGION
Ganti kode berikut:
PROJECT_ID: project ID.REGION: region registry.
Melihat detail binding
Ambil detail satu binding dengan menjalankan perintah
gcloud agent-registry bindings describe:
gcloud agent-registry bindings describe BINDING_NAME \
--project=PROJECT_ID \
--location=REGION
Ganti kode berikut:
BINDING_NAME: nama binding.PROJECT_ID: project ID.REGION: region registry.
Memperbarui binding
Perbarui parameter binding yang ada, seperti nama tampilan atau deskripsinya:
gcloud
Jalankan perintah gcloud agent-registry bindings update:
gcloud agent-registry bindings update BINDING_NAME \
--project=PROJECT_ID \
--location=REGION \
--display-name="NEW_DISPLAY_NAME"
Ganti kode berikut:
BINDING_NAME: nama binding yang ingin Anda perbarui.PROJECT_ID: project ID.REGION: region registry.NEW_DISPLAY_NAME: nama baru yang dapat dibaca manusia untuk binding.
Terraform
Untuk memperbarui nama tampilan atau deskripsi binding menggunakan Terraform, ubah resource google_agent_registry_binding yang ada dalam konfigurasi Anda dan jalankan terraform apply.
Menghapus binding
Untuk menghapus koneksi antar-resource, hapus binding:
gcloud
Jalankan perintah gcloud agent-registry bindings delete:
gcloud agent-registry bindings delete BINDING_NAME \
--project=PROJECT_ID \
--location=REGION
Ganti kode berikut:
BINDING_NAME: nama binding yang ingin Anda hapus.PROJECT_ID: project ID.REGION: region registry.
Terraform
Hapus resource google_agent_registry_binding yang mewakili binding
dari konfigurasi Terraform Anda, lalu jalankan terraform apply.
Langkah berikutnya
- Pelajari cara melakukan autentikasi ke alat dan resource menggunakan binding penyedia autentikasi.
- Pelajari cara menyelesaikan endpoint dan membangun orchestrator menggunakan ADK.