Agent Gateway einrichten

Wenn Sie die Zugriffssteuerung und die sichere Verbindung für Ihre agentischen Workflows zentralisieren möchten, können Sie eine Agent Gateway-Ressource einrichten, um eingehenden oder ausgehenden Traffic zu verwalten.

Bevor Sie ein Gateway einrichten, sollten Sie sich die konzeptionellen Grundlagen und Kernkomponenten in der Übersicht über Agent Gateway ansehen.

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Agent-Gateways zu erstellen und zu verwalten. Sie können diese Berechtigungen entweder mit benutzerdefinierten Rollen oder mit anderen vordefinierten Rollen erhalten.

Erforderliche Berechtigungen

  • 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.createPolicyBinding
  • networkservices.agentGateways.delete
  • networkservices.agentGateways.deletePolicyBinding
  • networkservices.agentGateways.get
  • networkservices.agentGateways.list
  • networkservices.agentGateways.searchPolicyBindings
  • networkservices.agentGateways.update
  • networkservices.agentGateways.updatePolicyBinding
  • 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

Erforderliche APIs

Aktivieren Sie die folgenden mindestens erforderlichen APIs im Projekt Google Cloud , in dem Sie Agent Gateway bereitstellen:

  • Compute Engine API (compute.googleapis.com): Stellt die grundlegende Netzwerkinfrastruktur, Subnetze, Routing und Private Service Connect-Netzwerkanhänge (PSC) bereit.
  • Netzwerksicherheits-API (networksecurity.googleapis.com): Erstellt und erzwingt Autorisierungsrichtlinien (authzPolicies) für Gateway-Traffic.
  • Network Services API (networkservices.googleapis.com): Verwaltet Agent Gateway-Ressourcen (agentGateways), Verbindungsvorlagen (agentConnectivityTemplates) und Autorisierungserweiterungen (authzExtensions).
  • Identity and Access Management API (iam.googleapis.com): Verwaltet Dienstkonten und IAM Unified Access Policies (UAPs) für Agent-Identitäten.
  • Identity-Aware Proxy API (iap.googleapis.com): Authentifiziert und verifiziert Agenten-, Endpunkt- und Server-Traffic.
  • Agent Registry API (agentregistry.googleapis.com): Registriert und verwaltet Agenten, MCP-Server und Tool-Endpunkte, die vom Gateway verwaltet werden.

Führen Sie den folgenden Befehl aus, um die mindestens erforderlichen APIs zu aktivieren:

gcloud services enable \
    compute.googleapis.com \
    networksecurity.googleapis.com \
    networkservices.googleapis.com \
    iam.googleapis.com \
    iap.googleapis.com \
    agentregistry.googleapis.com \
    --project=PROJECT_ID

Ersetzen Sie PROJECT_ID durch die Projekt-ID, unter der Sie das Agent-Gateway bereitstellen.

Je nach den Funktionen, Beobachtbarkeitstools und Agent-Laufzeiten, die Sie mit Agent Gateway verwenden, müssen Sie möglicherweise auch optionale APIs aktivieren:

Optionale APIs nach Funktion

  • Private VPC-Konnektivität und TLS:
    • Cloud DNS API (dns.googleapis.com): Nur erforderlich, wenn Sie die VPC-Konnektivität mit Cloud DNS-Peering für die private Domainauflösung konfigurieren.
    • Certificate Manager API (certificatemanager.googleapis.com): Nur erforderlich, wenn Sie benutzerdefinierte TLS-Trust-Anker (TrustConfig) konfigurieren, wenn Sie eine Verbindung zu privaten Back-Ends herstellen, die private Zertifizierungsstellen oder selbst signierte Zertifikate verwenden.
  • KI-Sicherheit und Inhaltsfilterung:
    • Model Armor API (modelarmor.googleapis.com): Nur erforderlich, wenn Sie Model Armor-Schutzmaßnahmen aktivieren, um Prompt Injection, schädliche Inhalte und sensible Daten zu prüfen und zu filtern.
  • Beobachtbarkeit und Prüfung:
    • Cloud Logging API (logging.googleapis.com): Erfasst Gateway-Zugriffslogs, Sicherheitsauditlogs und Ereignisse zur Richtlinienbewertung im Probelauf.
    • Cloud Monitoring API (monitoring.googleapis.com): Verfolgt den Zustand, die Latenz, den Durchsatz und die Fehlerraten des Gateways und konfiguriert betriebliche Benachrichtigungen.
    • Observability API (observability.googleapis.com): Bietet einheitliche Beobachtbarkeits- und operative Dashboards für Agenten- und Gateway-Aktivitäten.
    • Telemetry API (telemetry.googleapis.com): Erfasst und streamt Laufzeit-Telemetriedaten und Leistungsmesswerte über Plattformkomponenten hinweg.
    • Cloud Trace API (cloudtrace.googleapis.com): Bietet verteiltes Tracing, um Multi-Hop-Anfragen über Agents und Backends hinweg zu prüfen.
  • Agent Runtime und semantische Governance:
    • Agent Platform API (aiplatform.googleapis.com): Erforderlich in Projekten, die Agent Runtime-Agenten hosten oder semantische Governance-Richtlinien verwenden.
    • Discovery Engine API (discoveryengine.googleapis.com): Erforderlich in Projekten, die Gemini Enterprise-Anwendungen und -Agenten hosten.
    • Agent Identity API (agentidentity.googleapis.com): Nur erforderlich, wenn Sie ausgehende Anmeldedaten mit dem Agent Identity-Authentifizierungsmanager verwalten oder Agent Identity-Authentifizierungsanbieter in der Google Cloud Console aufrufen.

Bereitstellung des KI-Agenten-Gateways planen

In diesem Abschnitt können Sie die Bereitstellung Ihres Agent-Gateways planen und sich über die Anforderungen an die Governance-Architektur informieren. Sie können diese Schritte wiederholen, wenn Sie neue Ziele registrieren, neue Zugriffssteuerungsrichtlinien hinzufügen oder weitere Agents bereitstellen.

Bereitstellungsmodus auswählen

Agent Gateway unterstützt zwei Bereitstellungsmodi:

  • Client zu Agent (eingehend): Sichert die Kommunikation von Clients zu Ihren Agenten, die auf Google Cloudausgeführt werden.
  • Agent-to-Anywhere (ausgehend): Sichert die Kommunikation von Ihren Agenten zu externen Zielen, öffentlichen APIs und MCP-Servern.

Laufzeit, Projekt und Region für die Bereitstellung auswählen

Agent Gateway steuert den Traffic von KI-Agenten, die in Gemini Enterprise und Runtime ausgeführt werden.

  • Agent Runtime: Agent Gateway unterstützt sowohl den Modus „Agent zu beliebigem Ziel“ (ausgehend) als auch den Modus „Client zu Agent“ (eingehend). Im Modus „Agent-to-Anywhere“ können sich die Agents entweder im selben Projekt wie das Gateway oder in einem anderen Projekt befinden. Im Client-zu-Agent-Modus müssen sich die Agents im selben Projekt wie das Gateway befinden. In beiden Modi müssen sich die Agents in derselben Region wie das Gateway befinden.

  • Gemini Enterprise: Das Agent Gateway unterstützt nur den Modus „Agent zu beliebigem Ziel“ (ausgehend). Bei Gemini Enterprise steuert jedes Gateway agentische Interaktionen nur im Rahmen des Projekts und der Region, in der es bereitgestellt wird.

Sie können eine einzelne Agent Gateway-Instanz verwenden, um Agenten in Gemini Enterprise und Runtime zu verwalten. Alternativ können Sie auch unabhängige Agent Gateway-Instanzen für Gemini Enterprise und Runtime bereitstellen.

Beispielhafte Bereitstellungsmuster

Hier sind einige Beispiel-Bereitstellungsmuster, die Sie in Betracht ziehen können:

Projektübergreifende Governance für Runtime-Agenten

Bei diesem Bereitstellungsmuster stellen Sie ein Agent-to-Anywhere-Agent-Gateway (ausgehend) in einem dedizierten Governance-Projekt bereit. Laufzeit-Agents werden in separaten Projekten in derselben Region wie das Gateway bereitgestellt und können zu einem beliebigen Ordner in Ihrer Organisation gehören.

Wenn Sie die projektübergreifende Governance für ausgehenden Traffic einrichten möchten, konfigurieren Sie die folgenden Ressourcen:

Im zentralen Governance-Projekt:

  • Erstellen Sie das KI-Agenten-Gateway. Achten Sie darauf, dass das Gateway mit einer Agent Registry-Instanz verknüpft ist.
  • Registrieren Sie projektübergreifende KI-Agenten sowie alle Tools, Server oder Endpunkte in der Agent Registry, die mit dem Gateway verbunden ist.
  • Erteilen Sie dem Runtime-Dienst-Agenten jedes Projekts, in dem sich die Agenten befinden, projektübergreifende IAM-Berechtigungen, damit Agenten in diesen Projekten an das Gateway im Governance-Projekt gebunden werden können. Ein Beispiel finden Sie unter Laufzeit-Traffic über das Agent Gateway weiterleiten.
  • Konfigurieren Sie IAP-Richtlinien, Principal Access Boundaries und SPIFFE-kompatible Workload Identity, um ausgehenden Traffic zu autorisierten Endpunkten zu steuern und zu sichern.
  • Erstellen Sie alle Model Armor-Vorlagen, die Sie für die Ausgabe verwenden möchten.
  • Wenn Sie ausgehenden Traffic an ein VPC-Netzwerk senden möchten, können Sie den PSC-Netzwerkanhang, benutzerdefinierte TLS-Trust-Anchor (tlsConfig) für private Zertifizierungsstellen und die DNS-Peering-Konfiguration im Governance-Projekt erstellen.

In den Agent Runtime-Projekten:

  • Stellen Sie die KI-Agenten bereit und binden Sie sie an das zentrale Gateway im Governance-Projekt.

Beachten Sie, dass die projektübergreifende Governance nur für die Laufzeit mit Agent-to-Anywhere-Gateways (ausgehend) unterstützt wird. Gemini Enterprise wird nicht unterstützt.

Gemeinsame Governance für Gemini Enterprise- und Runtime-Agenten

In diesem Bereitstellungsmuster wird der gesamte Traffic von Gemini Enterprise-Apps und Runtime-Agenten über ein einzelnes Agent Gateway weitergeleitet.

Hier ist ein Beispiel für eine Bereitstellung:

  • Die Gemini Enterprise-App wird als global-Bereitstellung bereitgestellt.
  • Laufzeit-KI-Agenten werden in einer einzelnen Region (us-central1) bereitgestellt, die der Gemini Enterprise-Bereitstellung entspricht.
  • Das Agent-Gateway wird in derselben Region (us-central1) bereitgestellt.
  • Die Agent Registry-Instanz us-central1 ist mit dem Agent Gateway verknüpft. Sie müssen Ihre KI-Agenten und Ziele in dieser Agent Registry-Instanz registrieren.
Unabhängige Governance für Gemini Enterprise- und Runtime-Agenten

In diesem Bereitstellungsmuster hat jede Region ein dediziertes Agent Gateway, um den Agenten-Traffic zu überwachen und zu steuern, was für eine regionale Isolation sorgt:

  • Die Gemini Enterprise-App wird in global, us oder eu bereitgestellt.
  • Laufzeit-Agents werden in jeder Region bereitgestellt, in der sie benötigt werden.
  • Agent Gateway-Instanzen werden in jeder Region bereitgestellt, in der sich Agenten und Anwendungen befinden.
  • Sie müssen Ihre Agenten und Ziele in der regionalen Agent Registry-Instanz registrieren, die mit dem jeweiligen Gateway verknüpft ist.

Identität des KI‑Agenten einrichten

Jeder KI-Agent, der von Agent Gateway verwaltet wird, benötigt eine eigene eindeutige Agentenidentität (eine SPIFFE-ID). Da IAM-Zugriffsrichtlinien von dieser Workload Identity abhängen, wird Traffic von nicht identifizierten Agents standardmäßig blockiert.

Sie können eine Agentenidentität bereitstellen, wenn Sie einen Agenten in der Laufzeit bereitstellen oder ihn vorhandenen Agentenarbeitslasten zuweisen. Eine ausführliche Anleitung finden Sie unter Agentenidentität mit Laufzeit verwenden.

KI-Agenten und Zielressourcen registrieren

Um eine sichere Kommunikation zu ermöglichen, müssen Sie Ihre Agent Registry-Instanz identifizieren und die Ressourcen registrieren, die von Ihrem Gateway verwaltet werden.

  1. Identifizieren Sie die regionale Agent Registry-Instanz, die Sie verwenden möchten. Jedes Agent-Gateway ist einer einzelnen regionalen Registry (//agentregistry.googleapis.com/projects/PROJECT_ID/locations/REGION) im selben Projekt und in derselben Region zugeordnet, in der das Gateway bereitgestellt wird:

    • Agent Runtime: Verweisen Sie auf die regionale Registry im selben Projekt und in derselben Region, in der das Agent Gateway bereitgestellt wird. Registrieren Sie projektübergreifende KI-Agenten in der regionalen Registry des zentralen Governance-Projekts, in dem das Gateway gehostet wird.
    • Gemini Enterprise: Verweisen Sie auf die regionale Registry im selben Projekt und in derselben Region wie das Agent-Gateway (us-central1 für global- und us-Anwendungen oder europe-west1 für eu-Anwendungen). Weitere Informationen finden Sie unter Standort- und Agent Registry-Zuordnungen planen.

    Achten Sie darauf, dass die regionale Registry-Instanz, die Sie mit Ihrem Agent Gateway verknüpfen, die Instanz ist, in der Ihre KI-Agenten, Endpunkte und MCP-Server registriert sind.

  2. Registrieren Sie Ihre KI-Agenten in der Agent Registry. Wenn Sie den Agenten noch nicht erstellt haben, müssen Sie diesen Schritt später ausführen. Eine Anleitung finden Sie unter Agents registrieren.

  3. Empfohlen: Identifizieren und registrieren Sie alle Tools, MCP-Server und API-Endpunkte, die Ihre KI-Agenten aufrufen werden (einschließlich wichtiger Plattform-APIs). Für den Zugriff des KI-Agenten auf Ziele ist immer eine IAM-Zugriffsrichtlinie erforderlich, die der KI-Agentenidentität die Berechtigung iap.resources.egressViaIAP gewährt. Wir empfehlen, Ziele in der Agent-Registry zu registrieren, da Sie so Richtlinien auf bestimmte Ressourcen beschränken und detaillierte Tool-Steuerelemente anwenden können. Wenn Ziele nicht in der Agent Registry registriert sind, müssen Sie dem Agent die Berechtigung iap.resources.egressViaIAP erteilen, indem Sie eine Richtlinie für nicht registrierte Endpunkte konfigurieren. Achten Sie darauf, dass alle Registry-weiten Regeln mit der regionalen Agent Registry-Instanz übereinstimmen, die für Ihr Agent Gateway konfiguriert ist.

    Ziele in einem anderen Projekt als dem Gateway müssen in der Agent-Registry im Gateway-Projekt registriert sein. Solche Ziele sind nur für Laufzeit-KI-Agenten im Agent-to-Anywhere-Modus gültig.

    Eine Anleitung finden Sie in den folgenden Leitfäden:

Richtlinien zur Zugriffssteuerung konfigurieren

Für jedes Agent-to-Anywhere-Agent-Gateway ist eine angehängte Autorisierungsrichtlinie (AuthzPolicy) erforderlich. Ohne eine angehängte Autorisierungsrichtlinie übernimmt ein Agent-to-Anywhere-Agent-Gateway eine Standard-Ablehnungsrichtlinie und blockiert den gesamten ausgehenden Traffic.

Bei Client-zu-Agent-Agent-Gateway-Bereitstellungen wird keine Standardrichtlinie für die Ablehnung verwendet. Für diese Gateways ist das Anhängen einer CONTENT_AUTHZ-Autorisierungsrichtlinie, z. B. Model Armor oder eine semantische Governance-Richtlinie, optional. Eingehende Anfragen werden weitergeleitet, wenn keine Autorisierungsrichtlinie angehängt ist.

IAM (nur Agent-to-Anywhere-Modus)

Konfigurieren Sie eine IAM-UAP, die dem Hauptkonto Ihrer KI-Agentenidentität die Berechtigung iap.resources.egressViaIAP für jede der Zielressourcen oder nicht registrierten Endpunkte zuweist, die der KI-Agent aufruft. Das Agent Gateway blockiert den gesamten ausgehenden Traffic, es sei denn, eine IAM-UAP autorisiert den Zugriff des KI-Agenten explizit.

Sie können eine IAM-UAP an einen der folgenden Bereiche binden:

  • Ein Projekt: Alle Agent Gateway-Instanzen im Projekt erzwingen die Richtlinie.
  • Eine Agent Gateway-Instanz: Die Richtlinie wird nur von dieser bestimmten Agent Gateway-Instanz erzwungen.

Wenn Sie Ihre Konfiguration validieren möchten, ohne Traffic zu blockieren, empfehlen wir, IAP zuerst im Probelaufmodus bereitzustellen. Eine Anleitung finden Sie unter IAM-UAPs erstellen.

Model Armor

(Optional) Wenn Ihre Bereitstellung Schutz vor Prompt-Injection-Angriffen, Jailbreaks, toxischen Inhalten oder dem Abfluss sensibler Daten erfordert, sollten Sie die Integration von Model Armor-Sicherheitsmaßnahmen planen und Vorlagen mit den erforderlichen Sicherheitsfiltern erstellen.

Weitere Informationen finden Sie in folgenden Dokumenten:

Semantische Governance-Richtlinien

(Optional) Sie können Ihren Agenten kontextsensitive Steuerelemente auf Basis natürlicher Sprache hinzufügen, um Schutz vor schädlichen Kombinationen von Tools zu ermöglichen.

Wir empfehlen, semantische Governance-Richtlinien zuerst im Probelaufmodus bereitzustellen, damit Sie Ihre Konfiguration validieren können, ohne Traffic zu blockieren. Weitere Informationen finden Sie unter Semantische Governance-Richtlinien konfigurieren.

Benutzerdefinierte Autorisierungs-Engines

(Optional) Wenn Sie die Autorisierung mithilfe von Service Extensions an benutzerdefinierte Autorisierungs-Engines oder Drittanbietersysteme delegieren möchten, müssen Sie dafür sorgen, dass die benutzerdefinierten Autorisierungs-Engines beim Bereitstellen des Gateways verfügbar sind.

Model Armor, semantische Governance-Richtlinien und andere benutzerdefinierte Autorisierungs-Engines können entweder während der Ersteinrichtung des Agent Gateways aktiviert oder nach der Bereitstellung als inkrementelles Sicherheitsrichtlinien-Update angehängt werden.

Agent Gateway im Agent-to-Anywhere-Modus (ausgehend) konfigurieren

Wenn Sie das Agent Gateway im Agent-to-Anywhere-Modus (Ausgang) einrichten, können Sie konfigurieren, wie der verwaltete Traffic die Zielendpunkte und ‑tools erreicht. Wählen Sie je nach Ihren Netzwerk- und Sicherheitsanforderungen eine der folgenden Bereitstellungsoptionen aus:

  • Ausgehender Internet-Traffic: Das Gateway leitet den Agent-Traffic sicher über das Internet an öffentlich zugängliche Endpunkte und APIs weiter. Wenn Sie ein Agent-Gateway mit ausgehendem Internet-Traffic konfigurieren möchten, können Sie die Anleitung auf dieser Seite verwenden.

  • Ausgehender Traffic aus dem VPC-Netzwerk: Das Gateway leitet den KI-Agenten-Traffic über Private Service Connect-Netzwerkanhänge privat in ein VPC-Netzwerk weiter. Sie können entweder den gesamten Traffic über das VPC-Netzwerk (ALL_TRAFFIC) oder nur den Traffic an private IP-Adressbereiche (PRIVATE_RANGES_ONLY) weiterleiten.

    Wenn Sie ein Agent-Gateway mit ausgehendem VPC-Traffic konfigurieren möchten, müssen Sie die Anleitung unter VPC-Verbindung für Agent-Gateway einrichten verwenden.

So erstellen Sie eine Agent Gateway-Ressource für die Agent-to-Anywhere-Kommunikation:

Google Cloud Console

  1. Rufen Sie in der Google Cloud Console die Seite Agent Gateway auf.

    Zu „Gateways“

  2. Klicken Sie auf Gateway hinzufügen.
  3. Geben Sie einen Namen ein.
  4. Wählen Sie in der Liste Region eine Region aus.
  5. Prüfen Sie, ob für Bereitstellungsmodus die Option Von Google verwaltet ausgewählt ist.
  6. Das Feld Agent Registry wird automatisch mit dem URI der regionalen Registry gefüllt, die der Region Ihres Agent Gateways entspricht.
  7. Wählen Sie in der Liste Verwalteter Zugriffspfad die Option Agent-to-Anywhere (Agent Egress) aus.
  8. Wählen Sie im Abschnitt Zugriffsautorisierung aus, wie Traffic von IAP verarbeitet wird:

    • Wenn Sie das Gateway im Probelaufmodus bereitstellen möchten, in dem das Gateway den gesamten Traffic zulässt und nur Audit-Logs generiert, wählen Sie Nur Audit aus. Dadurch wird iamEnforcementMode: "DRY_RUN" für die Autorisierungserweiterung festgelegt. Ihre IAM-Richtlinien werden von IAP im Probelaufmodus nicht erzwungen. Wenn Sie sich sicher sind, können Sie den Probelaufmodus deaktivieren, um IAM-Richtlinien zu erzwingen.
    • Wenn Sie Anfragen blockieren möchten, die keine explizite IAM-Richtlinie vom Typ Allow haben, wählen Sie Richtlinien erzwingen aus. Dadurch wird beim Erstellen eines Gateways iamEnforcementMode: "ENFORCED" in die Autorisierungserweiterung geschrieben oder beim Aktualisieren eines vorhandenen Gateways iamEnforcementMode entfernt. Diese Option wird für Produktionsumgebungen empfohlen.
    • Wählen Sie für Richtlinienmodell die Option Unified Access Policy aus.
  9. Optional: Konfigurieren Sie im Abschnitt KI-Sicherheit zusätzliche Sicherheitsfunktionen:

    1. Wenn Sie KI-Modellinteraktionen mit Model Armor schützen möchten, aktivieren Sie Model Armor aktivieren.
    2. Wählen Sie in der Liste eine Vorlage aus, die für eingehende Anfragen an das Gateway gilt.
    3. Wenn Sie eine andere Vorlage für Antworten verwenden möchten, entfernen Sie das Häkchen bei Dieselbe Vorlage für Anfragen und Antworten verwenden und wählen Sie eine Vorlage aus der Liste aus.

  10. Klicken Sie auf Gateway hinzufügen.

gcloud

Agent Gateways werden deklarativ mit YAML definiert.

  1. Definieren Sie die Ressource und speichern Sie die Konfiguration in einer YAML-Datei. In diesem Beispiel verwenden wir my-agent-gateway-egress.yaml.

    name: AGENT_GATEWAY_NAME
    protocols:
      - MCP
    googleManaged:
      governedAccessPath: AGENT_TO_ANYWHERE
    registries:
      - AGENT_REGISTRY_PATH
    

    Ersetzen Sie Folgendes:

    • AGENT_GATEWAY_NAME: Der Name der Agent-Gateway-Ressource.
    • AGENT_REGISTRY_PATH: Der Pfad zur regionalen Agent Registry-Instanz im selben Projekt und in derselben Region wie das Gateway, formatiert als //agentregistry.googleapis.com/projects/PROJECT_ID/locations/LOCATION. Eine Anleitung finden Sie unter Agent-Gateway-Bereitstellung planen.
  2. Führen Sie den folgenden Befehl aus, um eine Agent-Gateway-Ressource basierend auf der YAML-Spezifikation zu erstellen:

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

    Ersetzen Sie LOCATION durch den Standort, an dem Sie die Agent-Gateway-Ressource erstellen möchten. Beispiel: us-central1

    Beachten Sie, dass Sie für Gemini Enterprise das Agent Gateway in einer Region bereitstellen müssen, die dem Standort Ihrer Anwendung entspricht. Informationen zu den erforderlichen Zuordnungen des Speicherorts finden Sie unter Gemini Enterprise-Traffic über das Agent Gateway weiterleiten.

  3. Erstellen Sie eine Autorisierungsrichtlinie (AuthzPolicy) und hängen Sie sie an, um zentrale Zugriffssteuerungs- und Governance-Richtlinien für den Traffic zu erzwingen, der das Agent Gateway passiert. Ohne eine angehängte Autorisierungsrichtlinie übernimmt ein Agent-to-Anywhere-Agent-Gateway eine Standard-Ablehnungsrichtlinie und blockiert den gesamten ausgehenden Traffic. In den folgenden Schritten wird gezeigt, wie Sie eine Autorisierungsrichtlinie konfigurieren, die IAP verwendet.

    1. Konfigurieren Sie eine Autorisierungserweiterung, die auf IAP verweist. Definieren Sie die Erweiterung in einer YAML-Datei, z. B. iap-request-authz-extension.yaml. Verwenden Sie die folgenden Beispielwerte:

      cat >iap-request-authz-extension.yaml <<EOF
      name: AUTHORIZATION_EXTENSION_NAME
      service: iap.googleapis.com
      failOpen: false
      timeout: 1s
      metadata:
        iapPolicyVersion: "V2"
      EOF
      

      Wenn Sie die Erweiterung im Probelauf-Modus bereitstellen möchten, um die Autorisierungsrichtlinie zu testen, ohne sie zu erzwingen, können Sie das Feld iamEnforcementMode im Block metadata angeben. So können Sie Ihre Richtlinie prüfen und das Risiko von Traffic-Unterbrechungen aufgrund von Konfigurationsfehlern minimieren:

      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
      

      Entfernen Sie das Feld iamEnforcementMode: "DRY_RUN" aus dem Block metadata, wenn Sie mit der Erzwingung von Richtlinien beginnen möchten. Eine Anleitung zum Prüfen von Verstößen im Probelauf für alle Kontrollen vor dem Aktivieren der Erzwingung finden Sie unter Richtlinienverstöße im Probelauf für alle Kontrollen prüfen.

    2. Importieren Sie die YAML-Konfigurationsdatei in eine Autorisierungserweiterung.

      gcloud beta service-extensions authz-extensions import AUTHORIZATION_EXTENSION_NAME \
        --source=iap-request-authz-extension.yaml \
        --location=LOCATION
      

      Ersetzen Sie AUTHORIZATION_EXTENSION_NAME durch den Namen der Autorisierungserweiterung, z. B. my-iap-request-authz-ext.

    3. Definieren Sie eine Autorisierungsrichtlinie in einer YAML-Datei, z. B. iap-request-authz-policy.yaml, um die Erweiterung mit Ihrem Gateway zu verknüpfen:

      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
      

      Ersetzen Sie Folgendes:

      • AUTHORIZATION_POLICY_NAME: der Name der Autorisierungsrichtlinie, z. B. my-iap-request-authz-policy
      • PROJECT_ID: Die Projekt-ID.
    4. Importieren Sie die YAML-Konfigurationsdatei in eine Autorisierungsrichtlinie.

      gcloud network-security authz-policies import AUTHORIZATION_POLICY_NAME \
        --source=iap-request-authz-policy.yaml \
        --location=LOCATION
      
  4. Optional: Wenn Sie Model Armor-Sicherheitsmaßnahmen konfigurieren möchten, um Ihre Bereitstellung vor Prompt-Injection-Angriffen und Datenlecks zu schützen, lesen Sie den Abschnitt Autorisierung an Model Armor delegieren.

Terraform

Führen Sie die folgenden Schritte aus, um ein Agent-to-Anywhere-Agent-Gateway (ausgehend) und die zugehörige IAP-Autorisierungserweiterung und -Richtlinie deklarativ in einem zentralen Governance-Projekt mit dem google-Anbieter bereitzustellen.

  1. Erstellen Sie die Ressource google_network_services_agent_gateway und verknüpfen Sie Ihre regionale Agent Registry-Instanz:

    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. Konfigurieren Sie die IAP-google_network_services_authz_extension und hängen Sie sie mit einer google_network_security_authz_policy an das Gateway an:

    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. Nachdem ein Agent-Gateway erstellt wurde, dient es als primärer Verbindungspunkt für das Routing des Agent-Traffics innerhalb Ihres Projekts und der ausgewählten Region. Sie können diesen Endpunkt jetzt verwenden, um sichere, verschlüsselte und authentifizierte Kommunikationskanäle zwischen Agenten und ihren Zielen (Tools, andere Agenten oder andere Endpunkte) einzurichten.

    Lesen Sie sich den Abschnitt Agent Gateway-Bereitstellung planen auf dieser Seite noch einmal durch und prüfen Sie, ob Ihre Agenten bei Agent Registry registriert sind und ob Ihr Agent die Berechtigung iap.resources.egressViaIAP für alle Ziele hat, zu denen er eine Verbindung herstellen möchte. Wenn Verbindungsprobleme auftreten, lesen Sie den Abschnitt Verbindungsprobleme mit dem Agent-Gateway beheben.

Als Nächstes erfahren Sie, wie Sie Agenten bereitstellen und Traffic über das Agent Gateway weiterleiten.

KI-Agenten-Gateway im Client-zu-Agent-Modus (eingehend) konfigurieren

In diesem Abschnitt wird beschrieben, wie Sie ein Agent-Gateway für die Client-zu-Agent-Kommunikation einrichten.

So erstellen Sie eine Agent Gateway-Ressource:

Google Cloud Console

  1. Rufen Sie in der Google Cloud Console die Seite Agent Gateway auf.

    Zu „Gateways“

  2. Klicken Sie auf Gateway hinzufügen.
  3. Geben Sie einen Namen ein.
  4. Wählen Sie in der Liste Region eine Region aus.
  5. Prüfen Sie, ob für Bereitstellungsmodus die Option Von Google verwaltet ausgewählt ist.
  6. Lassen Sie die Einstellung Agent-Registry unverändert. Die Registry wird nicht für Ingress verwendet.
  7. Wählen Sie in der Liste Verwalteter Zugriffspfad die Option Client-zu-Agent (eingehend) aus.
  8. Optional: Konfigurieren Sie im Abschnitt KI-Sicherheit zusätzliche Sicherheitsfunktionen:

    1. Wenn Sie KI-Modellinteraktionen mit Model Armor schützen möchten, aktivieren Sie Model Armor aktivieren.

    2. Wählen Sie in der Liste eine Vorlage aus, die für eingehende Anfragen an das Gateway gilt.

    3. Wenn Sie eine andere Vorlage für Antworten verwenden möchten, entfernen Sie das Häkchen bei Dieselbe Vorlage für Anfragen und Antworten verwenden und wählen Sie eine Vorlage aus der Liste aus.

  9. Klicken Sie auf Gateway hinzufügen.

gcloud

Agent Gateways werden deklarativ mit YAML definiert.

  1. Definieren Sie die Ressource und speichern Sie die Konfiguration in einer YAML-Datei. In diesem Beispiel verwenden wir my-agent-gateway-ingress.yaml.

    name: AGENT_GATEWAY_NAME
    protocols:
      - MCP
    googleManaged:
      governedAccessPath: CLIENT_TO_AGENT
    

    Ersetzen Sie AGENT_GATEWAY_NAME durch einen Namen für die Agent-Gateway-Ressource.

  2. Führen Sie den folgenden Befehl aus, um eine Agent-Gateway-Ressource basierend auf der YAML-Spezifikation zu erstellen:

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

    Ersetzen Sie LOCATION durch den Standort, an dem Sie die Agent-Gateway-Ressource erstellen möchten. Beispiel: us-central1

Terraform

So stellen Sie eine Agent-Gateway-Ressource für Client-zu-Agent (eingehend) deklarativ mit dem google-Anbieter bereit:

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"
  }
}

Nachdem ein Agenten-Gateway erstellt wurde, dient es als primärer Verbindungspunkt für das Routing von Traffic zu Agenten in Ihrem Projekt und der ausgewählten Region.

Als Nächstes erfahren Sie, wie Sie KI-Agenten bereitstellen und Traffic über das KI-Agenten-Gateway weiterleiten.

Agenten bereitstellen und Traffic über Agent Gateway weiterleiten

Informationen zum Bereitstellen eines Agent Runtime-Agenten, der Traffic über das Agent Gateway weiterleitet, finden Sie unter Traffic über das Agent Gateway weiterleiten.

Informationen zum Bereitstellen eines Gemini Enterprise-Agenten, der Traffic über Agent Gateway weiterleitet, finden Sie unter Gemini Enterprise-Traffic über Agent Gateway weiterleiten.

Codelabs

Eine End-to-End-Demonstration zum Einrichten und Verwenden von Agent Gateway finden Sie in den folgenden Codelabs:

Nächste Schritte

Anleitung

Hier erfahren Sie, wie Sie Agent Runtime-Traffic über Agent Gateway weiterleiten, um eine sichere und verwaltete Verbindung zu ermöglichen.

Anleitung

Hier erfahren Sie, wie Sie die Autorisierung für Agent Gateway an IAP, Model Armor oder Ihren eigenen benutzerdefinierten Autorisierungsdienst delegieren.

Anleitung

Informationen zum Aufrufen, Aktualisieren, Aufheben der Verknüpfung und Löschen von Agent Gateway-Ressourcen.

Anleitung

Informationen zum Überwachen des KI-Agenten-Gateways

Fehlerbehebung

Informationen zur Fehlerbehebung bei der Verbindung zum KI-Agenten-Gateway.

Anleitung

Hier erfahren Sie, wie Sie Gemini Enterprise-Traffic über Agent Gateway weiterleiten.