Skip to content

Antigravity 与 Gemini 企业版 Agent 平台快速入门 (Getting Started with Antigravity and Gemini Enterprise Agent Platform)

本指南适用于正在配置 Google Cloud 环境以启用 Antigravity 与 Gemini Enterprise Agent 平台集成的管理员。此集成允许企业开发人员在您自己的 Google Cloud 项目中托管的模型下使用 Antigravity,这适用于 Google Cloud 服务条款,能够满足私有网络和数据驻留的要求,并支持基于用量的计费模式。

基本设置 (Basic Setup)

前提条件 (Prerequisites)

在开始之前,请确保您已拥有:

  • 一个 Google Cloud 账号。
  • 访问 Google Cloud 控制台的权限。

步骤 1:选择或创建 Google Cloud 项目

在 Google Cloud 控制台的项目选择器页面中,选择或创建一个 Google Cloud 项目。

选择或创建项目所需的 IAM 角色

  • 选择项目:选择项目不需要特定的 IAM 角色——您可以选择已被授予角色的任何项目。

[!NOTE] 注意:要切换到不同的 Google Cloud 项目或位置,您必须先注销 Antigravity CLI 或 Hub,然后重新登录并选择您的新项目/位置。目前不支持在登录状态下直接更改项目或位置。

  • 创建项目:要创建项目,您需要项目创建者角色 (roles/resourcemanager.projectCreator),该角色包含 resourcemanager.projects.create 权限。了解如何授予角色。

[!NOTE] 注意:如果您不打算保留在此过程中创建的资源,请创建新项目而不是选择现有项目。完成这些步骤后,您可以删除项目以移除所有相关联的资源。

前往项目选择器

步骤 2:验证结算

验证您的 Google Cloud 项目是否已启用结算功能。您可以在 Google Cloud Billing 控制台中检查结算状态。有关详细说明,请参阅验证项目的结算状态

步骤 3:启用 Agent Platform API

要将 Antigravity 与 Gemini Enterprise Agent 平台结合使用,您必须启用 Agent Platform API (aiplatform.googleapis.com)。

启用 API 所需的 IAM 角色

要启用 API,您需要 Service Usage Admin IAM 角色 (roles/serviceusage.serviceUsageAdmin),该角色包含 serviceusage.services.enable 权限。了解如何授予角色。

启用 API

在 API 库中启用 Agent Platform API

用户权限 (User Permissions)

要获取使用 Gemini Enterprise Agent 平台所需的权限,请联系管理员为您授予项目上的 Agent Platform User 角色 (roles/aiplatform.user)。有关授予角色的更多信息,请参阅管理对项目、文件夹和组织的访问权限

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

高级配置 (Advanced Configuration)

请求和响应日志记录 (Request and Response Logging)

有关如何为 Gemini Enterprise Agent 平台启用和配置请求与响应日志记录的详细说明,请参阅官方文档:

请求和响应日志记录文档

VPC 服务安全通道 (VPC Service Controls)

如果您的组织配置了服务周边,那么您必须将以下资源添加到您的周边:

  • Agent Platform API (aiplatform.googleapis.com)

有关如何配置 VPC Service Controls 的详细说明,请参阅官方文档:

VPC Service Controls 文档

补充资源 (Complementary Resources)

消费选项 (Consumption Options)

Gemini Enterprise Agent 平台提供不同的消费选项以满足您的需求。

有关消费选项的详细信息,请参阅官方文档:

消费选项文档

部署与端点位置 (Deployments and Endpoints Locations)

目前,Antigravity CLI 和 2.0 提供 3 个端点:global(全局)、multi-region eu(多区域欧洲)和 multi-region us(多区域美国)。

[!NOTE] 注意:图像生成目前在欧洲 (eu) 和美国 (us) 的位置不可用。

有关可用位置和部署端点的完整列表,请参阅官方文档:

部署端点文档

Gemini中文文档