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 pengatur 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 pengatur 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-hal berikut:
- Siapkan Agent Registry.
- Daftarkan komponen sumber dan target. Untuk mengetahui informasi selengkapnya, lihat Mendaftarkan komponen agen.
- 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, 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:
-
Membuat, memperbarui, dan menghapus binding:
Agent Registry API Admin (
roles/agentregistry.admin) -
Melihat 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.
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 registry.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 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 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 mengetahui 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 alpha agent-registry bindings list \
--project=PROJECT_ID \
--location=REGION
Melihat detail binding
Ambil 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 data binding:
gcloud alpha agent-registry bindings delete BINDING_NAME \
--project=PROJECT_ID \
--location=REGION
Langkah berikutnya
- Pelajari cara melakukan autentikasi ke alat dan resource menggunakan binding penyedia autentikasi.
- Pelajari cara menyelesaikan endpoint dan membuat pengatur menggunakan ADK.