Agent Gateway memperluas tata kelola Gemini Enterprise Agent Platform ke agen AI yang Anda bangun dan deploy di Cloud Run. Dengan merutekan permintaan keluar dari layanan Cloud Run melalui Gateway Agen yang dikelola sendiri dan didukung oleh Secure Web Proxy, Anda dapat menerapkan kebijakan akses terpadu, memeriksa perintah dan payload alat untuk keamanan konten, serta mengambil log dan trace tanpa mengubah kode aplikasi agen Anda.
Untuk mengetahui petunjuk penyiapan langkah demi langkah yang lengkap, lihat Mengatur agen dengan Agent Gateway dalam dokumentasi Cloud Run.
Manfaat
Penggunaan Agent Gateway dengan Cloud Run memberikan kemampuan berikut untuk workload agen Anda:
- Terapkan aturan akses hak istimewa terendah pada panggilan keluar ke server, alat, dan endpoint eksternal Model Context Protocol (MCP) berdasarkan Identitas Agen kriptografis setiap layanan.
- Lampirkan template Model Armor melalui binding ekstensi Service Extensions untuk memindai perintah dan respons guna mendeteksi injeksi perintah, jailbreak, dan kebocoran data sensitif.
- Rutekan traffic container keluar dengan ambient networking dan Direct VPC egress Cloud Run tanpa membangun logika proxy kustom ke dalam framework agen Anda.
- Tempatkan gateway Anda di project Google Cloud yang sama dengan layanan Cloud Run, atau bagikan gateway pusat ke beberapa project layanan menggunakan VPC Bersama.
- Pantau keputusan kebijakan, pemanggilan alat MCP, dan latensi permintaan di Cloud Logging dan Cloud Trace.
Komponen penting
Deployment Gateway Agen yang dikelola sendiri untuk Cloud Run menggabungkan komponen berikut:
- Jaringan ambient Cloud Run: Menjalankan sidecar Envoy yang dikelola Google bersama container agen Anda untuk memproses koneksi keluar dan meneruskannya melalui mTLS.
- Secure Web Proxy: Berjalan di dalam jaringan Virtual Private Cloud (VPC) Anda sebagai titik penerapan kebijakan keluar, melakukan pemeriksaan TLS, serta mengevaluasi aturan otorisasi dan binding ekstensi.
- Agent Identity dan Agent Registry: Menetapkan identitas SPIFFE yang terikat workload ke agen Cloud Run Anda dan mendaftarkan agen, server MCP, dan alat di inventaris pusat organisasi Anda.
- Identity-Aware Proxy (IAP) dan Identity and Access Management (IAM) Unified Access Policies: Mengevaluasi apakah identitas agen Cloud Run tertentu diizinkan untuk memanggil server MCP, alat, atau endpoint target.
- Binding ekstensi: Mengikat IAP dan Model Armor ke resource Agent Gateway Anda untuk mengevaluasi permintaan dan respons keluar.
Cara kerjanya
Saat Anda men-deploy layanan Cloud Run dengan --ambient-networking,
--vpc-egress=all, --functional-type=agent, dan
--identity-type=agent-identity, Cloud Run akan menyediakan
sidecar Envoy ambien dan menetapkan akun utama Identitas Agen ke
layanan.
Anda membuat kebijakan EgressRouting Network Services API yang mengarahkan traffic keluar
dari layanan Cloud Run ke instance Secure Web Proxy
yang terkait dengan resource Agent Gateway yang Anda kelola sendiri. Sidecar
ambient mengirimkan koneksi keluar melalui traffic keluar VPC Langsung melalui
tunnel CONNECT mTLS yang membawa identitas agen Anda ke Secure Web Proxy.
Secure Web Proxy menghentikan sesi TLS keluar menggunakan certificate
authority dari Certificate Authority Service atau PKI pribadi Anda, mengevaluasi kebijakan
otorisasi ALLOW untuk metode MCP dan endpoint model, serta memanggil
IAP dan Model Armor melalui binding ekstensi
sebelum meneruskan permintaan yang disetujui ke tujuannya.
Region yang didukung
Anda dapat menggunakan Agent Gateway di Cloud Run di region berikut:
europe-west1us-central1
Langkah berikutnya
- Siapkan tata kelola traffic keluar untuk deployment project tunggal atau VPC Bersama di Mengatur agen dengan Gateway Agen.
- Diagnosis error perutean, izin xDS, pemeriksaan TLS, dan kebijakan di Memecahkan Masalah Agent Gateway.
- Pelajari Identitas Agen dan pendaftaran otomatis di Mengonfigurasi fitur Agent Platform untuk Cloud Run.
- Konfigurasikan resource proxy yang mendasarinya di Men-deploy Secure Web Proxy sebagai Gateway Agen.
- Lihat telemetri di seluruh runtime di Memantau traffic Agent Gateway.