Mengimpor agen A2A dari Agent Registry

Sebagai administrator Gemini Enterprise, Anda dapat menambahkan agen A2A dari Agent Registry ke aplikasi Gemini Enterprise.

Anda dapat menerapkan kebijakan kontrol akses ke traffic melalui Agent Gateway. Kebijakan ini memungkinkan Anda menerapkan tata kelola keluar untuk mengontrol traffic ke agen.

Tentang agen A2A dan Agent Registry

Agent2Agent (A2A) Protocol adalah protokol komunikasi terbuka dan bahasa universal untuk agen. Protokol ini memungkinkan agen dari berbagai builder dan platform untuk saling menemukan, berkolaborasi, dan mendelegasikan tugas dengan aman.

Agent Registry adalah katalog terpusat yang dapat dikueri dan berfungsi sebagai satu sumber tepercaya untuk menemukan, melacak, dan mengelola agen A2A, endpoint, dan server MCP.

Agen A2A di registry dapat berupa agen kustom yang dibuat oleh Anda dan rekan kerja Anda, lalu di-deploy di berbagai runtime seperti Agent Runtime di Gemini Enterprise Agent Platform, Cloud Run, atau Google Kubernetes Engine (GKE). Agen ini juga dapat berupa agen yang dibuat di produk Google kami, seperti Google Workspace.

Anda dapat mengaitkan agen di Agent Registry dengan aplikasi Gemini Enterprise untuk menyediakannya bagi pengguna akhir aplikasi.

Tentang Agent Gateway

Agent Gateway adalah komponen jaringan regional terkelola Agent Platform yang bertindak sebagai pengontrol traffic dan titik penegakan kebijakan runtime untuk agen A2A, server MCP, dan endpoint. Agent Gateway mengamankan dan mengatur konektivitas: antara klien dan agen A2A; agen A2A dan alat backend; atau agen A2A dan agen lainnya.

Sebelum dapat mengaitkan agen A2A dengan aplikasi Gemini Enterprise, Anda harus menyiapkan Agent Gateway yang dapat merutekan traffic agen. Lihat Sebelum memulai di bawah.

Batasan regional untuk registry, gateway, dan aplikasi

Untuk memastikan kepatuhan terhadap persyaratan residensi data, resource Agent Registry dan Agent Gateway bersifat spesifik per project dan region.

Agent Gateway harus dikonfigurasi untuk dikaitkan dengan Agent Registry yang berada di region yang kompatibel dengan region operasional aplikasi Gemini Enterprise. Tindakan ini mencegah pelanggaran konvensi residensi data. Misalnya, aplikasi Gemini Enterprise yang dibuat di wilayah AS harus menggunakan Agent Gateway yang dikonfigurasi dengan Agent Registry regional AS, bukan Agent Registry global.

Untuk aplikasi Gemini Enterprise, keselarasan regional diterapkan secara ketat melalui proses pengikatan tertentu:

• Aplikasi Gemini Enterprise hanya boleh terikat ke Agent Gateway yang berada di salah satu region yang diizinkan untuk aplikasi tersebut.

• Agent Gateway yang dipilih harus dikaitkan dengan Agent Registry. Agent Registry ini juga harus berada di region spesifik yang sama dengan Agent Gateway dan aplikasi.

• Artinya, ketiga komponen (aplikasi, gateway, dan registri) harus selaras secara regional. Tabel di bawah memberikan pemetaan wilayah tertentu:

Lokasi aplikasi Gemini Enterprise	Lokasi Agent Gateway	Lokasi Agent Registry
global	us-central1	us-central1, us, atau global
us	us-central1	us-central1 atau us
eu	europe-west1	europe-west1 atau eu

Batasan

Batasan berikut berlaku saat Anda mengimpor agen dari Agent Registry:

• Anda hanya dapat menemukan dan mengimpor agen dari Agent Registry jika registry tersebut dikaitkan dengan Agent Gateway yang disiapkan untuk aplikasi Gemini Enterprise Anda.

• Anda hanya dapat menerapkan kebijakan tata kelola ke agen yang berada dalam satu registri yang terkait dengan Agent Gateway.

• Komunikasi langsung antara agen Gemini Enterprise, atau antara agen Gemini Enterprise dan konektor data Gemini Enterprise (termasuk konektor berbasis MCP seperti server MCP kustom) tidak memicu penerapan kebijakan Agent Gateway.

Sebelum memulai

Sebelum memulai, pastikan Anda telah menyelesaikan prasyarat berikut:

• Anda memiliki peran Admin Gemini Enterprise.

• Anda telah menyiapkan gateway untuk merutekan traffic agen melalui Agent Gateway. Untuk mengetahui informasi selengkapnya, lihat Merutekan traffic Gemini Enterprise melalui Agent Gateway.

Mengimpor agen dari Agent Registry ke aplikasi Gemini Enterprise

Mengimpor agen A2A dari Agent Registry ke aplikasi Gemini Enterprise memungkinkan Anda menyediakan agen tersebut bagi pengguna akhir aplikasi.

Penting: Saat Anda mengonfigurasi, dan mengizinkan Pengguna Akhir Anda mengakses, agen yang diimpor dari Agent Registry, string kueri mereka — yang mungkin ditulis ulang berdasarkan konteks percakapan sebelumnya — dan parameter alat dapat dikirim ke agen (dan ke alat atau server MCP yang dipanggil agen), dan sistem tersebut mungkin dapat menautkan data ini dengan identitas mereka. Data dalam sistem tersebut tunduk pada Persyaratan Layanan dan Kebijakan Privasi penyedia agen.

Konsol

Untuk mengimpor agen dari Agent Registry ke aplikasi Gemini Enterprise, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Klik nama aplikasi yang ingin Anda kaitkan dengan agen A2A.

3. Klik Agen.

4. Klik + Tambahkan agen, lalu klik Tambahkan untuk Agen kustom melalui Agent Runtime.

5. Temukan agen yang ingin Anda tambahkan, lalu klik Tambahkan agen.

6. Tinjau detail agen, lalu klik Berikutnya.

7. Lakukan salah satu hal berikut:

   • Jika agen tersedia secara publik atau jika izin untuk runtime sudah ada, klik Lewati & Selesaikan.

   • Jika tidak, tinjau atau masukkan Kredensial penyedia dan Detail tambahan, lalu klik Selesai.

     Kolom	Deskripsi
     Client ID	ID unik aplikasi OAuth yang Anda daftarkan dengan penyedia identitas Anda untuk merepresentasikan Gemini Enterprise.
     Rahasia klien	Kunci rahasia yang terkait dengan aplikasi OAuth yang Anda daftarkan dengan penyedia identitas untuk merepresentasikan Gemini Enterprise.
     URL otorisasi	URL yang digunakan pengguna untuk memberi otorisasi Gemini Enterprise agar dapat mengakses agen. Misalnya, https://accounts.google.com/o/oauth2/v2/auth?client_id=123...abc.apps.googleusercontent&redirect_uri=https%3A%2F%2Fvertexaisearch.cloud.google.com%2Foauth-redirect&oauth-redirect&include_granted_scopes=true&response_type=code&access_type=offline&prompt=consent. Catatan: Pastikan aplikasi OAuth Anda memiliki URI pengalihan ini: https://vertexaisearch.cloud.google.com/oauth-redirect
     URL Token	Endpoint yang digunakan untuk menukar kode otorisasi dengan token akses. Misalnya, jika agen dihosting oleh Google, URL tokennya adalah https://oauth2.googleapis.com/token.
     Cakupan	Izin yang menentukan tindakan apa yang dapat dilakukan Gemini Enterprise atas nama pengguna, atau data apa yang dapat diaksesnya. Gemini Enterprise meminta cakupan ini selama otorisasi pengguna. Misalnya, https://www.googleapis.com/auth/cloud-platform. Saat Anda menentukan cakupan, pertimbangkan hal berikut: Berikan daftar cakupan yang dipisahkan spasi. Contoh: read write. Pastikan cakupan memadai untuk memungkinkan pengguna login dan menggunakan agen.
     Verifikasi PKCE diaktifkan	Pilih opsi ini jika Proof Key for Code Exchange diperlukan oleh agen.

8. Agar agen tersedia untuk pengguna akhir aplikasi, lakukan hal berikut:

   1. Buka tab Izin pengguna untuk agen: Aplikasi > APP_NAME > Agen > AGENT_NAME > Izin pengguna.

   2. Klik person_addTambahkan pengguna.

   3. Dalam dialog Tambahkan peran izin pengguna ke agen, tetapkan peran Pengguna Agen kepada pengguna, grup, atau semua pengguna.

Menyiapkan dan menerapkan kebijakan tata kelola egress

Dengan Agent Gateway, Anda dapat menilai dan menerapkan kebijakan kontrol semantik dan IAM ke traffic agen keluar. Anda dapat membuat kebijakan keluar terperinci untuk mengelola akses antar-agen bagi agen A2A Anda.

Anda menentukan aturan izinkan dan tolak yang membatasi akses agen ke entri tertentu dalam Agent Registry.

Untuk membuat dan menerapkan aturan tata kelola egress ke agen, lakukan salah satu hal berikut:

• Membuat kebijakan agen IAM

• Mengonfigurasi kebijakan tata kelola semantik

Langkah berikutnya

• Menguji agen