Gemini Enterprise-Traffic über das Agent Gateway weiterleiten

Auf dieser Seite wird beschrieben, wie Sie Gemini Enterprise-Traffic über das Agent Gateway weiterleiten. Das Agent Gateway ist eine zentrale Netzwerk- und Sicherheitskomponente des Gemini Enterprise Agent Platform-Ökosystems. Es bietet sichere und verwaltete Verbindungen für alle agentischen Interaktionen, unabhängig davon, ob sie zwischen Nutzern und Agenten, Agenten und Tools oder zwischen Agenten selbst stattfinden.

Hinweis

• Machen Sie sich mit den Konzepten von Gemini Enterprise vertraut.
• Weitere Informationen zum Agent Gateway. Das Agent Gateway unterstützt Gemini Enterprise nur im Agent-to-Anywhere-Modus (Ausgang). Eingehender Traffic wird nicht unterstützt.
• Stellen Sie eine Gemini Enterprise-App (auch als Engine bezeichnet) bereit. Bei der Anleitung auf dieser Seite wird davon ausgegangen, dass Sie bereits eine App bereitgestellt haben. Weitere Informationen finden Sie unter App erstellen.

Standort- und Agent Registry-Zuordnungen planen

Bevor Sie Ihr Agent Gateway bereitstellen, wählen Sie die Region aus, in der Sie das Gateway bereitstellen, und die Agent Registry, in der Sie Ihre Ressourcen registrieren. Beachten Sie folgende Anforderungen:

• Standortzuordnung:Stellen Sie das Agent Gateway in der Region bereit, die Ihrer multiregionalen Einrichtung der Gemini Enterprise-App entspricht, um eine korrekte Weiterleitung zu gewährleisten.

• Registry-Zuordnung:Sie können bis zu zwei Registries mit einem Agent Gateway verknüpfen (eine globale Registry und eine regionale oder multiregionale Registry). Weitere Informationen zu Bereitstellungsmustern und Registry-Optionen finden Sie unter Bereitstellung des Agent Gateway planen.

Gemini Enterprise-Traffic über das Agent Gateway weiterleiten

So leiten Sie Gemini Enterprise-Traffic über das Agent Gateway weiter:

1. Erstellen Sie eine Agent Gateway-Ressource und halten Sie sich an die Region und Registry, die Sie im vorherigen Abschnitt ausgewählt haben. Eine Anleitung finden Sie unter Agent Gateway einrichten.

   Prüfen Sie die Gateway-Konfiguration. Verwenden Sie die Network Services API, um die Agent Gateway-Konfiguration abzurufen und die Einstellungen zu prüfen.

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   "https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/AGENT_GATEWAY_REGION/agentGateways/AGENT_GATEWAY_NAME"
   

   Hier sehen Sie ein Beispiel für die Ausgabe eines korrekt konfigurierten Gateways:

   {
     "name": "projects/my-ge-project/locations/us-central1/agentGateways/my-egress-gateway",
     "description": "A full configuration for Agent Gateway for Gemini Enterprise egress",
     "googleManaged": {
       "governedAccessPath": "AGENT_TO_ANYWHERE"
     },
     "protocols": [
       "MCP"
     ],
     "registries": [
       "//agentregistry.googleapis.com/projects/my-ge-project/locations/global"
     ]
   }
   

2. Binden Sie das Gateway mit der UpdateEngine API an Ihre Gemini Enterprise-App. Wenn Sie diesen Schritt ausführen, wird der gesamte vorhandene Agent-Traffic sofort über das angegebene Agent Gateway weitergeleitet.

   Console

   1. Rufen Sie in der Cloud de Confiance Console die Seite Gemini Enterprise auf.

      Gemini Enterprise

   2. Klicken Sie auf den Namen der App, die Sie mit einem Agent Gateway verknüpfen möchten.

   3. Klicken Sie auf Sicherheit.

   4. Geben Sie auf dem Tab Konfiguration unter Agent Gateway Konfiguration den vollständigen Ressourcennamen für das Gateway ein. Verwenden Sie das Format: projects/PROJECT_ID/locations/LOCATION/agentGateways/AGENT_GATEWAY_NAME.

   5. Klicken Sie auf Speichern.

   REST

   1. Verwenden Sie die folgende Anfrage, um Ihre App zu aktualisieren.

      curl -X PATCH \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json" \
      -H "X-Goog-User-Project: PROJECT_ID" \
      -d '{
        "agentGatewaySetting": {
          "defaultEgressAgentGateway": {
            "name": "projects/PROJECT_ID/locations/AGENT_GATEWAY_REGION/agentGateways/AGENT_GATEWAY_NAME"
          }
        }
      }' \
      "https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/GE_APP_LOCATION/collections/default_collection/engines/GE_APP_ID?updateMask=agentGatewaySetting.defaultEgressAgentGateway.name"

      Ersetzen Sie Folgendes:

      • PROJECT_ID: die Projekt-ID
      • AGENT_GATEWAY_REGION: die Region des Agent Gateway
      • AGENT_GATEWAY_NAME: der Name des Agent Gateway
      • PROJECT_NUMBER: die Projektnummer
      • GE_APP_LOCATION: der Standort der Gemini Enterprise-App (z. B. us oder global)
      • GE_APP_ID: die ID der Gemini Enterprise-App

   2. Verwenden Sie den folgenden Befehl, um die App-Konfiguration zu prüfen. Rufen Sie dazu die Konfiguration ab und prüfen Sie die Einstellungen:

      curl -s -X GET \
      -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
      -H "X-Goog-User-Project: PROJECT_ID" \
      -H "Content-Type: application/json" \
      "https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/GE_LOCATION/collections/default_collection/engines/GE_APP_ID" \
      | jq '{name: .name, displayName: .displayName, agentGatewaySetting: .agentGatewaySetting}'
      

      Hier sehen Sie ein Beispiel für die Ausgabe einer korrekt konfigurierten App:

      {
      "name": "projects/PROJECT_NUMBER/locations/GE_LOCATION/collections/default_collection/engines/GE_APP_ID",
      "displayName": "GE_APP_ID",
      "agentGatewaySetting": {
        "defaultEgressAgentGateway": {
          "name": "projects/PROJECT_ID/locations/AGENT_GATEWAY_REGION/agentGateways/AGENT_GATEWAY_NAME"
        }
      }
      }
      

3. Die Governance für ausgehenden Traffic ist jetzt für Ihre Gemini Enterprise-App aktiviert. Ihre App weiß jedoch nicht automatisch, mit welchen externen Ressourcen in der Agent Registry sie interagieren kann.

   Sie müssen die ausgewählten Agenten, Endpunkte und MCP-Server explizit in Ihre Gemini Enterprise-App importieren. Auf die importierte Ressource muss mit dem genauen Registry-basierten Ressourcennamen verwiesen werden. Eine Anleitung finden Sie in den folgenden Leitfäden:

   • MCP-Server aus der Agent Registry importieren
   • A2A-Agenten aus der Agent Registry importieren.

4. So prüfen Sie, ob der ausgehende Traffic korrekt funktioniert:

   1. Öffnen Sie die Gemini Enterprise-Webanwendung.
   2. Senden Sie eine Abfrage, die ein externes Tool auslösen soll (z. B. „Gib mir eine Liste der letzten Probleme von GitHub“).
   3. Beobachten Sie die Ausführung, um sicherzustellen, dass die Antwort abgerufen wird. Im Hintergrund verpackt der Gemini Enterprise-Agent die Anfrage, leitet sie über das Agent Gateway weiter (wobei alle konfigurierten Autorisierungsrichtlinien erzwungen werden) und ruft die Antwort vom Ziel ab.

Gemini Enterprise-Bindung auf genehmigte Agent Gateways beschränken

Sie können benutzerdefinierte Einschränkungen für Organisationsrichtlinien erstellen, um zu beschränken, ob eine Gemini Enterprise-App an alle oder nur bestimmte Agent Gateways gebunden werden kann.

Benutzerdefinierte Einschränkungen für Organisationsrichtlinien erstellen

In diesem Beispiel wird eine benutzerdefinierte Einschränkung erstellt, die alle Bindungen zwischen Gemini Enterprise-Apps und Agent Gateways blockiert.

Weitere Informationen zur Verwendung benutzerdefinierter Einschränkungen für Organisationsrichtlinien finden Sie unter Benutzerdefinierte Einschränkungen erstellen.

Nächste Schritte