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 egress untuk mengontrol traffic ke agen.

Tentang agen A2A dan Agent Registry

Protokol Agent2Agent (A2A) 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, endpoint, dan server MCP A2A.

Agen A2A dalam registry dapat berupa agen kustom yang dibuat oleh Anda dan rekan kerja Anda, serta 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 dibangun di produk Google kami, seperti Google Workspace.

Anda dapat mengaitkan agen di Agent Registry dengan aplikasi Gemini Enterprise Anda agar tersedia untuk pengguna akhir aplikasi.

Konektivitas agen A2A yang didukung

Konektivitas agen A2A didukung melalui Agent Gateway di seluruh konfigurasi perutean dan keamanan berikut:

  • Pemilihan rute jaringan publik: Traffic dirutekan melalui internet publik ke endpoint A2A yang dapat dijangkau secara eksternal, melalui Agent Gateway yang di-deploy dengan atau tanpa template konektivitas (AgentConnectivityTemplate).

  • Perutean jaringan pribadi: Traffic dirutekan melalui jaringan VPC internal ke endpoint A2A pribadi, melalui Agent Gateway yang di-deploy dengan template konektivitas (AgentConnectivityTemplate), antarmuka Private Service Connect (PSC-I), dan peering Cloud DNS.

  • Persyaratan certificate authority (CA): Dalam skenario deployment publik dan pribadi, endpoint agen A2A target harus menggunakan TLS/HTTPS yang didukung oleh certificate authority (CA) tepercaya publik atau pribadi. Endpoint yang menggunakan CA pribadi atau sertifikat yang ditandatangani sendiri memerlukan resource TrustConfig Certificate Manager yang dikonfigurasi dalam template konektivitas (AgentConnectivityTemplate).

Tentang Agent Gateway

Agent Gateway adalah komponen jaringan regional terkelola dari Agent Platform yang bertindak sebagai pengontrol traffic dan titik penegakan kebijakan runtime untuk agen A2A, server MCP, dan endpoint. Solusi ini 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 digunakan untuk 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 region AS harus menggunakan Agent Gateway yang dikonfigurasi dengan Agent Registry regional AS, bukan global.

Untuk aplikasi Gemini Enterprise, penyelarasan regional diterapkan secara ketat melalui proses binding 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 registry) harus diselaraskan 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 us-central1 us-central1
eu europe-west1 europe-west1

Batasan

Batasan berikut berlaku saat Anda mengimpor agen dari Registry Agen:

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

  • Anda hanya dapat menerapkan kebijakan tata kelola ke agen yang berada dalam satu registry 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 penegakan kebijakan Agent Gateway.

Sebelum memulai

Sebelum memulai, pastikan Anda telah menyelesaikan prasyarat berikut:

Mengimpor agen dari Registry Agen ke aplikasi Gemini Enterprise

Dengan mengimpor agen A2A dari Agent Registry ke aplikasi Gemini Enterprise, Anda dapat menyediakan agen tersebut bagi pengguna akhir aplikasi.

Konsol

Untuk mengimpor agen dari Registry Agen 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 Agents.

  4. Klik + Add agent.

  5. Di panel Choose an agent type, temukan Agents from Agent Registry, lalu klik Add.

  6. Telusuri agen yang ingin Anda tambahkan, atau temukan di daftar agen dari Agent Registry yang terkait dengan Agent Gateway Anda. Di kartu agen, klik Tambahkan agen.

  7. Tinjau detail agen, lalu klik Next.

  8. Lakukan salah satu hal berikut:

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

    • Jika tidak, tinjau atau masukkan Provider credentials dan Additional details, lalu klik Finish.

      Kolom Deskripsi
      Client ID ID unik aplikasi OAuth yang Anda daftarkan ke penyedia identitas untuk mewakili Gemini Enterprise.
      Rahasia klien Kunci rahasia yang terkait dengan aplikasi OAuth yang Anda daftarkan ke penyedia identitas untuk mewakili Gemini Enterprise.
      URL Otorisasi URL yang digunakan pengguna untuk mengizinkan Gemini Enterprise 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.
      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 yang dapat dilakukan Gemini Enterprise atas nama pengguna, atau data 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.
      Menggunakan autentikasi Dasar HTTP Pilih opsi ini untuk mengirim client ID dan rahasia klien di header Authorization HTTP menggunakan autentikasi Dasar, bukan di isi permintaan token. Beberapa penyedia OAuth memerlukan metode ini.

  9. Agar agen tersedia bagi pengguna akhir aplikasi, lakukan hal berikut:

    1. Buka tab User permissions untuk agen: Apps > APP_NAME > Agents > AGENT_NAME > User permissions.

    2. Klik Tambahkan pengguna.

    3. Dalam dialog Add user permissions roles to agent, tetapkan peran Agent User ke pengguna, grup, atau semua pengguna.

Menyiapkan dan menerapkan kebijakan tata kelola egress

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

Anda menentukan aturan izin dan penolakan yang membatasi akses agen ke entri tertentu dalam Registry Agen.

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

Langkah berikutnya