Connetti Antigravity a un gateway Enterprise

Questo documento mostra agli sviluppatori che utilizzano Gemini Enterprise come connettere Google Antigravity a un gateway aziendale da una workstation, un container o una sandbox per sviluppatori.

Se la tua organizzazione applica controlli di rete rigorosi che bloccano le connessioni a internet dirette ai servizi Google, Antigravity Enterprise Gateway instrada le tue richieste di sviluppo tramite un gateway aziendale gestito dalla tua organizzazione. Questa configurazione ti consente di utilizzare Antigravity senza completare l'accesso interattivo al browser. Per scoprire di più su funzionalità, strumenti e workflow di Antigravity, consulta la documentazione di Antigravity.

Strumenti e versioni supportati

Antigravity Enterprise Gateway supporta i seguenti strumenti per sviluppatori AI:

Strumento Versione minima Piattaforme supportate
App Antigravity
  • 2.15.0 o versioni successive
 macOS (Apple Silicon arm64, Intel x86_64), Windows 10 o 11 (64 bit), Linux (x86_64)
Antigravity CLI (agy)
  • 1.2.15 o versioni successive
 macOS (arm64), Linux (x86_64)
Antigravity per IDE
  • Visual Studio Code e Visual Studio: Antigravity CLI 1.2.15 o versioni successive, che l'estensione scarica e aggiorna automaticamente.
  • IDE JetBrains e Zed (con server ACP): 1.3.0 o versioni successive
 Visual Studio Code, Visual Studio, IDE JetBrains e Zed. Per saperne di più sulle estensioni IDE, consulta Estensioni Antigravity IDE.

Scegli un metodo di configurazione

La configurazione di Antigravity dipende da come viene gestito l'ambiente di sviluppo:

Workstation aziendali gestite

Se la tua azienda gestisce il tuo computer utilizzando uno strumento di gestione dei dispositivi mobili (MDM), l'amministratore esegue il deployment di un file admin_settings.json nel tuo sistema operativo.

Quando apri l'app Antigravity, esegui l'interfaccia a riga di comando di Antigravity o utilizzi Antigravity negli IDE supportati (Visual Studio Code, Visual Studio, IDE JetBrains e Zed), Antigravity rileva automaticamente queste impostazioni e indirizza le richieste al gateway aziendale senza visualizzare singoli prompt di accesso. Non è necessaria alcuna configurazione manuale.

Ambienti, container e sandbox personalizzati

Se lavori in un ambiente non gestito, ad esempio una macchina virtuale di sviluppo remoto, un container Docker, un runner CI/CD automatizzato o un IDE locale non gestito da MDM, configura Antigravity impostando le variabili di ambiente o aggiornando la configurazione dell'agente IDE.

La tabella seguente descrive le variabili di ambiente utilizzate per configurare la modalità gateway:

Variabile Obbligatorio Descrizione
AGY_LLM_GATEWAY_URL Sì L'URL HTTPS del gateway aziendale della tua organizzazione.
AGY_LLM_GATEWAY_API_KEY Sì La chiave API emessa dal gateway. Richiedi questa chiave all'amministratore.
AGY_LLM_GATEWAY_WIRE_PROTOCOL No Il protocollo di rete dell'API. Imposta su genai (predefinito) per il protocollo API Gemini o su openai per il protocollo OpenAI Chat Completions.
AGY_LLM_GATEWAY_CA_CERT No Il percorso del bundle di certificati CA radice della tua organizzazione. Se questa variabile non è impostata, Antigravity utilizza la variabile SSL_CERT_FILE standard.
AGY_LLM_GATEWAY_MODELS No Un elenco separato da virgole di modelli consentiti.
AGY_LLM_GATEWAY_HEADERS No Intestazioni HTTP personalizzate, nel formato KEY: VALUE, separate da virgole o interruzioni di riga. Utilizza queste intestazioni per il monitoraggio dei centri di costo.

Esempi di configurazione

I seguenti esempi mostrano come configurare le variabili di ambiente di Antigravity Enterprise Gateway per diversi ambienti di sviluppo:

Shell interattiva

L'esempio seguente mostra come configurare le variabili di ambiente del gateway nel tuo profilo di avvio della shell (come ~/.bashrc o ~/.zshrc) per le sessioni interattive del terminale e le estensioni IDE che si integrano con l'interfaccia a riga di comando di Antigravity (come Visual Studio Code e Visual Studio):

# Configure Antigravity Enterprise Gateway
export AGY_LLM_GATEWAY_URL="https://gateway.cymbal.com"
export AGY_LLM_GATEWAY_API_KEY="GATEWAY_API_KEY"
export AGY_LLM_GATEWAY_WIRE_PROTOCOL="genai"
export AGY_LLM_GATEWAY_CA_CERT="/etc/ssl/certs/cymbal-root-ca.pem"
export AGY_LLM_GATEWAY_HEADERS="X-Cost-Center: Platform-Engineering"
export AGY_LLM_GATEWAY_MODELS="gemini-3.8-flash,gemini-3.7-flash,gemini-3.1-pro-preview"

In questo esempio:

  • AGY_LLM_GATEWAY_URL: imposta l'endpoint HTTPS del gateway aziendale (https://gateway.cymbal.com).
  • AGY_LLM_GATEWAY_API_KEY: imposta la chiave API (GATEWAY_API_KEY) richiesta dal gateway.
  • AGY_LLM_GATEWAY_WIRE_PROTOCOL: imposta il protocollo di comunicazione dell'API su genai (predefinito) per il protocollo dell'API Gemini o su openai per il protocollo OpenAI Chat Completions.
  • AGY_LLM_GATEWAY_CA_CERT: imposta il percorso del bundle di certificati CA radice aziendale in modo che Antigravity consideri attendibile il certificato TLS del gateway.
  • AGY_LLM_GATEWAY_HEADERS: aggiunge un'intestazione personalizzata che il gateway può utilizzare per attribuire l'utilizzo al centro di costo del tuo team.
  • AGY_LLM_GATEWAY_MODELS: imposta i modelli che puoi selezionare. Per ulteriori informazioni sui modelli disponibili, consulta l'elenco dei modelli supportati.

Per applicare le modifiche, ricarica il profilo della shell:

source ~/.bashrc

Container Docker

L'esempio Dockerfile seguente configura la connessione del gateway per gli ambienti di sviluppo containerizzati e i runner CI/CD automatizzati:

FROM ubuntu:24.04

# Install prerequisites and Antigravity CLI (v1.2.15 or later)
RUN apt-get update && apt-get install -y curl ca-certificates
RUN curl -fsSL https://antigravity.google/cli/install.sh -o /tmp/install.sh \
    && bash /tmp/install.sh \
    && rm -f /tmp/install.sh

# Copy corporate root CA certificate
COPY certs/cymbal-root-ca.pem /usr/local/share/ca-certificates/cymbal-root-ca.crt
RUN update-ca-certificates

# Configure gateway connection
ENV AGY_LLM_GATEWAY_URL="https://gateway.cymbal.com" \
    AGY_LLM_GATEWAY_WIRE_PROTOCOL="genai" \
    AGY_LLM_GATEWAY_CA_CERT="/etc/ssl/certs/cymbal-root-ca.pem" \
    AGY_LLM_GATEWAY_MODELS="gemini-3.8-flash,gemini-3.1-pro-preview"

# Provide API key securely at runtime using container secrets or runtime env
ENTRYPOINT ["agy"]

In questo esempio:

  • L'immagine container installa l'interfaccia a riga di comando Antigravity e aggiunge il certificato CA radice aziendale all'archivio certificati di sistema.
  • Le impostazioni di connessione non sensibili (AGY_LLM_GATEWAY_URL, AGY_LLM_GATEWAY_WIRE_PROTOCOL, AGY_LLM_GATEWAY_CA_CERT e AGY_LLM_GATEWAY_MODELS) sono impostate come variabili di ambiente.
  • La chiave API (AGY_LLM_GATEWAY_API_KEY) non è memorizzata nell'immagine. Forniscila invece in fase di runtime utilizzando i secret del container o gli argomenti dell'ambiente (ad esempio docker run -e AGY_LLM_GATEWAY_API_KEY=...).

IDE JetBrains

Gli IDE JetBrains comunicano con Antigravity tramite il server Antigravity Agent Client Protocol (ACP). Poiché gli IDE desktop non leggono i profili di avvio della shell come ~/.bashrc, configura le impostazioni del gateway nella configurazione dell'agente IDE:

  1. In ~/.jetbrains/acp.json, configura il server dell'agente Antigravity con le variabili di ambiente del gateway:

    {
  "agent_servers": {
    "Antigravity": {
      "command": "PATH_TO_ACP_SERVER",
      "env": {
        "AGY_LLM_GATEWAY_URL": "https://gateway.cymbal.com",
        "AGY_LLM_GATEWAY_API_KEY": "GATEWAY_API_KEY",
        "AGY_LLM_GATEWAY_CA_CERT": "/etc/ssl/certs/cymbal-root-ca.pem",
        "AGY_LLM_GATEWAY_HEADERS": "X-Cost-Center: Platform-Engineering",
        "AGY_LLM_GATEWAY_MODELS": "gemini-3.8-flash,gemini-3.7-flash,gemini-3.1-pro-preview"
      }
    }
  }
}

    Sostituisci PATH_TO_ACP_SERVER con il percorso del tuo file binario agy_acp_server.

  2. In ~/.gemini/antigravity-acp/settings.json (o $GEMINI_HOME/antigravity-acp/settings.json se GEMINI_HOME è impostato), attiva l'autenticazione del gateway:

    {
  "auth": {
    "type": "gateway"
  }
}

    Nota: a differenza dell'interfaccia a riga di comando Antigravity, l'impostazione di AGY_LLM_GATEWAY_URL da sola non attiva il routing del gateway nel server ACP; è richiesta l'impostazione di "auth": { "type": "gateway" }.

  3. Riavvia l'IDE JetBrains.

Zed

Zed comunica con Antigravity tramite il server Antigravity Agent Client Protocol (ACP). Poiché gli IDE desktop non leggono i profili di avvio della shell come ~/.bashrc, configura le impostazioni del gateway nel file di impostazioni di Zed:

  1. Nel file settings.json di Zed, aggiungi il server dell'agente Antigravity con le variabili di ambiente del gateway in agent_servers:

    {
  "agent_servers": {
    "Antigravity": {
      "command": "PATH_TO_ACP_SERVER",
      "env": {
        "AGY_LLM_GATEWAY_URL": "https://gateway.cymbal.com",
        "AGY_LLM_GATEWAY_API_KEY": "GATEWAY_API_KEY",
        "AGY_LLM_GATEWAY_CA_CERT": "/etc/ssl/certs/cymbal-root-ca.pem",
        "AGY_LLM_GATEWAY_HEADERS": "X-Cost-Center: Platform-Engineering",
        "AGY_LLM_GATEWAY_MODELS": "gemini-3.8-flash,gemini-3.7-flash,gemini-3.1-pro-preview"
      }
    }
  }
}

    Sostituisci PATH_TO_ACP_SERVER con il percorso del tuo file binario agy_acp_server.

  2. In ~/.gemini/antigravity-acp/settings.json (o $GEMINI_HOME/antigravity-acp/settings.json se GEMINI_HOME è impostato), attiva l'autenticazione del gateway:

    {
  "auth": {
    "type": "gateway"
  }
}

    Nota: a differenza dell'interfaccia a riga di comando Antigravity, l'impostazione di AGY_LLM_GATEWAY_URL da sola non attiva il routing del gateway nel server ACP; è richiesta l'impostazione di "auth": { "type": "gateway" }.

  3. Riavvia Zed.

Verifica la connessione

Dopo aver configurato l'ambiente, verifica che Antigravity si connetta al gateway aziendale:

  1. Controlla l'app Antigravity:
    • Nella barra di stato in basso, verifica che lo stato della connessione sia Connesso: Enterprise Gateway.
    • In Impostazioni account, verifica che lo stato visualizzato sia Modalità Enterprise Gateway attiva.

  2. Testa l'interfaccia a riga di comando Antigravity: esegui un prompt di test nel terminale:

    agy -p "Explain binary search in Go"

    La risposta viene trasmessa in streaming nel terminale senza aprire una finestra del browser o chiederti di accedere con un account Google .

Sicurezza delle workstation e sandboxing locale

Il routing delle richieste tramite un gateway aziendale non cambia il modo in cui Antigravity protegge la tua workstation:

  • Richieste del modello: i prompt, i file di contesto e le risposte vengono instradati attraverso il gateway aziendale della tua organizzazione, dove quest'ultima può controllarli e applicare le policy.
  • Esecuzione di strumenti locali: i comandi del terminale, la creazione di file e le modifiche allo spazio di lavoro continuano a essere eseguiti all'interno della sandbox locale di Antigravity.
  • Controlli human-in-the-loop: Antigravity richiede comunque la tua approvazione prima di eseguire comandi del terminale potenzialmente distruttivi o di modificare i file sul disco.

Risoluzione dei problemi

Se si verificano errori durante la connessione al gateway, esamina le seguenti soluzioni:

Messaggio di errore Causa Come risolvere il problema
x509: certificate signed by unknown authority Il tuo ambiente non considera attendibile il certificato TLS del gateway. Imposta AGY_LLM_GATEWAY_CA_CERT sul percorso del bundle della CA radice aziendale.
401 Unauthorized Il gateway ha rifiutato la tua chiave API. Verifica che AGY_LLM_GATEWAY_API_KEY corrisponda alla chiave fornita dall'amministratore.
404 Not Found Il modello richiesto non è disponibile sul gateway aziendale o l'ID del modello è stato digitato in modo errato. Verifica che l'ID modello in AGY_LLM_GATEWAY_MODELS corrisponda a un modello supportato disponibile sul tuo gateway.
Richieste di accesso a Google di Antigravity L'URL del gateway non è impostato nella configurazione attuale della shell o dell'IDE. Per le sessioni del terminale e gli IDE integrati con l'interfaccia a riga di comando, verifica che AGY_LLM_GATEWAY_URL sia impostato nel tuo ambiente attuale. Per gli IDE JetBrains o Zed, verifica che AGY_LLM_GATEWAY_URL venga passato nel blocco env dell'agente e che "auth": { "type": "gateway" } sia configurato in ~/.gemini/antigravity-acp/settings.json.
Errore durante la menzione di AGY_LLM_GATEWAY_URL in JetBrains o Zed auth.type è impostato su gateway nelle impostazioni di ACP, ma l'IDE non ha passato la variabile al server dell'agente. Aggiungi AGY_LLM_GATEWAY_URL al blocco dell'agente env in ~/.jetbrains/acp.json (JetBrains) o settings.json (Zed), non al profilo della shell, e riavvia l'IDE.
gateway.wireProtocol 'openai' is not supported by the ACP server Le impostazioni di AGY_LLM_GATEWAY_WIRE_PROTOCOL o dell'amministratore specificano il protocollo di rete openai, che non è supportato dal server ACP. Imposta AGY_LLM_GATEWAY_WIRE_PROTOCOL="genai" nel tuo ambiente o chiedi all'amministratore di configurare il protocollo di rete genai per gli utenti di JetBrains e Zed.

Passaggi successivi