Hinweis:Diese Dokumentation gilt für die Standard-, Plus-, Pay-as-you-go- und Frontline-Version von Gemini Enterprise. Die Dokumentation für die Business-Version finden Sie in der Gemini Enterprise-Hilfe für die Business-Version.

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Enterprise-Gateway für Google Antigravity konfigurieren

In diesem Dokument wird Administratoren und Sicherheitsarchitekten gezeigt, wie sie ein Enterprise-Gateway für Google Antigravity bereitstellen und konfigurieren.

Unternehmen in regulierten Branchen haben oft strenge Netzwerksteuerungen, die verhindern, dass Entwickler-Workstations direkte Internetverbindungen zu externen Diensten herstellen oder die interaktive browserbasierte Google-Anmeldung durchführen.

Mit Antigravity Enterprise Gateway können Sie Antigravity-Traffic über ein von Ihrer Organisation betriebenes Enterprise-Gateway leiten, bevor Inferenzanfragen an Google weitergeleitet werden. Bei dieser Architektur werden Anfragen zur Modellinferenz über Ihr Gateway weitergeleitet und die interaktive Anmeldung wird entfernt. Die Abrechnungszuordnung für Ihren Gemini Enterprise-Vertrag bleibt jedoch erhalten.

Übersicht

Wenn Sie Antigravity Enterprise Gateway konfigurieren, kommunizieren Entwickler-Workstations mit dem Enterprise Gateway, anstatt sich direkt mit Google zu verbinden. Entwickler authentifizieren sich beim Gateway mit einem API-Schlüssel, den Ihr Gateway ausgibt. Antigravity fordert sie also nicht auf, sich mit einem individuellen Google-Konto anzumelden. Ihr Gateway verwendet dann ein zentralesGoogle Cloud -Dienstkonto, um Antigravity-Anfragen zu authentifizieren und an Google weiterzuleiten.

Antigravity hängt automatisch Client-Attributionsheader an, um Entwickler-Chat-Prompts und Agenten-Workflows zu identifizieren. Damit diese Modellnutzung erkannt und im Rahmen der bestehenden Gemini Enterprise-Vereinbarung Ihrer Organisation abgerechnet wird, anstatt als nicht zugesicherter Roh-API-Verbrauch, muss Ihr Gateway diese Antigravity-Header beibehalten und an Google weiterleiten:

User-Agent: Antigravity gibt automatisch einen Identifikationsheader aus:
```
User-Agent: antigravity/VERSION (aidev_client; auth_method=gateway)
```
X-Goog-Api-Client: Identifiziert die Antigravity-Clientlaufzeit und die SDK-Telemetrie, damit Google die Aktivität Ihrer lizenzierten Unternehmensbereitstellung zuordnet.

Unterstützte Tools und Versionen

Antigravity Enterprise Gateway unterstützt die folgenden KI-Entwicklertools:

Tool	Mindestversion	Unterstützte Plattformen
Antigravity-App	2.15.0 oder höher	macOS, Windows und Linux
Antigravity CLI (`agy`)	1.2.15 oder höher	macOS und Linux
Antigravity für IDEs	Visual Studio Code und Visual Studio: Antigravity CLI 1.2.15 oder höher, die von der Erweiterung automatisch heruntergeladen und aktualisiert wird. JetBrains-IDEs und Zed (mit ACP-Server): 1.3.0 oder höher	Visual Studio Code, Visual Studio, JetBrains-IDEs und Zed. Weitere Informationen finden Sie unter Antigravity IDE-Erweiterungen.

Hinweis

Prüfen Sie vor der Bereitstellung des Gateways, ob Sie Folgendes haben:

Google Cloud-Projekt: Ein Google Cloud -Projekt mit Zugriff auf die Gemini Enterprise Agent Platform (früher Vertex AI) und aktivierter Gemini Enterprise Agent Platform API (aiplatform.googleapis.com). Für die Bereitstellung des Enterprise-Gateways ist kein Cloud-Rechnungskonto mit monatlicher Rechnungsstellung erforderlich. Alle Nutzer mit Zugriff auf die Gemini Enterprise Agent Platform können das Gateway verwenden.
Dienstkonto: Ein Google Cloud -Dienstkonto in Ihrem Projekt, dem die IAM-Rolle roles/aiplatform.user zugewiesen wurde. Ihr Gateway verwendet dieses Dienstkonto, um Antigravity-Anfragen an Google Cloudzu authentifizieren.
Audit-Logs zum Datenzugriff: Wenn Sie die Abrechnungszuordnung in Cloud Logging prüfen möchten, aktivieren Sie Audit-Logs zum Datenzugriff für die Gemini Enterprise Agent Platform API. Weitere Informationen finden Sie unter Audit-Logs zum Datenzugriff aktivieren.
Unterstützte Clientversionen: Entwickler müssen eine unterstützte Version jedes Antigravity-Tools verwenden. Weitere Informationen finden Sie unter Unterstützte Antigravity-Tools.

Enterprise-Gateway bereitstellen

Sie können Ihr Enterprise-Gateway auf einer beliebigen containerisierten oder verwalteten Plattform hosten, z. B. Cloud Run, Envoy, LiteLLM oder Apigee.

Ihr Gateway muss drei Infrastrukturanforderungen erfüllen:

Client-Attributionsheader beibehalten: Eingehende Client-Header werden unverändert an Google weitergeleitet, einschließlich User-Agent, X-Goog-Api-Client und aller benutzerdefinierten Header, die in gateway.customHeaders konfiguriert sind (z. B. X-Cost-Center).

Antigravity-Clients senden im Gateway-Modus keine Google Cloud -Projektinformationen. Wenn Ihr Gateway Anfragen an ein anderes Projekt als das Projekt weiterleitet, das das Dienstkonto des Gateways enthält, konfigurieren Sie Ihr Gateway so, dass der Header X-Goog-User-Project mit der Zielprojekt-ID für die Abrechnung und Kontingentzuordnung eingefügt wird.
Unterstützung von ungepuffertem Streaming: Server-Sent Events (SSE)-Blöcke werden sofort geleert, wenn Streaminganfragen (:streamGenerateContent?alt=sse) verarbeitet werden. Blöcke werden nicht in der Gateway-Ebene gepuffert.
Telemetrie-Endpunkte bestätigen: Antworten Sie auf Hintergrundmesswertaufrufe (POST /v1beta:*) mit HTTP 200 OK ({}) oder leiten Sie sie an Ihr SIEM-System (Security Information and Event Management) weiter.

Obligatorische Anfragepfade

Ihr Gateway muss die folgenden Inferenzpfade weiterleiten. Pfade sind relativ zu Ihrer Gateway-URL. Eine Streaminganfrage an https://gateway.cymbal.com verwendet beispielsweise https://gateway.cymbal.com/v1beta/models/MODEL_ID:streamGenerateContent?alt=sse.

Streaming-Inferenz: POST /v1beta/models/MODEL_ID:streamGenerateContent?alt=sse
Unäre Inferenz: POST /v1beta/models/MODEL_ID:generateContent

Ihr Gateway muss auch die entsprechenden vollständigen Gemini Enterprise Agent Platform-Pfade akzeptieren:

Streaming-Inferenz: POST /v1beta1/projects/PROJECT_ID/locations/REGION/publishers/google/models/MODEL_ID:streamGenerateContent?alt=sse
Unäre Inferenz: POST /v1beta1/projects/PROJECT_ID/locations/REGION/publishers/google/models/MODEL_ID:generateContent

Anfragetextkörper verwenden das Standard-JSON-Schema generateContent (contents, generationConfig, safetySettings und systemInstruction).

Unterstützte Wire-Protokolle

Antigravity Enterprise Gateway unterstützt zwei Wire-Protokolle für Inferenzanfragen:

Gemini-Protokoll (genai): Das Standard-Wire-Protokoll. Antigravity sendet Inferenzanfragen im generateContent-Schema von Google an die zuvor beschriebenen POST /v1beta/models/...-Endpunkte.
OpenAI-Wire-Protokoll (openai): Wenn Sie gateway.wireProtocol auf openai setzen (oder AGY_LLM_GATEWAY_WIRE_PROTOCOL=openai festlegen), formatiert Antigravity Inferenzanfragen im OpenAI Chat Completions-Protokoll und sendet sie an POST /v1/chat/completions.

Anfragen an Ihr Gateway authentifizieren

Antigravity authentifiziert sich bei Ihrem Gateway mit einem API-Schlüssel, den Ihr Gateway ausgibt. Antigravity sendet den Schlüssel aus gateway.apiKey (oder der Umgebungsvariablen AGY_LLM_GATEWAY_API_KEY) als Inhabertoken im Header Authorization:

Authorization: Bearer GATEWAY_API_KEY

Antigravity ruft keine Google Cloud -Anmeldedaten, OAuth-Tokens oder Clientzertifikate im Namen von Entwicklern ab. Ihr Gateway muss jede Anfrage authentifizieren und Anfragen ablehnen, die keinen gültigen Schlüssel enthalten.

Da der API-Schlüssel auf Entwickler-Workstations gespeichert wird, sollten Sie ihn mit Kontrollen auf Netzwerkebene kombinieren:

Gateway privat halten: Stellen Sie das Gateway nur in Ihrem Unternehmensnetzwerk bereit, z. B. über einen internen Application Load Balancer, den Workstations über Cloud VPN oder Cloud Interconnect erreichen. Geben Sie dem Gateway keinen öffentlichen Endpunkt.
Einschränken, welche Geräte eine Verbindung herstellen können: Lassen Sie Verbindungen nur von verwalteten Workstations zu, z. B. mithilfe von Firewallregeln, einem Zero-Trust-Netzwerkzugriffsproxy oder Geräte-Statusprüfungen.
Schlüssel schützen und rotieren: Speichern Sie Schlüssel in Secret Manager, validieren Sie sie bei jeder Anfrage und rotieren Sie sie regelmäßig. Wenn Sie die Nutzung einzelnen Entwicklern zuordnen möchten, müssen Sie jedem Entwickler einen separaten Schlüssel ausstellen.

Weitere Informationen finden Sie unter Sicherheitsaspekte.

Gateway mit der Gemini Enterprise Agent Platform verbinden

Ihr Gateway ruft die Gemini Enterprise Agent Platform API über ein Google Cloud -Dienstkonto auf. Sie können das Gateway auf einem verwalteten API-Gateway wie Apigee erstellen oder ein Gateway wie Envoy oder LiteLLM in Ihrer eigenen Infrastruktur bereitstellen.

Aktivieren Sie die erforderlichen APIs:

gcloud services enable \
  aiplatform.googleapis.com \
  secretmanager.googleapis.com \
  --project=PROJECT_ID

Ersetzen Sie dabei PROJECT_ID durch die ID Ihres Projekts in Google Cloud .

Erstellen Sie ein Dienstkonto für das Gateway und weisen Sie ihm die Rolle roles/aiplatform.user zu:

gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
  --project=PROJECT_ID \
  --display-name="Antigravity Enterprise Gateway"

gcloud projects add-iam-policy-binding PROJECT_ID \
  --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/aiplatform.user"

Ersetzen Sie SERVICE_ACCOUNT_NAME durch einen Namen für das Dienstkonto, z. B. agy-gateway-sa.

Generieren Sie einen Gateway-API-Schlüssel, speichern Sie ihn in Secret Manager und lassen Sie ihn vom Dienstkonto lesen:

openssl rand -base64 32 | tr -d '\n' | gcloud secrets create SECRET_NAME \
  --project=PROJECT_ID \
  --data-file=-

gcloud secrets add-iam-policy-binding SECRET_NAME \
  --project=PROJECT_ID \
  --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/secretmanager.secretAccessor"

Ersetzen Sie SECRET_NAME durch einen Namen für das Secret, z. B. agy-gateway-api-key. Sie verteilen diesen Schlüssel als gateway.apiKey in admin_settings.json an Workstations.

Konfigurieren Sie Ihr Gateway für Folgendes:
- Authentifizieren Sie sich als Dienstkonto bei der Gemini Enterprise Agent Platform.
- Den API-Schlüssel aus Secret Manager lesen und Anfragen ablehnen, die ihn nicht enthalten.
- Lassen Sie Anfragen mindestens 60 Minuten lang laufen, damit lange Streamingantworten nicht abgeschnitten werden.

Wenn Sie prüfen möchten, ob das Gateway funktioniert, bevor Sie Workstations konfigurieren, lesen Sie den Abschnitt Gateway direkt testen.

Einstellungen über die Mobilgeräteverwaltung bereitstellen

Wenn Sie Entwicklerarbeitsstationen zentral konfigurieren möchten, stellen Sie die Konfigurationsdatei admin_settings.json über Ihr MDM-System (Mobile Device Management) bereit, z. B. Jamf, Microsoft Intune, Ansible oder Google Workspace MDM.

Antigravity liest admin_settings.json aus den folgenden Betriebssystempfaden:

macOS: /Library/Application Support/Antigravity/admin_settings.json
Linux: /etc/antigravity/admin_settings.json
Windows: %ProgramData%\Antigravity\admin_settings.json

So stellen Sie die Einstellungsdatei bereit:

Erstellen Sie eine admin_settings.json-Datei mit Ihrer Gateway-URL, Ihrem API-Schlüssel und den genehmigten Modellen. Ein Beispiel finden Sie unter Konfigurationsbeispiel.

Erstellen Sie in Ihrem MDM-System ein Paket, eine Richtlinie oder ein Skript, mit dem die Datei für jedes Zielbetriebssystem in den Pfad kopiert wird. Führen Sie es mit Administratorberechtigungen aus, damit die Datei einem Administratorkonto gehört und Entwickler sie lesen, aber nicht ändern können. Ihr MDM-Script kann beispielsweise die folgenden Befehle ausführen:

macOS

Führen Sie in einer Shell die folgenden Befehle als Administrator aus:

sudo mkdir -p "/Library/Application Support/Antigravity"
sudo install -m 644 -o root -g wheel admin_settings.json \
"/Library/Application Support/Antigravity/admin_settings.json"

Linux

Führen Sie in einer Shell die folgenden Befehle als Administrator aus:

sudo install -D -m 644 -o root -g root admin_settings.json \
/etc/antigravity/admin_settings.json

Windows

Führen Sie in PowerShell die folgenden Befehle als Administrator aus:

$dir = Join-Path $env:ProgramData "Antigravity"
# Remove any folder that a non-admin created first, so they can't keep ownership.
if (Test-Path $dir) { Remove-Item -Recurse -Force $dir }
New-Item -ItemType Directory -Path $dir | Out-Null
# Administrators own the folder; only admins and SYSTEM can write; users can read.
icacls $dir /setowner "*S-1-5-32-544"
icacls $dir /inheritance:r /grant:r "*S-1-5-32-544:(OI)(CI)F" "*S-1-5-18:(OI)(CI)F" "*S-1-5-32-545:(OI)(CI)RX"
Copy-Item admin_settings.json (Join-Path $dir "admin_settings.json")

Mit diesen Befehlen werden der Ordner und die Datei für alle Nutzer lesbar und nur für Administratoren beschreibbar gemacht.

Weisen Sie das Paket oder die Richtlinie den Geräten oder Gerätegruppen zu, die Antigravity verwenden.
Starten Sie Antigravity auf den Workstations neu, damit die neuen Einstellungen geladen werden.
Informationen dazu, wie Sie prüfen, ob Workstations eine Verbindung zum Gateway herstellen, finden Sie unter Clientverbindungen prüfen.

Rangfolge der Einstellungen

Antigravity liest Gateway-Einstellungen aus drei Quellen. Wenn dieselbe Einstellung in mehreren Quellen definiert ist, hat die Quelle mit der höheren Priorität Vorrang:

Administrator-Einstellungsdatei (höchste): admin_settings.json, die von Ihrem MDM-System bereitgestellt wird.
Umgebungsvariablen: AGY_LLM_GATEWAY_* Variablen, die auf der Workstation festgelegt sind. Weitere Informationen finden Sie unter Antigravity mit einem Enterprise-Gateway verbinden.
Nutzereinstellungsdatei (niedrigste): ~/.antigravity/settings.json im Basisordner des Entwicklers.

Die Einstellungen werden Feld für Feld zusammengeführt. Wenn admin_settings.json beispielsweise die Gateway-URL, aber nicht den API-Schlüssel festlegt, verwendet Antigravity den API-Schlüssel aus einer Umgebungsvariablen. Da die Datei mit den Administratoreinstellungen die höchste Priorität hat, können Entwickler die darin festgelegten Werte nicht überschreiben.

Konfigurationsbeispiel

In der folgenden admin_settings.json-Beispieldatei wird Antigravity so konfiguriert, dass KI-Traffic über ein Unternehmens-Gateway unter https://gateway.cymbal.com geleitet wird. Außerdem werden Header für die Kostenstelle des Unternehmens angehängt und die Modellauswahl wird auf genehmigte Modelle beschränkt:

{
  "gateway": {
    "enabled": true,
    "url": "https://gateway.cymbal.com",
    "apiKey": "GATEWAY_API_KEY",
    "wireProtocol": "genai",
    "customHeaders": {
      "X-Cost-Center": "Platform-Engineering",
      "X-Corporate-BU": "DevTools"
    }
  },
  "caCertPath": "/etc/ssl/certs/cymbal-root-ca.pem",
  "models": {
    "defaultModelId": "gemini-3.8-flash",
    "list": [
      { "modelId": "gemini-3.8-flash" },
      { "modelId": "gemini-3.7-flash" },
      { "modelId": "gemini-3.1-pro-preview" }
    ]
  }
}

In dieser Beispielkonfiguration werden die folgenden Einstellungen definiert:

gateway.enabled: Aktiviert den Gateway-Routingmodus. Wenn die Option auf true gesetzt ist, sendet Antigravity alle Inferenzanfragen an Ihr Gateway, anstatt sie direkt an Google zu senden. Entwickler werden nicht aufgefordert, sich mit einem Google-Konto anzumelden.
gateway.url: Der HTTPS-Endpunkt Ihres Enterprise-Gateways (https://gateway.cymbal.com).
gateway.apiKey: Der API-Schlüssel (GATEWAY_API_KEY), den Ihr Gateway zum Autorisieren von Anfragen benötigt. Dieser Schlüssel wird von Ihrem Gateway ausgestellt, nicht von Google. Antigravity sendet es als Inhabertoken im Authorization-Header.
gateway.wireProtocol: Das API-Wire-Protokoll. Unterstützte Werte sind:
- genai (Standard): Verwendet das Gemini API-Protokoll (POST /v1beta/models/...).
- openai: Verwendet das OpenAI Chat Completions-Wire-Protokoll (POST /v1/chat/completions).
Hinweis: JetBrains-IDEs und Zed verwenden den ACP-Server, der nur das genai-Wire-Protokoll unterstützt.
gateway.customHeaders: Benutzerdefinierte HTTP-Header (X-Cost-Center und X-Corporate-BU), die Antigravity jeder Anfrage hinzufügt. Verwenden Sie diese Header, um die Nutzung in Ihren Gateway-Logs oder SIEM Teams oder Kostenstellen zuzuordnen.
caCertPath: Der absolute Pfad zum Bundle der Root-Zertifizierungsstelle (CA) Ihres Unternehmens. Diese Einstellung sorgt dafür, dass Workstations dem internen TLS-Zertifikat Ihres Gateways vertrauen.
models.defaultModelId: Das Modell, das Antigravity standardmäßig auswählt (z. B. gemini-3.8-flash).
models.list: Die genehmigten Modelle, die Entwickler in Antigravity auswählen können. Für jeden Eintrag ist ein modelId erforderlich, das mit einem Modell übereinstimmt, das von Ihrem Gateway bereitgestellt wird. Eine Liste der unterstützten Google-Modelle finden Sie unter Unterstützte Modelle.

Sicherheitsaspekte

Berücksichtigen Sie bei der Planung der Gateway-Authentifizierung und -Attribution Folgendes:

Vom Client bereitgestellte Header sind nicht vertrauenswürdig: Entwickler haben die Kontrolle über ihre eigenen Workstations und können daher Header ändern, die durch Umgebungsvariablen (AGY_LLM_GATEWAY_HEADERS) oder in der Datei mit den Nutzereinstellungen festgelegt sind. Verlassen Sie sich bei sicherheitskritischem Audit-Logging oder der Abrechnungszuordnung nicht auf diese Header.
Header mithilfe von MDM anpinnen: Damit Entwickler keine Attributions- oder Richtlinienheader überschreiben können, definieren Sie sie in gateway.customHeaders in admin_settings.json. Werte in admin_settings.json haben Vorrang vor Umgebungsvariablen und Nutzereinstellungen.
Auf Netzwerk- oder Transportschicht authentifizieren: Um die Identität von Entwicklern zu überprüfen oder eine strikte Zuordnung zu Kostenstellen zu erzwingen, authentifizieren Sie den Traffic auf der Netzwerk- oder Transportschicht, z. B. mit gegenseitigem TLS (mTLS), Single Sign-On (SSO) auf Proxy-Ebene oder Netzwerk-Mikrosegmentierung. Verlassen Sie sich nicht nur auf den API-Schlüssel oder die HTTP-Header.

Deployment prüfen

Bevor Sie Konfigurationsdateien auf Entwickler-Workstations bereitstellen, sollten Sie prüfen, ob Ihr Unternehmens-Gateway den Traffic korrekt weiterleitet und ob die Zuordnungsinformationen Cloud Logging erreichen.

Gateway direkt testen

Testen Sie den Endpunkt des Enterprise-Gateways direkt mit curl, bevor Sie ihn auf Entwickler-Workstations testen. Durch das direkte Testen des Gateways wird bestätigt, dass Netzwerkrouting, TLS-Zertifikatsvalidierung, Authentifizierung und ungepuffertes Streaming von Server-Sent Events (SSE) unabhängig von Antigravity funktionieren.

Im folgenden Beispiel wird mit dem curl-Befehl eine Streaminganfrage direkt an den Gateway-Endpunkt gesendet:

curl -N -X POST "https://gateway.cymbal.com/v1beta/models/MODEL_ID:streamGenerateContent?alt=sse" \
  -H "Authorization: Bearer GATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "User-Agent: antigravity/1.2.15 (aidev_client; auth_method=gateway)" \
  -d '{"contents": [{"role": "user", "parts": [{"text": "Reply with PONG"}]}]}'

Dabei gilt:

-N: Deaktiviert die Antwortpufferung in curl, sodass Server-Sent Events (SSE) sofort gestreamt werden.
MODEL_ID: Ein genehmigtes Modell aus Ihrer models.list (z. B. gemini-3.8-flash oder gemini-3.7-flash). Wir empfehlen, für die erste Überprüfung ein Flash-Modell zu verwenden. Eine Liste der verfügbaren Modelle finden Sie unter Unterstützte Modelle.
Authorization: Sendet den Gateway-API-Schlüssel (GATEWAY_API_KEY), um die Anfrage beim Gateway zu authentifizieren.
User-Agent: Sendet den Client-Attributionsstring, den Google verwendet, um die Nutzung Ihrer Gemini Enterprise-Vereinbarung zuzuordnen.
streamGenerateContent?alt=sse: Ruft den Streaming-API-Endpunkt für das angegebene Modell auf.

Prüfen Sie, ob das Gateway die Antwortblöcke sofort streamt. Wenn Verbindungsfehler, Zertifikatswarnungen oder Verzögerungen bei der Antwortpufferung auftreten, finden Sie weitere Informationen unter Fehlerbehebung.

Clientverbindungen prüfen

Prüfen Sie den Clientstatus auf einer konfigurierten Workstation:

Antigravity-App: Prüfen Sie, ob in der Statusleiste unten Verbunden: Enterprise Gateway angezeigt wird. Prüfen Sie in den Kontoeinstellungen, ob Enterprise-Gateway-Modus aktiv angezeigt wird.
Antigravity CLI: Führen Sie einen Test-Prompt aus:
```
agy -p "Explain binary search in Go"
```
Mit diesem Befehl wird ein Test-Prompt an das Gateway gesendet. Prüfen Sie, ob die Antwort in Ihrem Terminal gestreamt wird, ohne dass eine interaktive Aufforderung zur Anmeldung bei Google angezeigt wird. Wenn der Client keine Verbindung herstellen kann oder zur Google-Authentifizierung auffordert, finden Sie weitere Informationen unter Fehlerbehebung.

Attribution in Cloud Logging prüfen

Prüfen Sie in der Google Cloud Console, ob Attributionsheader empfangen werden:

Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf:

Zum Log-Explorer

Führen Sie die folgende Abfrage aus:

resource.type="aiplatform.googleapis.com/Endpoint" OR
protoPayload.serviceName="aiplatform.googleapis.com"

Prüfen Sie die Metadaten des Logeintrags. Prüfen Sie, ob protoPayload.requestMetadata.callerSuppliedUserAgent den Wert antigravity/VERSION (aidev_client; auth_method=gateway) enthält.

Wenn keine Logeinträge angezeigt werden, prüfen Sie, ob Audit-Logs zum Datenzugriff für die Gemini Enterprise Agent Platform API aktiviert sind.

Entwickler einbinden

Nachdem Sie das Gateway überprüft haben, bereiten Sie Ihre Entwickler auf die Verwendung von Antigravity vor:

Verwaltete Workstations: Wenn Sie admin_settings.json über Ihr MDM-System bereitstellen, müssen Entwickler keine Konfiguration vornehmen. Antigravity stellt beim Start automatisch eine Verbindung zum Gateway her.
Sandboxes und CI/CD-Pipelines: Für Entwickler, die in containerisierten Runnern, Remote-SSH-Hosts oder nicht verwalteten Entwicklungsumgebungen arbeiten, geben Sie die Gateway-URL, den API-Schlüssel und den Pfad zur Stamm-CA an. Leiten Sie Entwickler an Antigravity mit einem Enterprise Gateway verbinden weiter.

Fehlerbehebung

In der folgenden Tabelle sind häufige Bereitstellungsprobleme und deren Behebung aufgeführt:

Symptom	Ursache	Lösung
`x509: certificate signed by unknown authority`	Die Workstation vertraut dem TLS-Zertifikat des Gateways nicht.	Geben Sie den Pfad zum Stamm-CA-Bundle Ihres Unternehmens mit `caCertPath` in `admin_settings.json` an.
`401 Unauthorized` oder `403 Forbidden`	Der API-Schlüssel ist ungültig oder das Gateway-Dienstkonto hat keinen Zugriff.	Prüfen Sie den Wert `gateway.apiKey` und ob das Gateway-Dienstkonto die IAM-Rolle `roles/aiplatform.user` für das Zielprojekt hat.
`404 Not Found`	Das angeforderte Modell ist im Enterprise-Gateway nicht verfügbar oder die Modell-ID wurde falsch eingegeben.	Prüfen Sie, ob jede in `models.list` in `admin_settings.json` konfigurierte Modell-ID mit einem Modellnamen übereinstimmt, der von Ihrem Enterprise-Gateway bereitgestellt wird.
`gateway.wireProtocol 'openai' is not supported by the ACP server`	`admin_settings.json` oder eine Umgebungsvariable gibt das Wire-Protokoll `openai` an, das vom ACP-Server nicht unterstützt wird.	Setzen Sie `wireProtocol` auf `genai` (oder lassen Sie es weg, um den Standardwert zu verwenden) für JetBrains-IDE- und Zed-Workstations.
Zeitüberschreitung bei Streamingantworten	Das Gateway puffert HTTP-Antworten.	Konfigurieren Sie das Gateway so, dass die Antwortpufferung für Server-Sent Events (`text/event-stream`) deaktiviert wird.
Antigravity-Aufforderungen zur Anmeldung mit Google	Der Gateway-Modus ist nicht aktiviert oder Antigravity kann die Einstellungsdatei nicht finden.	Prüfen Sie, ob `admin_settings.json` im richtigen Betriebssystempfad bereitgestellt wurde und `"enabled": true` sowie `url` im Abschnitt `gateway` enthält.

Nächste Schritte

Informationen dazu, wie Developer Connect eine Verbindung von Remote-Sandboxes herstellt: Antigravity mit einem Enterprise Gateway verbinden.
Weitere Informationen zu Antigravity-Funktionen und ‑Workflows finden Sie in der Antigravity-Dokumentation.
Messwerte und Nutzung von Entwicklertools prüfen: Messwerte für KI-Entwicklertools ansehen
Projektsicherheitsrichtlinien konfigurieren: Einstellungen für KI-Entwicklertools konfigurieren