为美国公共部门部署 Antigravity 应用和 Antigravity CLI

您可以将 Antigravity 应用和 Antigravity CLI 部署在 FedRAMP High、IL4、IL5、ITAR 和 CJIS 数据边界环境中，以便与 Gemini 平台搭配使用。

按照以下说明配置 Antigravity 应用和 Antigravity CLI，以支持美国公共部门组织和企业客户所需的监管标准和类似准则。偏离本页面中的步骤可能会导致配置不合规。

第三方评估组织 (3PAO) 已验证，这些部署说明允许 Antigravity 应用和 Antigravity CLI 仅与一个美国云服务 API 区域端点通信。aiplatform.us.rep.googleapis.com API 端点已受 Assured Workloads 数据边界支持，适用于 FedRAMP 高风险级别、IL4、IL5、ITAR 和 CJIS。如需了解详情，请参阅 Coalfire 对 Antigravity 应用和 CLI 的评估。

前提条件

部署 Antigravity 应用和 Antigravity CLI

完成以下步骤，部署 Antigravity 应用和 Antigravity CLI，并配置本地环境和客户端，以满足组织的安全预期：

  1. 在本地下载 Antigravity 应用和 Antigravity CLI。
  2. 在 Assured Workloads 文件夹中创建一个项目，并启用 API 访问权限。如需查看相关说明，请参阅 Google Cloud 项目和 API 设置部分。
  3. 根据用户和客户端的情况，配置对 Antigravity 的身份验证。您可以使用 Cloud Identity（用于与外部身份提供方或系统联合）和 Google Cloud 服务账号向 Antigravity 进行身份验证。

  4. 使用应用默认凭证登录 Antigravity，如下所示：

    • 使用 Antigravity 桌面客户端时：

      1. 在 Assured Workloads 文件夹中选择一个项目。
      2. 选择美国境内的地点。

    • 使用 Antigravity CLI 时：

      1. 使用 Google Cloud CLI 配置配额项目：

        gcloud auth application-default set-quota-project QUOTA_PROJECT_ID

        将 QUOTA_PROJECT_ID 替换为 Assured Workloads 文件夹中的项目 ID。

      2. 设置以下环境变量： 

        export AGY_ADC_AUTH=true
export GOOGLE_CLOUD_LOCATION=us
export AGY_CLI_DISABLE_AUTO_UPDATE=true

连接到受支持的模型

FedRAMP High、IL4、IL5、ITAR 和 CJIS 支持以下模型：

  • Gemini 3.6 Flash
  • Gemini 3.7 Flash
  • Gemini 3.8 Flash

如需连接到支持美国公共部门合规性要求的模型版本，请选择美国作为基本端点 URI。您必须选择美国，以确保提示和回答符合美国公共部门客户的特定要求。如需查看相关说明，请参阅区域级端点和网络许可清单。

停用可选 API

Antigravity 应用和 Antigravity CLI 会调用其他后端 API，但并非所有 API 都符合美国公共部门的要求。这些 API 对于产品的核心功能而言并非必需。为确保部署符合法规要求，请停用从本地环境调用以下 API 的功能：

  • aiplatform.*.rep.googleapis.com 中的所有非美国多区域端点（aiplatform.us.rep.googleapis.com 除外）
  • antigravity.google
  • *.antigravity.google
  • antigravity.google.com
  • *.antigravity.google.com
  • antigravity-cli-auto-updater-974169037036.us-central1.run.app
  • antigravity-hub-auto-updater-974169037036.us-central1.run.app
  • antigravity-unleash.goog
  • businessaicode.googleapis.com
  • chromewebstore.google.com
  • cloudcode-pa.googleapis.com
  • aicode.googleapis.com
  • daily-cloudcode-pa.googleapis.com
  • play.googleapis.com

如需在本地环境中停用这些端点，请应用以下控制措施：

  • 网络和代理规则：在企业 Web 代理、防火墙或 DNS 政策中，阻止向所列网域发出的出站请求，同时仍允许流量流向 aiplatform.us.rep.googleapis.com 端点。
  • 端点使用组织政策：在文件夹或项目级层配置 constraints/gcp.restrictEndpointUsage 组织政策限制条件，以拒绝 in:non-us-aiplatform-endpoints 值组（该值组会屏蔽全球和美国境外的 Gemini Enterprise Agent Platform 端点）以及 businessaicode.googleapis.com、businessaicode.us.rep.googleapis.com 和 businessaicode.eu.rep.googleapis.com 端点。如需查找 Agent Platform 支持的多区域端点，请参阅多区域端点。如需了解如何配置此限制条件及其精选值组，请参阅限制端点使用。
  • 项目 API 管理：在 Assured Workloads 项目中停用 businessaicode.googleapis.com 和 cloudaicompanion.googleapis.com API（如果已启用）。cloudcode-pa.googleapis.com 端点是 Google 内部客户端端点，您无法通过 Service Usage 启用或停用该端点，而必须使用网络或代理规则来屏蔽该端点。如需了解详情，请参阅停用服务。
  • 自动 CLI 更新：设置 AGY_CLI_DISABLE_AUTO_UPDATE=true 环境变量，以帮助防止 Antigravity CLI 在启动时查询 antigravity-cli-auto-updater-974169037036.us-central1.run.app 端点。

支持 SSL/TLS 检查和证书

Antigravity 应用和 CLI 会自动查询并使用主机操作系统的受信任根存储区，例如 Linux 上的 /etc/ssl/certs、Windows 上的 Windows 证书存储区以及 macOS 上的钥匙串。

如果您将企业的公司 CA 证书软件包部署到客户端操作系统，Antigravity 会自动信任受检查的 SSL/TLS 环境并在其中运行。您不需要自定义 CA 替换。

如果您使用企业代理，则 Go 语言的 HTTP 传输支持系统的标准代理环境变量。在运行 Antigravity 的机器上配置以下变量：

  • HTTP_PROXY
  • HTTPS_PROXY
  • NO_PROXY

如需了解详情，请参阅设置。