Conectar o Antigravity a um gateway empresarial

Este documento mostra aos desenvolvedores que usam o Gemini Enterprise como conectar o Google Antigravity a um gateway empresarial de uma estação de trabalho, contêiner ou sandbox de desenvolvedor.

Se a organização aplicar controles de rede rígidos que bloqueiam conexões de Internet diretas com os serviços do Google, o Antigravity Enterprise Gateway vai rotear as solicitações de desenvolvimento por um gateway empresarial operado pela organização. Essa configuração permite que você use o Antigravity sem concluir o login interativo no navegador. Para saber mais sobre os recursos, as ferramentas e os fluxos de trabalho do Antigravity, consulte a documentação do Antigravity.

Ferramentas e versões compatíveis

O Antigravity Enterprise Gateway é compatível com as seguintes ferramentas para desenvolvedores de IA:

Ferramenta Versão mínima Plataformas compatíveis
App Antigravity
  • 2.15.0 ou mais recente
 macOS (Apple silicon arm64, Intel x86_64), Windows 10 ou 11 (64 bits), Linux (x86_64)
CLI do Antigravity (agy)
  • 1.2.15 ou mais recente
 macOS (arm64), Linux (x86_64)
Antigravity para IDEs
  • Visual Studio Code e Visual Studio: CLI do Antigravity 1.2.15 ou mais recente, que a extensão baixa e atualiza automaticamente.
  • Ambientes de desenvolvimento integrado do JetBrains e Zed (com servidor ACP): 1.3.0 ou mais recente
 Visual Studio Code, Visual Studio, ambientes de desenvolvimento integrado JetBrains e Zed. Para mais informações sobre extensões de IDE, consulte Extensões de IDE Antigravity.

Escolher um método de configuração

A configuração do Antigravity depende de como seu ambiente de desenvolvimento é gerenciado:

Estações de trabalho corporativas gerenciadas

Se a empresa gerencia seu computador usando uma ferramenta de gerenciamento de dispositivos móveis (MDM), o administrador implanta um arquivo admin_settings.json no seu sistema operacional.

Quando você abre o app Antigravity, executa a CLI do Antigravity ou usa o Antigravity em ambientes de desenvolvimento integrado compatíveis (Visual Studio Code, Visual Studio, ambientes de desenvolvimento integrado do JetBrains e Zed), o Antigravity detecta automaticamente essas configurações e encaminha as solicitações para o gateway corporativo sem mostrar solicitações de login individuais. Não é necessário fazer configurações manuais.

Ambientes, contêineres e sandboxes personalizados

Se você trabalha em um ambiente não gerenciado, como uma máquina virtual de desenvolvimento remoto, um contêiner do Docker, um executor de CI/CD automatizado ou um ambiente de desenvolvimento integrado local que não é gerenciado pelo MDM, configure o Antigravity definindo variáveis de ambiente ou atualizando a configuração do agente do ambiente de desenvolvimento integrado.

A tabela a seguir descreve as variáveis de ambiente usadas para configurar o modo de gateway:

Variável Obrigatório Descrição
AGY_LLM_GATEWAY_URL Sim O URL HTTPS do gateway corporativo da sua organização.
AGY_LLM_GATEWAY_API_KEY Sim A chave de API emitida pelo gateway. Peça essa chave ao administrador.
AGY_LLM_GATEWAY_WIRE_PROTOCOL Não O protocolo de transmissão da API. Defina como genai (padrão) para o protocolo da API Gemini ou openai para o protocolo Chat Completions da OpenAI.
AGY_LLM_GATEWAY_CA_CERT Não O caminho para o pacote de certificados de CA raiz da sua organização. Se essa variável não for definida, o Antigravity vai usar a variável padrão SSL_CERT_FILE.
AGY_LLM_GATEWAY_MODELS Não Uma lista separada por vírgulas de modelos permitidos.
AGY_LLM_GATEWAY_HEADERS Não Cabeçalhos HTTP personalizados, no formato KEY: VALUE, separados por vírgulas ou quebras de linha. Use esses cabeçalhos para rastrear o centro de custo.

Exemplos de configuração

Os exemplos a seguir mostram como configurar as variáveis de ambiente do Antigravity Enterprise Gateway para diferentes ambientes de desenvolvimento:

Shell interativo

O exemplo a seguir mostra como configurar variáveis de ambiente de gateway no perfil de inicialização do shell (como ~/.bashrc ou ~/.zshrc) para sessões de terminal interativas e extensões de ambiente de desenvolvimento integrado que se integram à CLI do Antigravity (como o Visual Studio Code e o 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"

Neste exemplo:

  • AGY_LLM_GATEWAY_URL: define o endpoint HTTPS do gateway corporativo (https://gateway.cymbal.com).
  • AGY_LLM_GATEWAY_API_KEY: define a chave de API (GATEWAY_API_KEY) exigida pelo gateway.
  • AGY_LLM_GATEWAY_WIRE_PROTOCOL: define o protocolo de transmissão da API como genai (padrão) para o protocolo da API Gemini ou openai para o protocolo Chat Completions da OpenAI.
  • AGY_LLM_GATEWAY_CA_CERT: define o caminho para o pacote de certificados de CA raiz corporativa para que o Antigravity confie no certificado TLS do gateway.
  • AGY_LLM_GATEWAY_HEADERS: adiciona um cabeçalho personalizado que o gateway pode usar para atribuir o uso ao centro de custo da sua equipe.
  • AGY_LLM_GATEWAY_MODELS: define os modelos que você pode selecionar. Para mais informações sobre os modelos disponíveis, consulte a lista de modelos compatíveis.

Para aplicar as mudanças, atualize o perfil do shell:

source ~/.bashrc

Contêiner do Docker

O exemplo de Dockerfile a seguir configura a conexão do gateway para ambientes de desenvolvimento conteinerizados e executores de CI/CD automatizados:

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

Neste exemplo:

  • A imagem do contêiner instala a CLI do Antigravity e adiciona o certificado de CA raiz corporativo ao repositório de certificados do sistema.
  • As configurações de conexão não sensíveis (AGY_LLM_GATEWAY_URL, AGY_LLM_GATEWAY_WIRE_PROTOCOL, AGY_LLM_GATEWAY_CA_CERT e AGY_LLM_GATEWAY_MODELS) são definidas como variáveis de ambiente.
  • A chave de API (AGY_LLM_GATEWAY_API_KEY) não é armazenada na imagem. Em vez disso, forneça-a no ambiente de execução usando secrets de contêiner ou argumentos de ambiente (por exemplo, docker run -e AGY_LLM_GATEWAY_API_KEY=...).

IDEs da JetBrains

Os ambientes de desenvolvimento integrado do JetBrains se comunicam com o Antigravity pelo servidor do Protocolo de Cliente do Agente do Antigravity (ACP). Como os ambientes de desenvolvimento integrado para computador não leem perfis de inicialização do shell, como ~/.bashrc, defina as configurações do gateway na configuração do agente do ambiente de desenvolvimento integrado:

  1. Em ~/.jetbrains/acp.json, configure o servidor do agente do Antigravity com as variáveis de ambiente do 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"
      }
    }
  }
}

    Substitua PATH_TO_ACP_SERVER pelo caminho para o binário agy_acp_server.

  2. Em ~/.gemini/antigravity-acp/settings.json (ou $GEMINI_HOME/antigravity-acp/settings.json se GEMINI_HOME estiver definido), ative a autenticação do gateway:

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

    Observação: ao contrário da CLI do Antigravity, definir apenas AGY_LLM_GATEWAY_URL não ativa o roteamento de gateway no servidor ACP. É necessário definir "auth": { "type": "gateway" }.

  3. Reinicie o ambiente de desenvolvimento integrado da JetBrains.

Zed

O Zed se comunica com o Antigravity pelo servidor do Protocolo de Cliente do Agente (ACP) do Antigravity. Como os ambientes de desenvolvimento integrado para computador não leem perfis de inicialização do shell, como ~/.bashrc, defina as configurações do gateway no arquivo de configurações do Zed:

  1. No arquivo settings.json do Zed, adicione o servidor do agente do Antigravity com as variáveis de ambiente do gateway em 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"
      }
    }
  }
}

    Substitua PATH_TO_ACP_SERVER pelo caminho para o binário agy_acp_server.

  2. Em ~/.gemini/antigravity-acp/settings.json (ou $GEMINI_HOME/antigravity-acp/settings.json se GEMINI_HOME estiver definido), ative a autenticação do gateway:

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

    Observação: ao contrário da CLI do Antigravity, definir apenas AGY_LLM_GATEWAY_URL não ativa o roteamento de gateway no servidor ACP. É necessário definir "auth": { "type": "gateway" }.

  3. Reinicie o Zed.

Verifique sua conexão

Depois de configurar o ambiente, verifique se o Antigravity se conecta ao gateway corporativo:

  1. Verifique o app Antigravity:
    • Na barra de status inferior, verifique se o status da conexão mostra Conectado: gateway empresarial.
    • Em Configurações da conta, verifique se o status mostra Modo de gateway empresarial ativo.

  2. Teste a CLI do Antigravity: execute um comando de teste no terminal:

    agy -p "Explain binary search in Go"

    A resposta é transmitida no terminal sem abrir uma janela do navegador ou pedir que você faça login com uma conta do Google .

Segurança da estação de trabalho e sandbox local

O roteamento de solicitações por um gateway empresarial não muda a forma como o Antigravity protege sua estação de trabalho:

  • Solicitações de modelo: comandos, arquivos de contexto e respostas são roteados pelo gateway empresarial da sua organização, onde ela pode auditá-los e aplicar políticas.
  • Execução de ferramentas locais: os comandos do terminal, a criação de arquivos e as mudanças no espaço de trabalho continuam sendo executados no sandbox local do Antigravity.
  • Controles human-in-the-loop: o Antigravity ainda exige sua aprovação antes de executar comandos de terminal potencialmente destrutivos ou alterar arquivos no disco.

Solução de problemas

Se você encontrar erros ao se conectar ao gateway, consulte as seguintes soluções:

Mensagem de erro Causa Como corrigir
x509: certificate signed by unknown authority Seu ambiente não confia no certificado TLS do gateway. Defina AGY_LLM_GATEWAY_CA_CERT como o caminho do pacote de CA raiz corporativo.
401 Unauthorized O gateway rejeitou sua chave de API. Verifique se AGY_LLM_GATEWAY_API_KEY corresponde à chave fornecida pelo administrador.
404 Not Found O modelo solicitado não está disponível no gateway corporativo ou o ID do modelo foi digitado incorretamente. Verifique se o ID do modelo em AGY_LLM_GATEWAY_MODELS corresponde a um modelo compatível disponível no gateway.
O Antigravity solicita o login do Google O URL do gateway não está definido na configuração atual do shell ou do ambiente de desenvolvimento integrado. Para sessões de terminal e IDEs integrados à CLI, verifique se AGY_LLM_GATEWAY_URL está definido no ambiente atual. Para ambientes de desenvolvimento integrado do JetBrains ou Zed, verifique se AGY_LLM_GATEWAY_URL é transmitido no bloco env do agente e se "auth": { "type": "gateway" } está configurado em ~/.gemini/antigravity-acp/settings.json.
Erro ao mencionar AGY_LLM_GATEWAY_URL no JetBrains ou no Zed auth.type está definido como gateway nas configurações do ACP, mas o ambiente de desenvolvimento integrado não transmitiu a variável para o servidor do agente. Adicione AGY_LLM_GATEWAY_URL ao bloco env do agente em ~/.jetbrains/acp.json (JetBrains) ou settings.json (Zed), não ao perfil do shell, e reinicie o ambiente de desenvolvimento integrado.
gateway.wireProtocol 'openai' is not supported by the ACP server As configurações de AGY_LLM_GATEWAY_WIRE_PROTOCOL ou do administrador especificam o protocolo de transmissão openai, que não é compatível com o servidor ACP. Defina AGY_LLM_GATEWAY_WIRE_PROTOCOL="genai" no seu ambiente ou peça ao administrador para configurar o protocolo de conexão genai para usuários do JetBrains e do Zed.

A seguir