Para centralizar el control de acceso y proteger la conectividad en tus flujos de trabajo de agentes, puedes configurar un recurso de Agent Gateway para administrar el tráfico de entrada o salida.
Antes de configurar una puerta de enlace, revisa los conceptos básicos y los componentes principales en la descripción general de Agent Gateway.
Permisos necesarios
Se requieren los siguientes permisos para crear y administrar Agent Gateways. Puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Permisos necesarios
agentregistry.agents.listagentregistry.endpoints.listagentregistry.mcpServers.listcompute.networkAttachments.createcompute.networkAttachments.deletecompute.networkAttachments.getcompute.networkAttachments.listcompute.networkAttachments.updatecompute.regionOperations.getcompute.regions.listmodelarmor.templates.listnetworksecurity.authzPolicies.createnetworksecurity.authzPolicies.deletenetworksecurity.authzPolicies.getnetworksecurity.authzPolicies.listnetworksecurity.operations.getnetworkservices.agentConnectivityTemplates.createnetworkservices.agentConnectivityTemplates.deletenetworkservices.agentConnectivityTemplates.getnetworkservices.agentConnectivityTemplates.listnetworkservices.agentConnectivityTemplates.updatenetworkservices.agentGateways.createnetworkservices.agentGateways.deletenetworkservices.agentGateways.getnetworkservices.agentGateways.listnetworkservices.agentGateways.updatenetworkservices.agentGateways.usenetworkservices.authzExtensions.createnetworkservices.authzExtensions.deletenetworkservices.authzExtensions.getnetworkservices.authzExtensions.listnetworkservices.authzExtensions.updatenetworkservices.authzExtensions.usenetworkservices.operations.getcertificatemanager.trustconfigs.createcertificatemanager.trustconfigs.getcertificatemanager.trustconfigs.listcertificatemanager.trustconfigs.use
APIs requeridas
Habilita las siguientes APIs mínimas requeridas en el proyecto de Google Cloud en el que implementas Agent Gateway:
- API de Compute Engine (
compute.googleapis.com): Proporciona infraestructura de red principal, subredes, enrutamiento y adjuntos de red de Private Service Connect (PSC). - API de seguridad de redes (
networksecurity.googleapis.com): Crea y aplica políticas de autorización (authzPolicies) para el tráfico de la puerta de enlace. - API de Network Services (
networkservices.googleapis.com): Administra los recursos de Agent Gateway (agentGateways), las plantillas de conectividad (agentConnectivityTemplates) y las extensiones de autorización (authzExtensions). - API de Identity and Access Management (
iam.googleapis.com): Administra las cuentas de servicio y las políticas de acceso unificado (UAP) de IAM para las identidades de los agentes. - API de Identity-Aware Proxy (
iap.googleapis.com): Autentica y verifica el tráfico de agentes, extremos y servidores. - API de Agent Registry (
agentregistry.googleapis.com): Registra y administra agentes, servidores de MCP y endpoints de herramientas regidos por la puerta de enlace.
Para habilitar las APIs mínimas requeridas, ejecuta el siguiente comando:
gcloud services enable \
compute.googleapis.com \
networksecurity.googleapis.com \
networkservices.googleapis.com \
iam.googleapis.com \
iap.googleapis.com \
agentregistry.googleapis.com \
--project=PROJECT_ID
Reemplaza PROJECT_ID por el ID del proyecto en el que implementas
Agent Gateway.
Según las funciones, las herramientas de observabilidad y los Agent Runtimes que uses con Agent Gateway, es posible que también debas habilitar las APIs opcionales:
APIs opcionales por función
- Conectividad de VPC privada y TLS:
- API de Cloud DNS (
dns.googleapis.com): Solo se requiere si configuras la conectividad de VPC con el intercambio de tráfico de Cloud DNS para la resolución de dominios privados. - API de Certificate Manager (
certificatemanager.googleapis.com): Solo es necesaria si configuras anclas de confianza de TLS personalizadas (TrustConfig) cuando te conectas a backends privados que usan ACs privadas o certificados autofirmados.
- API de Cloud DNS (
- Seguridad de la IA y filtrado de contenido:
- API de Model Armor (
modelarmor.googleapis.com): Solo es necesaria si habilitas las barreras de seguridad de Model Armor para inspeccionar y filtrar la inyección de instrucciones, el contenido tóxico y los datos sensibles.
- API de Model Armor (
- Observabilidad y auditoría:
- API de Cloud Logging (
logging.googleapis.com): Captura los registros de acceso de la puerta de enlace, los registros de auditoría de seguridad y los eventos de evaluación de políticas de ejecución de prueba. - API de Cloud Monitoring (
monitoring.googleapis.com): Realiza un seguimiento del estado, la latencia, la capacidad de procesamiento y las tasas de error de la puerta de enlace, y configura alertas operativas. - API de observabilidad (
observability.googleapis.com): Proporciona paneles operativos y de observabilidad unificados para la actividad de agentes y puertas de enlace. - API de Telemetry (
telemetry.googleapis.com): Recopila y transmite telemetría del entorno de ejecución y métricas de rendimiento en todos los componentes de la plataforma. - API de Cloud Trace (
cloudtrace.googleapis.com): Proporciona seguimiento distribuido para inspeccionar solicitudes de varios saltos en agentes y backends.
- API de Cloud Logging (
- Agent Runtimes y gobernanza semántica:
- API de Agent Platform (
aiplatform.googleapis.com): Se requiere en proyectos que alojan agentes de Agent Runtime o usan políticas de gobernanza semánticas. - API de Discovery Engine (
discoveryengine.googleapis.com): Es obligatoria en los proyectos que alojan apps y agentes de Gemini Enterprise. - API de Agent Identity (
agentidentity.googleapis.com): Solo es necesaria si administras credenciales salientes con el administrador de autenticación de Agent Identity o si ves los proveedores de autenticación de Agent Identity en la consola de Google Cloud .
- API de Agent Platform (
Planifica la implementación de Agent Gateway
Usa esta sección para planificar la implementación de Agent Gateway y comprender los requisitos de la arquitectura de administración. Puedes volver a consultar estos pasos a medida que registras destinos nuevos, agregas políticas de control de acceso nuevas o implementas más agentes.
Elige el modo de implementación
Agent Gateway admite dos modos de implementación:
- De cliente a agente (entrada): Protege las comunicaciones de los clientes con tus agentes que se ejecutan en Google Cloud.
- De agente a cualquier lugar (salida): Protege las comunicaciones de tus agentes con destinos externos, APIs públicas y servidores de MCP.
Selecciona el entorno de ejecución, el proyecto y la región de implementación
Agent Gateway administra el tráfico de los agentes que se ejecutan en Gemini Enterprise y Runtime.
Agent Runtime: Agent Gateway admite los modos de agente a cualquier lugar (salida) y de cliente a agente (entrada). En el modo de agente a cualquier lugar, los agentes pueden estar en el mismo proyecto que la puerta de enlace o en uno diferente. En el modo de cliente a agente, los agentes deben estar en el mismo proyecto que la puerta de enlace. En cualquier modo, los agentes deben estar en la misma región que la puerta de enlace.
Gemini Enterprise: Agent Gateway solo admite el modo de agente a cualquier lugar (salida). Con Gemini Enterprise, cada puerta de enlace rige las interacciones de agentes solo dentro del alcance del proyecto y la región en la que se implementa.
Para controlar los agentes en Gemini Enterprise y Runtime, puedes usar una sola instancia de Agent Gateway. Como alternativa, también puedes implementar instancias independientes de Agent Gateway para Gemini Enterprise y Runtime.
Patrones de implementación de muestra
A continuación, se presentan algunos patrones de implementación de ejemplo para que los consideres:
- Administración entre proyectos para agentes de entorno de ejecución
En este patrón de implementación, implementas una Agent Gateway de agente a cualquier lugar (salida) en un proyecto de administración dedicado. Los agentes de entorno de ejecución se implementan en proyectos independientes en la misma región que la puerta de enlace y pueden pertenecer a cualquier carpeta dentro de tu organización.
Para configurar la administración de salida entre proyectos, configura los siguientes recursos:
En el proyecto de administración central, haz lo siguiente:
- Crea el Agent Gateway. Asegúrate de que la puerta de enlace esté asociada con una instancia de Agent Registry.
- Registra agentes de varios proyectos junto con cualquier herramienta, servidor o extremo con el registro de agentes adjunto a la puerta de enlace.
- Otorga permisos de IAM entre proyectos al agente de servicio de entorno de ejecución de cada proyecto en el que se basan los agentes para que los agentes de estos proyectos puedan vincularse a la puerta de enlace en el proyecto de administración. Para ver un ejemplo, consulta Enruta el tráfico de Runtime a través de Agent Gateway.
- Configura políticas de IAP, límites de acceso de las principales y las identidades para cargas de trabajo compatibles con SPIFFE para controlar y proteger el tráfico de salida a los extremos autorizados.
- Crea las plantillas de Model Armor que quieras usar para la salida.
- Si quieres salida a una red de VPC, puedes crear el adjunto de red de PSC, las anclas de confianza de TLS personalizadas (
tlsConfig) para las AC privadas y la configuración de intercambio de tráfico de DNS en el proyecto de administración.
En los proyectos de Agent Runtime, haz lo siguiente:
- Implementa los agentes y vincúlalos a la puerta de enlace central en el proyecto de administración.
Ten en cuenta que la administración entre proyectos solo se admite para el entorno de ejecución con puertas de enlace de agente a cualquier lugar (salida). No se admite Gemini Enterprise.
- Administración compartida para los agentes de Gemini Enterprise y Runtime
En este patrón de implementación, todo el tráfico de las apps de Gemini Enterprise y los agentes de Runtime se enruta a través de una sola Agent Gateway.
A continuación, se muestra un ejemplo de implementación:
- La app de Gemini Enterprise se implementa como un Deployment de
global. - Los agentes de entorno de ejecución se implementan en una sola región
(
us-central1) que corresponde a la implementación de Gemini Enterprise. - El Agent Gateway se implementa en la misma región
(
us-central1). - La instancia de Agent Registry de
us-central1está asociada con la Agent Gateway. Debes registrar tus agentes y destinos en esta instancia de Agent Registry.
- La app de Gemini Enterprise se implementa como un Deployment de
- Administración independiente para los agentes de Gemini Enterprise y Runtime
En este patrón de implementación, cada región tiene una Agent Gateway dedicada para supervisar y controlar el tráfico de los agentes, lo que garantiza el aislamiento regional:
- La app de Gemini Enterprise se implementa en
global,usoeu. - Los agentes de entorno de ejecución se implementan en cada región en la que se necesitan.
- Las instancias de Agent Gateway se implementan en cada región en la que se encuentran los agentes y las apps.
- Debes registrar tus agentes y destinos en la instancia regional de Agent Registry asociada a cada puerta de enlace.
- La app de Gemini Enterprise se implementa en
Configura la identidad del agente
Cada agente regido por Agent Gateway requiere su propia identidad de agente única (un ID de SPIFFE). Debido a que las políticas de acceso de IAM dependen de esta Workload Identity, el tráfico de agentes no identificados se bloquea de forma predeterminada.
Puedes aprovisionar una identidad de agente cuando implementas un agente en Runtime o asignarla a cargas de trabajo de agentes existentes. Para obtener instrucciones detalladas, consulta Usa la identidad del agente con el entorno de ejecución.
Registra tus agentes y recursos de destino
Para habilitar la comunicación segura, debes identificar tu instancia de Agent Registry y registrar los recursos que controla tu puerta de enlace.
Identifica la instancia regional del Registro de agentes que usarás. Cada Agent Gateway se asocia con un solo registro regional (
//agentregistry.googleapis.com/projects/PROJECT_ID/locations/REGION) en el mismo proyecto y región en los que se implementa la puerta de enlace:- Agent Runtime: Haz referencia al registro regional en el mismo proyecto y la misma región en la que se implementa Agent Gateway. Registra agentes de varios proyectos en el registro regional del proyecto de administración central que aloja la puerta de enlace.
- Gemini Enterprise: Haz referencia al registro regional en
el mismo proyecto y la misma región que el Agent Gateway
(
us-central1para las apps deglobalyus, oeurope-west1para las apps deeu). Para obtener más detalles, consulta Planifica tus asignaciones de ubicación y de Agent Registry.
Asegúrate de que la instancia de registro regional que asocies con tu Agent Gateway sea aquella en la que estén registrados tus agentes, endpoints y servidores de MCP.
Registra tus agentes en Agent Registry. Si aún no creaste el agente, debes completar este paso más adelante. Para obtener instrucciones, consulta Registra agentes.
Recomendado: Identifica y registra todas las herramientas, los servidores de MCP y los endpoints de API que llamarán tus agentes (incluidas las APIs de plataforma esenciales). El acceso del agente a los destinos siempre requiere una política de acceso de IAM que otorgue el permiso
iap.resources.egressViaIAPa la identidad del agente. Te recomendamos registrar los recursos en el Registro de agentes para que puedas aplicar políticas detalladas por recurso y controles a nivel de las herramientas. En el caso de los destinos que no están registrados, debes otorgar este permiso al agente configurando políticas para extremos no registrados.Los destinos en un proyecto diferente al de la puerta de enlace deben registrarse en el Agent Registry del proyecto de la puerta de enlace. Estos destinos solo son válidos para los agentes de entorno de ejecución en el modo de agente a cualquier lugar.
Para obtener instrucciones, consulta las siguientes guías:
Configura las políticas de control de acceso
Cada Agent Gateway de agente a cualquier lugar requiere una
política de autorización adjunta (AuthzPolicy). Sin una política de autorización
adjunta, una Agent Gateway de agente a cualquier lugar adopta una política de denegación predeterminada
y bloquea todo el tráfico saliente.
Las implementaciones de Agent Gateway de cliente a agente no adoptan una
política de denegación predeterminada. Para estas puertas de enlace, adjuntar una política de autorización de CONTENT_AUTHZ,
como Model Armor o una política de gobernanza semántica, es opcional, y las solicitudes entrantes pasan si no se adjunta
ninguna política de autorización.
- IAM (solo en el modo del agente a cualquier lugar)
Configura una política de IAM que asigne el permiso
iap.resources.egressViaIAPa la principal de identidad de tu agente para cada uno de los recursos de destino que registraste en Agent Registry.Ten en cuenta que Agent Gateway bloquea todo el tráfico saliente, a menos que una política de acceso de IAM autorice de forma explícita el acceso del agente a los recursos de destino otorgando el permiso
iap.resources.egressViaIAPa la identidad del agente.Se recomienda registrar los destinos en el registro de agentes, ya que te permite definir el alcance de las políticas para recursos específicos y aplicar controles detallados de las herramientas. Si los destinos no están registrados en Agent Registry, debes otorgar el permiso
iap.resources.egressViaIAPal agente configurando una política para los extremos no registrados.Asegúrate de que cualquier vinculación de todo el registro coincida con la instancia regional de Agent Registry configurada para tu Agent Gateway.
Para obtener instrucciones, consulta Crea políticas de agentes de IAM.
Para validar tu configuración sin bloquear el tráfico, te recomendamos que implementes IAP en el modo de ejecución de prueba inicialmente.
- Model Armor
(Opcional) Si tu implementación requiere protección contra ataques de inyección de instrucciones, jailbreaks, contenido tóxico o filtración de datos sensibles, debes planificar la integración de la barrera de seguridad de Model Armor y crear plantillas con los filtros de seguridad que necesites.
Para obtener más información, consulta los siguientes documentos:
- Políticas de gobernanza semánticas
(Opcional) Puedes agregar controles contextuales basados en lenguaje natural en tus agentes para habilitar protecciones contra combinaciones de herramientas tóxicas.
Te recomendamos que comiences por implementar las políticas de gobernanza semánticas en modo de ejecución de prueba para que puedas validar tu configuración sin bloquear el tráfico. Para obtener más información, consulta Configura políticas de gobernanza semánticas.
- Motores de autorización personalizados
Opcional: Si deseas delegar la autorización a motores de autorización personalizados o sistemas de terceros con extensiones de servicio, debes asegurarte de que los motores de autorización personalizados estén disponibles cuando implementes la puerta de enlace.
Model Armor, las políticas de administración semántica y cualquier otro motor de autorización personalizado se pueden habilitar durante la configuración inicial de Agent Gateway o adjuntarse después de la implementación como una actualización incremental de la política de seguridad.
Configura Agent Gateway en el modo de agente a cualquier lugar (salida)
Cuando configuras Agent Gateway en el modo de agente a cualquier lugar (salida), puedes configurar cómo el tráfico regulado llega a los extremos y las herramientas de destino. Según tus requisitos de red y seguridad, elige entre las siguientes opciones de implementación:
Salida de Internet: La puerta de enlace enruta de forma segura el tráfico del agente a los extremos y las APIs de acceso público a través de Internet. Para configurar un Agent Gateway con salida de Internet, puedes usar las instrucciones de esta página.
Salida de la red de VPC: La puerta de enlace enruta el tráfico del agente de forma privada a una red de VPC con adjuntos de red de Private Service Connect. Puedes elegir enrutar todo el tráfico a través de la red de VPC (
ALL_TRAFFIC) o solo el tráfico destinado a rangos de direcciones IP privadas (PRIVATE_RANGES_ONLY).Para configurar un Agent Gateway con salida de VPC, debes seguir las instrucciones que se indican en Configura la conectividad de VPC para Agent Gateway.
Sigue estos pasos para crear un recurso de Agent Gateway para las comunicaciones de agente a cualquier lugar.
Consola de Google Cloud
- En la consola de Google Cloud , ve a la página Agent Gateway.
- Haz clic en Agregar puerta de enlace.
- Ingresa un Nombre.
- En la lista Región, selecciona una región.
- En Modo de implementación, verifica que esté seleccionada la opción Administrado por Google.
- En Registros de agentes, selecciona el registro regional que coincida con la región de tu Agent Gateway. Para obtener orientación, consulta Planifica tu implementación de Agent Gateway.
- En la lista Ruta de acceso administrada, selecciona De agente a cualquier lugar (salida del agente).
En la sección Autorización de acceso, elige cómo IAP controla el tráfico:
- Para implementar la puerta de enlace en un modo de ejecución de prueba en el que la puerta de enlace permita todo
el tráfico y solo genere registros de auditoría,
selecciona Solo auditoría (que establece
iamEnforcementMode: "DRY_RUN"en la extensión de autorización). IAP no aplica tus políticas de IAM en el modo de ejecución de prueba. Una vez que tengas confianza, puedes inhabilitar el modo de ejecución de prueba para aplicar las políticas de IAM. - Para bloquear las solicitudes que no tienen una política de IAM
Allowexplícita, selecciona Aplicar políticas (que escribeiamEnforcementMode: "ENFORCED"en la extensión de autorización cuando se crea una puerta de enlace o quitaiamEnforcementModecuando se actualiza una puerta de enlace existente). Esta opción se recomienda para entornos de producción. - En Modelo de política, selecciona Política de acceso unificado.
- Para implementar la puerta de enlace en un modo de ejecución de prueba en el que la puerta de enlace permita todo
el tráfico y solo genere registros de auditoría,
selecciona Solo auditoría (que establece
Opcional: En la sección Seguridad de la IA, configura la seguridad adicional:
- Para proteger las interacciones de los modelos de IA con Model Armor, activa Habilitar Model Armor.
- Selecciona una plantilla que se aplique a las solicitudes entrantes a la puerta de enlace de la lista.
Para usar una plantilla diferente para las respuestas, desmarca Usar la misma plantilla para solicitudes y respuestas y selecciona una plantilla de la lista.
Haz clic en Agregar puerta de enlace.
gcloud
Las Agent Gateways se definen de forma declarativa con YAML.
Define el recurso y guarda la configuración en un archivo YAML. Para este ejemplo, usamos
my-agent-gateway-egress.yaml.name: AGENT_GATEWAY_NAME protocols: - MCP googleManaged: governedAccessPath: AGENT_TO_ANYWHERE registries: - AGENT_REGISTRY_PATHReemplaza lo siguiente:
AGENT_GATEWAY_NAME: Es el nombre del recurso de Agent Gateway.AGENT_REGISTRY_PATH: Es la ruta de acceso a la instancia regional de Agent Registry en el mismo proyecto y región que la puerta de enlace, con el formato//agentregistry.googleapis.com/projects/PROJECT_ID/locations/LOCATION. Para obtener orientación, consulta Planifica la implementación de Agent Gateway.
Ejecuta el siguiente comando para crear un recurso de Agent Gateway basado en la especificación de YAML:
gcloud network-services agent-gateways import AGENT_GATEWAY_NAME \ --source="my-agent-gateway-egress.yaml" \ --location=LOCATION
Reemplaza
LOCATIONpor la ubicación en la que deseas crear el recurso de Agent Gateway. Por ejemplo,us-central1.Ten en cuenta que, para Gemini Enterprise, debes implementar Agent Gateway en una región que corresponda a la ubicación de tu app. Para conocer las asignaciones de ubicación requeridas, consulta Enruta el tráfico de Gemini Enterprise a través de Agent Gateway.
Crea y adjunta una política de autorización (
AuthzPolicy) para aplicar políticas de administración y control de acceso centralizadas en el tráfico que pasa por el Agent Gateway. Sin una política de autorización adjunta, un Agent Gateway de agente a cualquier lugar adopta una política de denegación predeterminada y bloquea todo el tráfico saliente. En los siguientes pasos, se muestra cómo configurar una política de autorización que use IAP.Configura una extensión de autorización que apunte a IAP. Define la extensión en un archivo YAML, como
iap-request-authz-extension.yaml. Usa los valores de muestra que se proporcionan:cat >iap-request-authz-extension.yaml <<EOF name: AUTHORIZATION_EXTENSION_NAME service: iap.googleapis.com failOpen: false timeout: 1s metadata: iapPolicyVersion: "V2" EOFSi deseas implementar la extensión en un modo de solo auditoría de ejecución de prueba para probar la política de autorización sin aplicarla, puedes especificar el campo
iamEnforcementModedentro del bloquemetadata. Esto te permite verificar tu política y minimizar el riesgo de interrumpir el tráfico debido a errores de configuración:cat >iap-request-authz-extension.yaml <<EOF name: AUTHORIZATION_EXTENSION_NAME service: iap.googleapis.com failOpen: false timeout: 1s metadata: iapPolicyVersion: "V2" iamEnforcementMode: "DRY_RUN" EOFQuita el campo
iamEnforcementMode: "DRY_RUN"del bloquemetadatacuando tengas todo listo para comenzar a aplicar políticas. Para obtener instrucciones sobre cómo auditar los incumplimientos de la ejecución de prueba en los controles antes de habilitar la aplicación de políticas, consulta Audita los incumplimientos de la política de ejecución de prueba en los controles.Importa el archivo de configuración YAML a una extensión de autorización.
gcloud beta service-extensions authz-extensions import AUTHORIZATION_EXTENSION_NAME \ --source=iap-request-authz-extension.yaml \ --location=LOCATION
Reemplaza
AUTHORIZATION_EXTENSION_NAMEpor el nombre de la extensión de autorización, por ejemplo,my-iap-request-authz-ext.Define una política de autorización en un archivo YAML, como
iap-request-authz-policy.yaml, para asociar la extensión con tu puerta de enlace:cat >iap-request-authz-policy.yaml <<EOF name: AUTHORIZATION_POLICY_NAME target: resources: - "projects/PROJECT_ID/locations/LOCATION/agentGateways/AGENT_GATEWAY_NAME" policyProfile: REQUEST_AUTHZ action: CUSTOM customProvider: authzExtension: resources: - "projects/PROJECT_ID/locations/LOCATION/authzExtensions/AUTHORIZATION_EXTENSION_NAME" EOFReemplaza lo siguiente:
AUTHORIZATION_POLICY_NAME: Es el nombre de la política de autorización, por ejemplo,my-iap-request-authz-policy.PROJECT_ID: el ID del proyecto
Importa el archivo de configuración YAML a una política de autorización.
gcloud network-security authz-policies import AUTHORIZATION_POLICY_NAME \ --source=iap-request-authz-policy.yaml \ --location=LOCATION
Opcional: Si deseas configurar las barreras de seguridad de Model Armor para proteger tu implementación contra ataques de inyección de instrucciones y filtraciones de datos sensibles, consulta Delega la autorización a Model Armor.
Terraform
Para aprovisionar una Agent Gateway de agente a cualquier lugar (salida) y
su extensión de autorización y política de IAP asociadas
de forma declarativa en un proyecto de administración central con el proveedor de google,
completa los siguientes pasos.
Crea el recurso
google_network_services_agent_gatewayy asocia tu instancia regional de Agent Registry:resource "google_network_services_agent_gateway" "egress_gateway" { project = "PROJECT_ID" location = "LOCATION" name = "AGENT_GATEWAY_NAME" protocols = ["MCP"] google_managed { governed_access_path = "AGENT_TO_ANYWHERE" } registries = [ "//agentregistry.googleapis.com/projects/PROJECT_ID/locations/LOCATION", ] }Configura la
google_network_services_authz_extensionde IAP y adjúntala a la puerta de enlace con ungoogle_network_security_authz_policy:resource "google_network_services_authz_extension" "iap_request_authz_ext" { project = "PROJECT_ID" location = "LOCATION" name = "my-iap-request-authz-ext" service = "iap.googleapis.com" timeout = "1s" fail_open = false metadata = { iapPolicyVersion = "V2" # Uncomment the following line to deploy in dry-run (audit-only) mode: # iamEnforcementMode = "DRY_RUN" } } resource "google_network_security_authz_policy" "iap_request_authz_policy" { project = "PROJECT_ID" location = "LOCATION" name = "my-iap-request-authz-policy" policy_profile = "REQUEST_AUTHZ" action = "CUSTOM" target { resources = [ google_network_services_agent_gateway.egress_gateway.id ] } custom_provider { authz_extension { resources = [ google_network_services_authz_extension.iap_request_authz_ext.id ] } } }
Después de crear una Agent Gateway, esta funciona como el punto de conexión principal para enrutar el tráfico de los agentes dentro de tu proyecto y la región elegida. Ahora puedes usar este extremo para establecer canales de comunicación seguros, encriptados y autenticados entre los agentes y sus destinos (herramientas, otros agentes o extremos).
Vuelve a revisar la sección Planifica la implementación de Agent Gateway de esta página y asegúrate de que tus agentes estén registrados en Agent Registry y de que se le haya otorgado el permiso
iap.resources.egressViaIAPa tu agente para todos los destinos a los que intenta conectarse. Si tienes problemas de conectividad, consulta Soluciona problemas de conectividad de Agent Gateway.
A continuación, aprende a implementar agentes y enrutar el tráfico a través de Agent Gateway.
Configura Agent Gateway en el modo de cliente a agente (entrada)
En esta sección, se muestra cómo configurar un Agent Gateway para las comunicaciones de cliente a agente.
Sigue estos pasos para crear un recurso de Agent Gateway.
Consola de Google Cloud
- En la consola de Google Cloud , ve a la página Agent Gateway.
- Haz clic en Agregar puerta de enlace.
- Ingresa un Nombre.
- En la lista Región, selecciona una región.
- En Modo de implementación, verifica que esté seleccionada la opción Administrado por Google.
- Deja el parámetro de configuración Registro de agentes como está. El registro no se usa para la entrada.
- En la lista Ruta de acceso administrada, selecciona De cliente a agente (entrada).
Opcional: En la sección Seguridad de la IA, configura la seguridad adicional:
Para proteger las interacciones de los modelos de IA con Model Armor, activa Habilitar Model Armor.
Selecciona una plantilla que se aplique a las solicitudes entrantes a la puerta de enlace de la lista.
Para usar una plantilla diferente para las respuestas, desmarca Usar la misma plantilla para solicitudes y respuestas y selecciona una plantilla de la lista.
Haz clic en Agregar puerta de enlace.
gcloud
Las Agent Gateways se definen de forma declarativa con YAML.
Define el recurso y guarda la configuración en un archivo YAML. Para este ejemplo, usamos
my-agent-gateway-ingress.yaml.name: AGENT_GATEWAY_NAME protocols: - MCP googleManaged: governedAccessPath: CLIENT_TO_AGENTReemplaza AGENT_GATEWAY_NAME por un nombre para el recurso de Agent Gateway.
Ejecuta el siguiente comando para crear un recurso de Agent Gateway basado en la especificación de YAML:
gcloud network-services agent-gateways import AGENT_GATEWAY_NAME \ --source="my-agent-gateway-ingress.yaml" \ --location=LOCATION
Reemplaza
LOCATIONpor la ubicación en la que deseas crear el recurso de Agent Gateway. Por ejemplo,us-central1.
Terraform
Para aprovisionar un recurso de Agent Gateway de cliente a agente (entrada)
de forma declarativa con el proveedor de google, sigue estos pasos:
resource "google_network_services_agent_gateway" "ingress_gateway" {
project = "PROJECT_ID"
location = "LOCATION"
name = "AGENT_GATEWAY_NAME"
protocols = ["MCP"]
google_managed {
governed_access_path = "CLIENT_TO_AGENT"
}
}
Después de crear una Agent Gateway, esta funciona como el punto de conexión principal para enrutar el tráfico a los agentes de tu proyecto y la región elegida.
A continuación, aprende a implementar agentes y enrutar el tráfico a través de Agent Gateway.
Implementar agentes y enrutar el tráfico a través de Agent Gateway
Para implementar un agente de Agent Runtime que enrute el tráfico a través de Agent Gateway, consulta Enruta el tráfico a través de Agent Gateway.
Para implementar un agente de Gemini Enterprise que enrute el tráfico a través de Agent Gateway, consulta Enruta el tráfico de Gemini Enterprise a través de Agent Gateway.
Codelabs
Para ver demostraciones de extremo a extremo sobre cómo configurar y usar Agent Gateway, consulta los siguientes codelabs:
- Administra las cargas de trabajo de agentes con Agent Platform: Aprende a implementar un agente del ADK administrado en Agent Runtime.
- Salida de Agent Gateway desde Agent Runtime hacia los servidores de MCP de Google Cloud: Aprende a configurar Agent Gateway en el modo de agente a cualquier destino para controlar las llamadas de agentes de ADK a un servidor de MCP de Google Cloud.
- Salida de Agent Gateway desde Agent Runtime hacia servidores de MCP externos: Aprende a configurar Agent Gateway en el modo de agente a cualquier lugar para controlar las llamadas de agentes de ADK a servidores de MCP externos.
- Salida de Agent Gateway de Agent Runtime a la red de VPC: Obtén información para configurar Agent Gateway en el modo de agente a cualquier destino para controlar las llamadas de agentes de ADK a destinos en una red de VPC.
- Administración de Agent Gateway para agentes de Agent Runtime entre proyectos: Obtén información sobre cómo configurar Agent Gateway en el modo de agente a cualquier lugar para administrar agentes de Agent Runtime entre proyectos.
- Salida de Private Agent Gateway desde Gemini Enterprise: Aprende a configurar la administración de salida de Private Agent Gateway para Gemini Enterprise.
¿Qué sigue?
Enruta el tráfico de Agent Runtime a través de Agent Gateway
Aprende a enrutar el tráfico de Agent Runtime a través de Agent Gateway para obtener una conectividad segura y administrada.
Delega la autorización para Agent Gateway
Obtén información para delegar la autorización de Agent Gateway a IAP, Model Armor o tu propio servicio de autorización personalizado.
Administra Agent Gateway
Obtén información para ver, actualizar, desasociar y borrar recursos de Agent Gateway.
Soluciona problemas de Agent Gateway
Obtén información para solucionar problemas de conectividad de Agent Gateway.
Enruta el tráfico de Gemini Enterprise a través de Agent Gateway
Obtén información para enrutar el tráfico de Gemini Enterprise a través de Agent Gateway.