---
url: /antigravity/enterprise.md
description: >-
  了解如何配置 Google Cloud 环境以启用 Antigravity 与 Gemini Enterprise Agent
  平台的集成，包含基本设置、用户权限及高级配置。
---

# 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]
> 注意：如果您不打算保留在此过程中创建的资源，请创建新项目而不是选择现有项目。完成这些步骤后，您可以删除项目以移除所有相关联的资源。

[前往项目选择器](https://console.cloud.google.com/projectselector)

### 步骤 2：验证结算

验证您的 Google Cloud 项目是否已启用结算功能。您可以在 Google Cloud Billing 控制台中检查结算状态。有关详细说明，请参阅[验证项目的结算状态](https://cloud.google.com/billing/docs/how-to/verify-billing-enabled)。

### 步骤 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](https://console.cloud.google.com/apis/library/aiplatform.googleapis.com)

## 用户权限 (User Permissions)

要获取使用 Gemini Enterprise Agent 平台所需的权限，请联系管理员为您授予项目上的 Agent Platform User 角色 (roles/aiplatform.user)。有关授予角色的更多信息，请参阅[管理对项目、文件夹和组织的访问权限](https://cloud.google.com/iam/docs/granting-changing-revoking-access)。

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

## 高级配置 (Advanced Configuration)

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

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

[请求和响应日志记录文档](https://cloud.google.com/vertex-ai/generative-ai/docs/multimodal/configure-logging)

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

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

* Agent Platform API (aiplatform.googleapis.com)

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

[VPC Service Controls 文档](https://cloud.google.com/vpc-service-controls/docs/overview)

## 补充资源 (Complementary Resources)

### 消费选项 (Consumption Options)

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

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

[消费选项文档](https://cloud.google.com/vertex-ai/pricing)

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

目前，Antigravity CLI 和 2.0 提供 3 个端点：global（全局）、multi-region eu（多区域欧洲）和 multi-region us（多区域美国）。

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

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

[部署端点文档](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations)