Agent Gateway adalah komponen jaringan dari ekosistem Gemini Enterprise Agent Platform. Agent Gateway mengamankan dan mengatur konektivitas untuk semua interaksi berbasis agen, baik yang terjadi antara pengguna dan agen, agen dan alat, atau antar-agen itu sendiri.
Integrasi dengan ekosistem Agent Platform
Agent Platform menyediakan serangkaian kemampuan lengkap untuk siklus proses pengembangan agen yang lengkap, untuk membantu developer agen dan perusahaan Membangun, Menskalakan, Mengatur, dan Mengoptimalkan aplikasi agen mereka.
Agent Gateway adalah komponen utama Agent Platform, yang bertindak sebagai titik masuk dan keluar jaringan untuk semua interaksi agen. Fitur ini memberi administrator keamanan perusahaan kemampuan untuk menerapkan kebijakan keamanan dan tata kelola bagi agen sebagai bagian dari infrastruktur platform.
Agent Gateway terintegrasi dengan beberapa komponen Agent Platform lainnya untuk memberikan tata kelola yang komprehensif:
- Agent Registry: Library pusat agen dan alat yang disetujui, termasuk server Model Context Protocol (MCP) pihak ketiga. Agent Gateway mencari metadata dari registry untuk menerapkan kebijakan akses terperinci.
- Identitas agen: Persona unik yang dapat dilacak untuk setiap agen yang berinteraksi dengan Google Cloud. Agent Gateway menggunakan identitas ini sebagai prinsipal untuk keputusan otorisasi. Identitas agen diamankan secara default dengan Akses Kontekstual yang menerapkan autentikasi kriptografi end-to-end dengan menggunakan mTLS dan DPoP.
- Managed agent runtimes: Agent Runtime dan Gemini Enterprise secara otomatis merutekan traffic agen melalui Agent Gateway.
- Kebijakan Agent Platform: Agent Gateway menyediakan otorisasi yang didelegasikan untuk kebijakan Agent Platform seperti IAM, kebijakan Tata Kelola Semantik, dan Model Armor yang memungkinkan Anda menerapkan serangkaian kontrol keamanan dan tata kelola agentic yang lengkap.
- Kemampuan Observasi Agen: Agent Gateway menghasilkan telemetri kemampuan observasi untuk semua interaksi agen di lapisan jaringan dan mengekspornya ke Kemampuan Observasi Agen untuk memberi Anda pemahaman yang komprehensif tentang tindakan agen.
Manfaat utama
Agent Gateway menawarkan beberapa manfaat bagi developer AI dan administrator perusahaan, yang menangani kompleksitas pengamanan dan pengelolaan interaksi agen AI dalam skala besar.
Untuk developer AI:
- Inovasi yang disederhanakan: Developer dapat berfokus pada pembuatan agen tanpa mengelola overhead keamanan atau primitif jaringan yang kompleks.
- Mediasi protokol: Developer dapat menggunakan protokol berbasis agen pilihan mereka dengan lancar seperti Model Context Protocol (MCP), Agent-to-Agent(A2A), REST, dan gRPC sambil mematuhi standar keamanan perusahaan.
- Agnostik framework: Fungsi tersedia terlepas dari framework pengembangan atau klien yang digunakan.
- Transportasi dan autentikasi yang aman: Secara otomatis menangani handshake dan penghentian mTLS untuk memastikan konektivitas terenkripsi antara agen dan alat tanpa upaya developer. Terintegrasi dengan Pengelola Autentikasi Identitas Agen Agent Platform untuk menyederhanakan dan mengamankan handshake Oauth 2.0 antara agen dan alat mereka.
Untuk admin perusahaan dan tim keamanan:
- Tata kelola terpusat untuk semua interaksi agen: Konfigurasi dan terapkan kebijakan akses yang konsisten di berbagai runtime agen dan model deployment, sehingga memastikan penerapan izin hak istimewa terendah untuk agen saat runtime.
- Batasan keamanan AI: Melindungi dari risiko baru seperti serangan injeksi perintah Model Context Protocol (MCP) menggunakan layanan terintegrasi seperti Model Armor.
- Kemampuan observasi yang komprehensif: Dapatkan visibilitas mendalam tentang interaksi berbasis agen melalui Cloud Logging dan Cloud Trace, yang memfasilitasi penyelidikan keamanan dan pemantauan performa.
Mode deployment
Agent Gateway adalah abstraksi jaringan yang memungkinkan Anda menentukan aturan untuk komunikasi agen dan menerapkan kebijakan keamanan, perlindungan, dan kontrol akses, tanpa mengharuskan Anda mengelola detail jaringan yang kompleks.
Agent Gateway memfasilitasi dua jalur akses utama yang diatur: interaksi Klien-ke-Agen dan interaksi Agen-ke-Mana Saja.
Klien-ke-Agen (ingress) : Mode ini digunakan untuk mengamankan komunikasi antara klien (seperti Cursor, Claude Code, Gemini CLI) dan agen (dan alat) yang berjalan di Google Cloud. Dalam mode ini, Agent Gateway bertindak sebagai frontend untuk agen Anda dan memungkinkan Anda mengontrol klien mana yang dapat mengakses agen (dan alat) Anda serta kebijakan keamanan mana yang harus diterapkan pada interaksi tersebut.
Agent-to-Anywhere (keluar): Mode ini digunakan untuk mengamankan komunikasi antara agen yang berjalan di Google Cloud dan server, agen, alat, atau API yang berjalan di mana saja. Misalnya, Agent Gateway dapat digunakan untuk menerapkan izin akses dan batas keamanan bagi agen Anda yang perlu berkomunikasi dengan server MCP yang dibuat dan dihosting oleh organisasi Anda sendiri, atau server MCP jarak jauh yang dihosting oleh pihak ketiga.
Komponen deployment Agent Gateway
Untuk mengonfigurasi deployment end-to-end yang menggunakan Agent Gateway, Anda memerlukan resource yang dijelaskan di bagian berikut.
Runtime agen
Agent Gateway memungkinkan Anda mengatur traffic untuk agen dan alat yang berjalan di platform runtime berikut:
Agent Runtime: Agent Gateway mendukung mode Agent-to-Anywhere (keluar) dan Client-to-Agent (masuk).
Gemini Enterprise: Agent Gateway hanya mendukung mode Agent-to-Anywhere (keluar).
Untuk mengetahui detail tentang merencanakan deployment dengan runtime ini, lihat Merencanakan deployment Agent Gateway.
Entri Agent Registry
Agen Anda, dan endpoint, server, atau alat yang ingin Anda hubungkan, semuanya harus terdaftar di Agent Registry.
Untuk mengetahui detail persyaratan Agent Registry dan contoh pola deployment untuk memandu Anda menentukan lokasi Agent Registry untuk setiap jenis runtime, lihat Merencanakan deployment Agent Gateway.
Kebijakan kontrol akses
Saat agen berinteraksi dengan alat atau agen lain melalui Agent Gateway, Anda dapat menerapkan kebijakan kontrol akses terperinci menggunakan kebijakan otorisasi Google Cloud. Kebijakan otorisasi ini terintegrasi dengan beberapa layanan Google Cloud lain untuk memungkinkan Anda melakukan hal berikut:
- Buat kebijakan kontrol akses Anda di satu lokasi terpusat dan delegasikan semua keputusan otorisasi dari berbagai gateway di project Anda menggunakan Identity-Aware Proxy. IAP mengautentikasi agen dan alat dengan menggunakan kebijakan yang ditentukan dalam Identity and Access Management (IAM).
- Mendelegasikan keputusan sanitasi konten AI ke Model Armor. Model Armor memungkinkan Anda memperluas kemampuan Agent Gateway dengan menambahkan perlindungan runtime terhadap risiko seperti serangan injeksi perintah dan kebocoran data sensitif.
- Mendelegasikan kebijakan agen dinamis ke Kebijakan Tata Kelola Semantik Platform Agen, sehingga Anda dapat menetapkan kontrol yang sadar konteks pada eksekusi agen Anda seperti perlindungan terhadap kombinasi alat yang merugikan.
- Mendelegasikan otorisasi ke mesin otorisasi kustom atau sistem pihak ketiga dengan menggunakan Service Extensions.
Perhatikan hal berikut:
- Kebijakan IAM harus dikonfigurasi untuk setiap agen, alat, server MCP, atau endpoint yang harus diatur oleh gateway. Secara default, gateway hanya mengizinkan traffic untuk resource yang telah diberi otorisasi secara eksplisit menggunakan IAM.
- Secara default, akses ke server, agen, atau alat MCP jarak jauh yang belum terdaftar di Agent Registry lokal akan diblokir. Anda dapat memilih untuk mengizinkan akses ke server MCP yang tidak terdaftar dan alat yang tidak terdaftar.
- Anda dapat memberikan dan menolak akses agen atau klien individual ke server dan alat MCP berdasarkan nama alat, dan apakah alat tersebut bersifat hanya baca atau baca-tulis. Izin dapat diberikan di tingkat organisasi, folder, atau project.
Perhatikan bahwa kemampuan kontrol akses berbeda berdasarkan mode deployment. Gunakan tabel berikut untuk melihat kebijakan mana yang dapat digunakan untuk gateway Anda.
| Google Cloud Produk | Agent-to-Anywhere (Egress) | Klien ke Agen (Ingress) |
|---|---|---|
| IAM | Digunakan untuk menentukan kebijakan yang membatasi agen ke alat atau metode tertentu berdasarkan identitas agen (ID SPIFFE). Kebijakan keluar IAM beroperasi secara independen dari Agent Gateway, tetapi diterapkan oleh IAP saat runtime. Untuk mengetahui informasi selengkapnya, lihat Ringkasan kebijakan. |
Kebijakan IAM tidak diterapkan oleh gateway. |
| Identity-Aware Proxy | Berfungsi sebagai lapisan penerapan default untuk Agent Gateway. IAM digunakan untuk memvalidasi identitas agen dan memeriksa izin yang ditetapkan sebelum mengizinkan panggilan ke agen atau alat lain. IAP selalu diaktifkan secara default untuk Agent Gateway, meskipun Anda dapat memilih untuk menjalankannya dalam mode uji coba hanya audit. Untuk mengetahui informasi selengkapnya, lihat Membuat kebijakan agen IAM. Diimplementasikan di Agent Gateway menggunakan kebijakan otorisasi dan Service Extensions. |
IAP tidak didukung selama ingress. |
| Model Armor (Opsional) |
Dapat digunakan untuk memastikan agen tidak membocorkan data sensitif apa pun atau terkena jenis serangan injeksi perintah lainnya. Diimplementasikan di Agent Gateway menggunakan kebijakan otorisasi Service Extensions. |
Dapat digunakan untuk melindungi agen dari serangan injeksi perintah masuk atau konten berbahaya yang dikirim oleh klien. Diimplementasikan di Agent Gateway menggunakan kebijakan otorisasi dan Service Extensions. |
Untuk mempelajari lebih lanjut, lihat halaman berikut:
- Rencanakan deployment Agent Gateway Anda.
- Ringkasan kebijakan otorisasi
- Mendelegasikan otorisasi dengan Service Extensions untuk Agent Gateway
Protokol yang didukung
Agent Gateway mendukung semua traffic berbasis HTTP, termasuk traffic MCP dan A2A. Setidaknya, gateway bertindak sebagai passthrough yang menghentikan dan merutekan traffic masuk dengan aman.
Khusus untuk traffic MCP, Agent Gateway dapat mengurai data permintaan untuk mengekstrak atribut. Dengan demikian, Anda dapat membuat kebijakan otorisasi dengan ketentuan berdasarkan atribut tersebut. Misalnya, Anda dapat membuat kebijakan yang membatasi akses ke alat tertentu. Untuk mengetahui detailnya, lihat Otorisasi berdasarkan atribut MCP.
Batasan
- Untuk Gemini Enterprise, mode Client-to-Agent tidak didukung oleh Agent Gateway.
- Agent Gateway tidak mendukung Kontrol Layanan VPC. Untuk memastikan bahwa agen hanya menggunakan resource Agent Gateway yang Anda setujui, Anda dapat menggunakan batasan kebijakan organisasi kustom untuk membatasi binding agen dan gateway. Untuk mengetahui detailnya, lihat Membatasi Runtime Agen hanya ke Gateway Agen yang disetujui dan Membatasi Gemini Enterprise hanya ke Gateway Agen yang disetujui.
- Agent Gateway tidak mendukung koneksi ke tujuan publik atau pribadi dengan rantai sertifikat yang ditandatangani sendiri. Gunakan sertifikat CA yang dipercaya publik untuk semua tujuan.
- Setiap instance Agent Gateway dapat mengatur hingga 5.000 resource yang terdaftar di Agent Registry.
- Tinjau batasan yang terkait dengan Agent Runtime.
- Tinjau batasan yang terkait dengan kebijakan otorisasi.
Referensi API dan gcloud
Untuk mengetahui detail tentang metode yang tersedia untuk Agent Gateway, lihat topik referensi berikut:
- Referensi gcloud:
gcloud network-services agent-gateways - Referensi API REST: agentGateways
Langkah berikutnya
Codelab: Mengatur beban kerja agentic dengan Agent Platform
Pelajari cara mengelola beban kerja agentic dengan Agent Gateway di Gemini Enterprise Agent Platform.
Partner Agent Gateway
Jelajahi ekosistem penyedia keamanan AI dan identitas yang terintegrasi dengan Agent Gateway.
Memecahkan masalah Agent Gateway
Pelajari cara memecahkan masalah konektivitas Agent Gateway.