Agent Gateway untuk Agent Platform menyediakan tata kelola traffic dan penegakan keamanan yang terkelola sepenuhnya untuk agen AI yang di-deploy di Agent Runtime dan Gemini Enterprise.
Dalam model deployment ini, Google menghosting dan mengelola semua infrastruktur gateway, sehingga Anda dapat menentukan aturan akses, penghentian mTLS, dan batasan keamanan tanpa mengelola infrastruktur hosting gateway.
Jalur akses yang didukung
Jalur akses yang diatur yang tersedia di Agent Gateway di Agent Platform bergantung pada platform runtime agen Anda:
- Agent Runtime: Mendukung mode Client-to-Agent (ingress) dan Agent-to-Anywhere (egress).
- Gemini Enterprise: Hanya mendukung mode Agent-to-Anywhere (egress).
Tabel berikut merangkum kontrol tata kelola yang didukung untuk Gateway Agen untuk setiap jalur akses:
Tabel berikut merangkum peran yang dimainkan oleh setiap komponen tata kelola untuk setiap jalur akses yang diatur:
| Lapisan tata kelola | Klien ke Agen | Agent-to-Anywhere |
|---|---|---|
| Identitas | Identitas klien atau kredensial pengguna yang diteruskan oleh klien ke gateway. | Identitas agen yang terikat workload (ID SPIFFE atau token WIF) yang ditetapkan ke agen. |
| Agent Registry | Tidak berlaku untuk mode Klien ke Agen. | Mendaftarkan resource tujuan target keluar (alat, server MCP, agen). |
| Kebijakan kontrol akses | ||
| IAM Unified Access Policies | Dievaluasi di gateway berdasarkan identitas klien yang masuk dan agen target. | Dievaluasi oleh kebijakan Identity-Aware Proxy (IAP) dan Principal Access Boundary (PAB) berdasarkan identitas dan tujuan agen. |
| Pengaman Model Armor | Memindai perintah klien masuk secara real time untuk mendeteksi injeksi perintah, jailbreak, dan konten berbahaya. | Memeriksa payload alat keluar dan respons agen untuk mencegah kebocoran data sensitif. |
| Kebijakan tata kelola semantik | Mengevaluasi batasan bahasa alami terhadap permintaan klien. | Mengevaluasi batasan bahasa alami terhadap tindakan alat keluar dan delegasi agen. |
Cara Agent Gateway menerapkan kebijakan
Traffic yang melewati Agent Gateway menjalani evaluasi kebijakan tertentu bergantung pada arah traffic. Bagian berikut menguraikan urutan peristiwa untuk permintaan masuk dan keluar yang melewati Agent Gateway.
Penegakan Klien-ke-Agen
Dalam mode Client-to-Agent (hanya didukung untuk agen yang di-deploy di Agent Runtime), permintaan ke agen yang diatur oleh Agent Gateway akan melalui urutan peristiwa berikut:
- Permintaan klien: Klien (seperti CLI, aplikasi web, atau alat developer) mengirimkan permintaan ke agen. Permintaan tersebut dicegat oleh Agent Gateway yang beroperasi dalam mode Client-to-Agent yang bertindak sebagai frontend agen.
- Pemeriksaan permintaan: Agent Gateway mengevaluasi permintaan menggunakan kebijakan otorisasi yang dilampirkan ke gateway.
- Model Armor: Memindai perintah pengguna yang masuk secara real time untuk memblokir serangan injeksi perintah, jailbreak, dan konten berbahaya.
- Kebijakan Tata Kelola Semantik (jika dikonfigurasi, bukan Model Armor): Mengevaluasi batasan bahasa alami terhadap permintaan masuk.
- Penerusan permintaan: Jika semua pemeriksaan lulus, Agent Gateway akan meneruskan permintaan ke tujuan target di Agent Runtime.
Penegakan Agent-to-Anywhere
Saat agen yang berjalan di Agent Runtime atau Gemini Enterprise mengirim panggilan keluar ke alat eksternal, server MCP, atau agen lain, permintaan tersebut akan menjalani urutan peristiwa berikut:
- Permintaan dan intersepsi keluar: Agen (diidentifikasi berdasarkan identitas agen yang ditetapkan) mengirimkan panggilan keluar. Permintaan tersebut dicegat oleh Agent Gateway yang beroperasi dalam mode Agent-to-Anywhere.
- Verifikasi kebijakan IAM, Principal Access Boundary, dan IAP:
IAP memverifikasi bahwa ada kebijakan akses IAM
yang memberikan izin
iap.resources.egressViaIAPkepada identitas agen untuk mengakses tujuan. Kebijakan Principal Access Boundary apa pun yang diterapkan ke identitas agen juga dievaluasi. Identitas agen yang tunduk pada kebijakan Principal Access Boundary hanya memenuhi syarat untuk mengakses resource yang ditentukan dalam kebijakan tersebut, sehingga mengisolasi agen secara ketat ke batas akses yang ditetapkan. - Verifikasi Agent Registry: Agent Gateway memverifikasi bahwa resource tujuan target terdaftar di Agent Registry (atau me-resolve URL endpoint target jika tujuan tidak terdaftar). Sebaiknya daftarkan tujuan di Agent Registry untuk menerapkan kebijakan akses per resource dan kontrol tingkat alat yang terperinci. Jika tujuan tidak terdaftar di Agent Registry, harus ada kebijakan akses IAM eksplisit yang menargetkan URL tujuan. Secara default, jika tidak ada kebijakan akses yang cocok, permintaan akan ditolak.
Pemeriksaan permintaan: Jika pemeriksaan sebelumnya lulus, Agent Gateway akan mengevaluasi permintaan berdasarkan salah satu pagar pembatas keamanan lain yang mungkin telah Anda konfigurasi:
- Model Armor: Memeriksa payload alat dan respons agen untuk mendeteksi injeksi perintah dan kebocoran data sensitif.
- Kebijakan Tata Kelola Semantik: Mengevaluasi batasan bahasa alami (NLC) terhadap pemanggilan alat dan tindakan agen.
- Mendelegasikan otorisasi ke mesin otorisasi kustom: Anda dapat mendelegasikan keputusan otorisasi ke mesin otorisasi kustom menggunakan Service Extensions. Bergantung pada kebijakan otorisasi yang dikonfigurasi, satu atau beberapa mesin otorisasi ini dapat mengizinkan atau menolak permintaan.
Penerusan permintaan: Jika semua pemeriksaan lulus, Agent Gateway akan meneruskan permintaan ke tujuan target.
Men-deploy Agent Gateway di Agent Platform
Untuk men-deploy dan mengonfigurasi Agent Gateway untuk runtime yang dikelola Google, ikuti topik penyiapan umum guna mengonfigurasi infrastruktur gateway dan kebijakan akses, lalu lihat panduan khusus runtime untuk merutekan traffic dari workload agen Anda.
Penyiapan umum dan konfigurasi kebijakan
- Menyiapkan Agent Gateway: Pelajari cara
membuat resource
agentGateways, menetapkan identitas agen, mendaftarkan alat tujuan di Agent Registry, dan melampirkan kebijakan akses. - Menyiapkan Agent Gateway dengan konektivitas VPC: Pelajari cara mengonfigurasi konektivitas VPC pribadi agar Agent Gateway dapat mengirim traffic keluar ke resource di jaringan VPC Anda.
- Mendelegasikan otorisasi: Pelajari cara mengonfigurasi kebijakan dan ekstensi otorisasi untuk mendelegasikan keputusan traffic ke IAP, Model Armor, kebijakan Tata Kelola Semantik, atau mesin Service Extensions kustom.
Pemilihan rute traffic khusus runtime
- Merutekan traffic Runtime melalui Agent Gateway: Pelajari cara mengonfigurasi agen Agent Runtime untuk merutekan traffic masuk (Klien-ke-Agen) dan keluar (Agen-ke-Mana saja) melalui Agent Gateway.
- Merutekan traffic Gemini Enterprise melalui Agent Gateway: Pelajari cara mengonfigurasi aplikasi Gemini Enterprise untuk merutekan traffic melalui Agent Gateway saat terhubung ke alat dan API eksternal.
Batasan
Batasan berikut berlaku untuk Gateway Agen untuk Platform Agen:
- Untuk Gemini Enterprise, mode Client-to-Agent tidak didukung.
- Setiap instance Agent Gateway dapat mengatur hingga 5.000 resource yang terdaftar di Agent Registry.
- Tinjau halaman berikut untuk mempelajari batasan yang terkait dengan deployment dan fitur yang Anda pilih:
Langkah berikutnya
Memecahkan masalah Agent Gateway
Pelajari cara memecahkan masalah konektivitas Agent Gateway.