Agent Gateway estende la governance di Gemini Enterprise Agent Platform agli agenti AI che crei e di cui esegui il deployment su Cloud Run. Se instradi le richieste in uscita dai tuoi servizi Cloud Run tramite un Agent Gateway autogestito supportato da Secure Web Proxy, puoi applicare policy di accesso unificate, ispezionare i prompt e i payload degli strumenti per la sicurezza dei contenuti e acquisire log e tracce senza modificare il codice dell'applicazione dell'agente.
Per istruzioni dettagliate sulla configurazione, consulta Gestisci gli agenti con Agent Gateway nella documentazione di Cloud Run.
Vantaggi
L'utilizzo di Agent Gateway con Cloud Run offre le seguenti funzionalità per i workload degli agenti:
- Applica regole di accesso con privilegio minimo alle chiamate in uscita verso server, strumenti ed endpoint esterni Model Context Protocol (MCP) in base all'identità dell'agente crittografica di ogni servizio.
- Collega i modelli di Model Armor tramite le associazioni delle estensioni di Service Extensions per scansionare prompt e risposte alla ricerca di prompt injection, jailbreak e fughe di dati sensibili.
- Instrada il traffico in uscita dei container con il networking ambientale di Cloud Run e il traffico in uscita VPC diretto senza creare una logica proxy personalizzata nel framework dell'agente.
- Ospita il gateway nello stesso progetto Google Cloud del tuo servizio Cloud Run o condividi un gateway centrale tra più progetti di servizio utilizzando il VPC condiviso.
- Monitora le decisioni relative alle norme, le chiamate degli strumenti MCP e la latenza delle richieste in Cloud Logging e Cloud Trace.
Componenti chiave
Un deployment di Agent Gateway autogestito per Cloud Run combina i seguenti componenti:
- Ambient Networking di Cloud Run: esegue un sidecar Envoy gestito da Google insieme al container dell'agente per intercettare le connessioni in uscita e inoltrarle tramite mTLS.
- Secure Web Proxy: viene eseguito all'interno della rete Virtual Private Cloud (VPC) come punto di applicazione delle policy in uscita, eseguendo l'ispezione TLS e valutando le regole di autorizzazione e le associazioni di estensioni.
- Agent Identity e Agent Registry: assegna un'identità SPIFFE associata al workload al tuo agente Cloud Run e registra agenti, server MCP e strumenti nell'inventario centrale della tua organizzazione.
- Policy di accesso unificato di Identity-Aware Proxy (IAP) e Identity and Access Management (IAM): valutano se un'identità dell'agente Cloud Run specifica è autorizzata a chiamare server, strumenti o endpoint MCP di destinazione.
- Associazioni di estensioni: associa IAP e Model Armor alla risorsa Agent Gateway per valutare le richieste e le risposte in uscita.
Come funziona
Quando esegui il deployment di un servizio Cloud Run con --ambient-networking,
--vpc-egress=all, --functional-type=agent e
--identity-type=agent-identity, Cloud Run esegue il provisioning di un
sidecar Envoy ambientale e assegna un'entità Agent Identity al
servizio.
Crea una policy EgressRouting dell'API Network Services che indirizza il traffico in uscita dal tuo servizio Cloud Run a un'istanza Secure Web Proxy associata alla tua risorsa Agent Gateway autogestita. Il sidecar ambient invia le connessioni in uscita tramite il VPC diretto in uscita attraverso un tunnel mTLS CONNECT che trasporta l'identità dell'agente a Secure Web Proxy.
Secure Web Proxy termina le sessioni TLS in uscita utilizzando un'autorità di certificazione di Certificate Authority Service o della tua PKI privata, valuta le policy di autorizzazione ALLOW per i metodi MCP e gli endpoint del modello e chiama IAP e Model Armor tramite associazioni di estensioni prima di inoltrare le richieste approvate alla loro destinazione.
Aree geografiche supportate
Puoi utilizzare Agent Gateway su Cloud Run nelle seguenti regioni:
europe-west1us-central1
Passaggi successivi
- Configura la governance in uscita per i deployment di un singolo progetto o di un VPC condiviso in Gestisci gli agenti con Agent Gateway.
- Diagnostica gli errori di routing, autorizzazione xDS, ispezione TLS e policy in Risolvi i problemi di Agent Gateway.
- Scopri di più sull'identità dell'agente e sulla registrazione automatica in Configura le funzionalità di Agent Platform per Cloud Run.
- Configura la risorsa proxy sottostante in Esegui il deployment di Secure Web Proxy come Agent Gateway.
- Visualizza la telemetria tra i runtime in Monitora il traffico di Agent Gateway.