Configura Agent Gateway

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.list
  • agentregistry.endpoints.list
  • agentregistry.mcpServers.list
  • compute.networkAttachments.create
  • compute.networkAttachments.delete
  • compute.networkAttachments.get
  • compute.networkAttachments.list
  • compute.networkAttachments.update
  • compute.regionOperations.get
  • compute.regions.list
  • modelarmor.templates.list
  • networksecurity.authzPolicies.create
  • networksecurity.authzPolicies.delete
  • networksecurity.authzPolicies.get
  • networksecurity.authzPolicies.list
  • networksecurity.operations.get
  • networkservices.agentConnectivityTemplates.create
  • networkservices.agentConnectivityTemplates.delete
  • networkservices.agentConnectivityTemplates.get
  • networkservices.agentConnectivityTemplates.list
  • networkservices.agentConnectivityTemplates.update
  • networkservices.agentGateways.create
  • networkservices.agentGateways.delete
  • networkservices.agentGateways.get
  • networkservices.agentGateways.list
  • networkservices.agentGateways.update
  • networkservices.agentGateways.use
  • networkservices.authzExtensions.create
  • networkservices.authzExtensions.delete
  • networkservices.authzExtensions.get
  • networkservices.authzExtensions.list
  • networkservices.authzExtensions.update
  • networkservices.authzExtensions.use
  • networkservices.operations.get
  • certificatemanager.trustconfigs.create
  • certificatemanager.trustconfigs.get
  • certificatemanager.trustconfigs.list
  • certificatemanager.trustconfigs.use

APIs requeridas

Habilita las siguientes APIs mínimas requeridas en el proyecto de Cloud de Confiance 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 extremos 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 AC privadas o certificados autofirmados.
  • Seguridad de la IA y filtrado de contenido:
    • API de Model Armor (modelarmor.googleapis.com): Solo se requiere si habilitas los lineamientos de Model Armor para inspeccionar y filtrar la inyección de instrucciones, el contenido tóxico y los datos sensibles.
  • 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 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.
  • Agent Runtimes y gobernanza semántica:
    • API de Vertex AI (aiplatform.googleapis.com): Es obligatoria en los 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 Cloud de Confiance .

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 Cloud de Confiance.
  • 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 un 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 deseas 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 del 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).
  • Las instancias de Agent Registry de global y us-central1 se pueden asociar con Agent Gateway. Los agentes y los destinos deben estar registrados en las instancias de Agent Registry asociadas con la puerta de enlace.
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 como una implementación global o multirregional (en global, us o eu).
  • 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 las instancias de Agent Registry asociadas con cada puerta de enlace.

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 el entorno de ejecución 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 administrará tu puerta de enlace.

  1. Identifica las instancias de Agent Registry que usarás. Una Agent Gateway se puede asociar con hasta dos registros (un registro global y un registro regional o multirregional):

    • Los agentes de Agent Runtime son recursos regionales y, por lo general, se registran en registros regionales que coinciden con su región de implementación. Ten en cuenta que los agentes entre proyectos deben registrarse en el registro asociado con el proyecto de administración central en el que se implementa Agent Gateway.
    • Los agentes de Gemini Enterprise son recursos globales o multirregionales y se registran en registros globales o multirregionales (como global, us o eu).

    Asegúrate de que las instancias de registro que asocies con tu Agent Gateway sean aquellas en las que estén registrados tus agentes, endpoints y servidores.

  2. 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.

  3. Recomendación: 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.egressViaIAP a la identidad del agente. Te recomendamos registrar los recursos en Agent Registry para que puedas aplicar políticas detalladas por recurso y controles a nivel de la herramienta. 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 Registro de agentes 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 requiere una política de autorización asociada.

IAM (solo en el modo de agente a cualquier lugar)

Configura una política de IAM que asigne el permiso iap.resources.egressViaIAP a la principal de identidad de tu agente para cada uno de los recursos de destino que registraste en Agent Registry.

De forma predeterminada, Agent Gateway bloquea todo el tráfico, 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.egressViaIAP a 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.egressViaIAP al agente configurando una política para los extremos no registrados.

Debido a que los registros pueden ser globales, multirregionales o regionales, asegúrate de que cualquier vinculación de todo el registro coincida con la instancia (o instancias) de registro 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ántica

(Opcional) Puedes agregar controles adaptables al contexto basados en lenguaje natural en tus agentes para habilitar protecciones contra combinaciones tóxicas de herramientas.

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 una 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 Cloud de Confiance

  1. En la consola de Cloud de Confiance , ve a la página Agent Gateway.

    Ir a Puertas de enlace

  2. Haz clic en Agregar puerta de enlace.
  3. Ingresa un Nombre.
  4. En la lista Región, selecciona una región.
  5. En Modo de implementación, verifica que esté seleccionada la opción Administrado por Google.
  6. En Registros de agentes, selecciona al menos un registro de la lista. Si quieres seleccionar dos registros, uno debe ser global y el otro puede ser regional o multirregional.Para obtener orientación sobre qué registro elegir para tu implementación, consulta Planifica tu implementación de Agent Gateway.
  7. En la lista Ruta de acceso administrada, selecciona De agente a cualquier lugar (salida del agente).

  8. 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. 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 Allow explícita, selecciona Aplicar políticas. Esta opción se recomienda para entornos de producción.
    • En Modelo de política, selecciona Política de acceso unificado.

  9. Opcional: En la sección Seguridad de la IA, configura la seguridad adicional:

    1. Para proteger las interacciones del modelo de IA con Model Armor, activa Habilitar Model Armor.
    2. Selecciona una plantilla que se aplique a las solicitudes entrantes a la puerta de enlace de la lista.

    3. Para usar una plantilla diferente para las respuestas, desmarca Usar la misma plantilla para solicitudes y respuestas y selecciona una plantilla de la lista.

  10. Haz clic en Agregar puerta de enlace.

gcloud

Las Agent Gateways se definen de forma declarativa con YAML.

  1. 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_URI_1
  - OPTIONAL_AGENT_REGISTRY_URI_2

    Reemplaza lo siguiente:

    • AGENT_GATEWAY_NAME: Es el nombre del recurso de Agent Gateway.

    • AGENT_REGISTRY_URI_1 y OPTIONAL_AGENT_REGISTRY_URI_2: Son las rutas de acceso a las instancias de Agent Registry que se asociarán con la puerta de enlace. Puedes configurar hasta dos registros para una Agent Gateway. Cuando configuras dos registros, uno debe ser un registro global y el otro puede ser regional o multirregional. Para obtener orientación sobre qué registro elegir para tu implementación, consulta Planifica tu implementación de Agent Gateway. Las rutas de acceso del registro deben tener el siguiente formato:

      • Registros regionales: //agentregistry.googleapis.com/projects/PROJECT_ID/locations/REGION
      • Registros globales: //agentregistry.googleapis.com/projects/PROJECT_ID/locations/global
      • Registros multirregionales: //agentregistry.googleapis.com/projects/PROJECT_ID/locations/MULTI_REGION

  2. Ejecuta el siguiente comando para crear un recurso de Agent Gateway basado en la especificación YAML:

    gcloud network-services agent-gateways import AGENT_GATEWAY_NAME \
 --source="my-agent-gateway-egress.yaml" \
 --location=LOCATION

    Reemplaza LOCATION por 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 tu configuración multirregional. Para conocer las asignaciones de ubicaciones admitidas, consulta Enruta el tráfico de Gemini Enterprise a través de Agent Gateway.

  3. Crea una política de autorización para aplicar políticas de control de acceso y administración centralizadas en el tráfico que pasa por el Agent Gateway. En los siguientes pasos, se muestra cómo configurar una política de autorización que use IAP.

    1. 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"
EOF

      Si deseas implementar la extensión en un modo de ejecución de prueba solo de auditoría para probar la política de autorización sin aplicarla, puedes especificar el campo iamEnforcementMode dentro del bloque metadata. 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"
EOF

      Quita el campo iamEnforcementMode: "DRY_RUN" del bloque metadata cuando tengas todo listo para comenzar a aplicar las políticas.

    2. 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_NAME por el nombre de la extensión de autorización, por ejemplo, my-iap-request-authz-ext.

    3. 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"
EOF

      Reemplaza 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

    4. 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

  4. 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 de forma declarativa una Agent Gateway de agente a cualquier lugar (salida) y su extensión y política de autorización de IAP asociadas en un proyecto de administración central con el proveedor de google, haz lo siguiente:

  1. Crea el recurso google_network_services_agent_gateway y asocia tus instancias regionales o globales 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",
  ]
}

  2. Configura el google_network_services_authz_extension de IAP y adjúntalo a la puerta de enlace con un google_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
      ]
    }
  }
}

  1. 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.egressViaIAP a 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, obtén información para 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 Cloud de Confiance

  1. En la consola de Cloud de Confiance , ve a la página Agent Gateway.

    Ir a Puertas de enlace

  2. Haz clic en Agregar puerta de enlace.
  3. Ingresa un Nombre.
  4. En la lista Región, selecciona una región.
  5. En Modo de implementación, verifica que esté seleccionada la opción Administrado por Google.
  6. Deja la configuración del Registro de agentes como está. El registro no se usa para la entrada.
  7. En la lista Ruta de acceso administrada, selecciona De cliente a agente (entrada).

  8. Opcional: En la sección Seguridad de la IA, configura la seguridad adicional:

    1. Para proteger las interacciones del modelo de IA con Model Armor, activa Habilitar Model Armor.

    2. Selecciona una plantilla que se aplique a las solicitudes entrantes a la puerta de enlace de la lista.

    3. Para usar una plantilla diferente para las respuestas, desmarca Usar la misma plantilla para solicitudes y respuestas y selecciona una plantilla de la lista.

  9. Haz clic en Agregar puerta de enlace.

gcloud

Las Agent Gateways se definen de forma declarativa con YAML.

  1. 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_AGENT

    Reemplaza AGENT_GATEWAY_NAME por un nombre para el recurso de Agent Gateway.

  2. 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 LOCATION por 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 un Agent Gateway, este sirve 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.

Implementa agentes y enruta 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:

¿Qué sigue?

Guía

Aprende a enrutar el tráfico de Agent Runtime a través de Agent Gateway para obtener una conectividad segura y administrada.

Guía

Obtén información para delegar la autorización de Agent Gateway a IAP, Model Armor o tu propio servicio de autorización personalizado.

Guía

Obtén información para supervisar Agent Gateway.

Solución de problemas

Obtén información para solucionar problemas de conectividad de Agent Gateway.

Guía

Aprender a enrutar el tráfico de Gemini Enterprise a través de Agent Gateway