將 Antigravity 連結至 Enterprise Gateway

互動式殼層

以下範例說明如何在殼層啟動設定檔 (例如 ~/.bashrc 或 ~/.zshrc) 中，為與 Antigravity CLI 整合的互動式終端機工作階段和 IDE 擴充功能 (例如 Visual Studio Code 和 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"

在這個例子中：

• AGY_LLM_GATEWAY_URL：設定企業閘道的 HTTPS 端點 (https://gateway.cymbal.com)。
• AGY_LLM_GATEWAY_API_KEY：設定閘道所需的 API 金鑰 (GATEWAY_API_KEY)。
• AGY_LLM_GATEWAY_WIRE_PROTOCOL：將 API 線路通訊協定設為 genai (預設)，用於 Gemini API 通訊協定，或設為 openai，用於 OpenAI Chat Completions 通訊協定。
• AGY_LLM_GATEWAY_CA_CERT：設定企業根 CA 憑證套裝組合的路徑，讓 Antigravity 信任閘道的 TLS 憑證。
• AGY_LLM_GATEWAY_HEADERS：新增自訂標頭，讓閘道能將用量歸因於團隊的成本中心。
• AGY_LLM_GATEWAY_MODELS：設定可選取的模型。如要進一步瞭解可用模型，請參閱支援的模型清單。

如要套用變更，請重新載入殼層設定檔：

source ~/.bashrc

Docker 容器

下列 Dockerfile 範例會為容器化開發環境和自動化 CI/CD 執行器設定閘道連線：

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

在這個例子中：

• 容器映像檔會安裝 Antigravity CLI，並將企業根 CA 憑證新增至系統憑證存放區。
• 非機密連線設定 (AGY_LLM_GATEWAY_URL、AGY_LLM_GATEWAY_WIRE_PROTOCOL、AGY_LLM_GATEWAY_CA_CERT 和 AGY_LLM_GATEWAY_MODELS) 會設為環境變數。
• API 金鑰 (AGY_LLM_GATEWAY_API_KEY) 不會儲存在映像檔中。請改用容器密鑰或環境引數 (例如 docker run -e AGY_LLM_GATEWAY_API_KEY=...)，在執行階段提供。

JetBrains IDE

JetBrains IDE 會透過 Antigravity 代理程式用戶端通訊協定 (ACP) 伺服器與 Antigravity 通訊。由於電腦版 IDE 不會讀取殼層啟動設定檔 (例如 ~/.bashrc)，因此請在 IDE 代理程式設定中調整閘道設定：

1. 在 ~/.jetbrains/acp.json 中，使用閘道環境變數設定 Antigravity 代理程式伺服器：

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

   將 PATH_TO_ACP_SERVER 替換為 agy_acp_server 二進位檔的路徑。

2. 在 ~/.gemini/antigravity-acp/settings.json (如果已設定 GEMINI_HOME，則為 $GEMINI_HOME/antigravity-acp/settings.json) 中，開啟閘道驗證：

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

   注意：與 Antigravity CLI 不同，單獨設定 AGY_LLM_GATEWAY_URL 不會啟用 ACP 伺服器中的閘道路徑，必須設定 "auth": { "type": "gateway" }。

3. 重新啟動 JetBrains IDE。

Zed

Zed 會透過 Antigravity 代理程式用戶端通訊協定 (ACP) 伺服器與 Antigravity 通訊。由於電腦版 IDE 不會讀取 ~/.bashrc 等殼層啟動設定檔，因此請在 Zed 的設定檔中調整閘道設定：

1. 在 Zed settings.json 檔案中，將 Antigravity 代理程式伺服器和閘道環境變數新增至 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"
         }
       }
     }
   }

   將 PATH_TO_ACP_SERVER 替換為 agy_acp_server 二進位檔的路徑。

2. 在 ~/.gemini/antigravity-acp/settings.json (如果已設定 GEMINI_HOME，則為 $GEMINI_HOME/antigravity-acp/settings.json) 中，開啟閘道驗證：

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

   注意：與 Antigravity CLI 不同，單獨設定 AGY_LLM_GATEWAY_URL 不會啟用 ACP 伺服器中的閘道路徑，必須設定 "auth": { "type": "gateway" }。

3. 重新啟動 Zed。