设置 Gemini Code Assist

在您可以使用 Gemini Code Assist 之前，您的团队需要执行本文档中所述的设置步骤：

1. 订阅 Gemini Code Assist。

2. 为贵组织中的个别用户分配许可。

3. 在 Google Cloud 项目中启用 Gemini for Google Cloud API。

4. 在 Google Cloud 项目中授予 Identity and Access Management (IAM) 角色。

5. 贵组织的用户安装 Gemini Code Assist 插件，以便在 IDE 中使用 Gemini Code Assist。

购买 Gemini Code Assist 订阅

如需查看每个版本提供的功能列表，请参阅支持的功能。

在 2025 年 3 月 31 日之前，Gemini Code Assist Enterprise 的价格为每位用户每月 19 美元（承诺使用期限为 12 个月）。请与我们的销售团队联系，以享受此促销优惠。

如果您与 Google Cloud 签订了现有合约，请先与我们的销售团队联系，然后再购买订阅。

1. 前往 Gemini for Google Cloud 页面。

   前往 Gemini for Google Cloud

   系统随即会打开 Gemini for Google Cloud 页面。

2. 选择获取 Gemini Code Assist。如果您的项目已安装 Gemini Code Assist，则此文本会显示 Manage Gemini Code Assist。

   系统随即会打开获取 Gemini Code Assist 订阅页面。

3. 在 Select Gemini Code Assist subscription Edition（选择 Gemini Code Assist 订阅版本）中，选择 Gemini Code Assist 版本。选择比较 Gemini Code Assist 版本，查看每个版本提供的功能的详细列表。

   然后，选择继续。

4. 在配置订阅中，填写相应字段以配置订阅，包括以下字段：

   • 订阅名称。
   • 订阅中的许可数量。请注意，如果您购买的是企业版，则必须购买至少 10 个许可。
   • 订阅期（按月或按年）。包年订阅可享受折扣价，且采用按月付款方式，而不是一次性付款。
   • 在包月或包年合约期结束后自动续订。自动续订可确保您的订阅和许可保持有效。 如果订阅未自动续订，则会在当前期限结束时终止，届时您需要重新完成购买流程并重新分配许可。

5. 如要确认订阅，请选择继续。

6. 如果您同意这些条款，请选择我同意接受此购买的条款，然后选择确认订阅。

7. 选择下一步：管理 Gemini 许可分配。

Gemini Code Assist 的订阅现已购买。现在，您需要管理贵组织中的 Gemini 许可分配。

分配许可

在使用 Gemini Code Assist 之前，贵组织中的每个用户都需要获得许可。

    {
        "usernames": [
                  "dana@example.com",
                  "lee@example.com"
        ]
    }

{}

现在，您需要在与此结算账号关联的一个或多个项目中启用 Gemini for Google Cloud API。在您至少在一个项目中启用 Gemini Code Assist 之前，用户不会看到 Gemini Code Assist。

在 Google Cloud 项目中启用 Gemini for Google Cloud API

本部分介绍了在 Google Cloud 项目中启用 Gemini for Google Cloud API 所需的步骤。

现在，具有所需 IAM 角色的所有用户都可以在指定的 Google Cloud 项目中使用 Gemini for Google Cloud。

面向防火墙后面用户的必需 API

除了启用 Gemini for Google Cloud API 之外，在防火墙后面的用户可能还需要启用以下 API：

• oauth2.googleapis.com：用于登录 Google Cloud。
• serviceusage.googleapis.com：用于检查用户的 Gemini Code Assist 项目是否配置正确。
• cloudaicompanion.googleapis.com：适用于 Google Cloud 的主要 Gemini API 端点。
• cloudcode-pa.googleapis.com：提供与 IDE 相关功能的内部 API。
• cloudresourcemanager.googleapis.com：在 IDE 中用于项目选择器。如果项目已在 settings.json 文件中明确配置，则可能不需要 Resource Manager API。
• people.googleapis.com：提供对个人资料和联系人相关信息的访问权限。
• firebaselogging-pa.googleapis.com：一个内部 API，用于发送产品遥测数据，包括有关用户是否接受了建议的事件。
• feedback-pa.googleapis.com：用于提交 IDE 内反馈的内部 API。
• apihub.googleapis.com：供 Cloud Code API 浏览器功能使用。

可选：配置 VPC Service Controls

如果贵组织有服务边界，则必须将以下资源添加到边界：

• Gemini for Google Cloud API
• Gemini Code Assist API

如果您是在服务边界之外使用 Gemini Code Assist，则还需要修改入站政策，以允许访问这些服务。

如需了解详情，请参阅为 Gemini 配置 VPC Service Controls。

在 Google Cloud 项目中授予 IAM 角色

本部分介绍了向用户授予 Gemini for Google Cloud User 和 Service Usage Consumer IAM 角色所需的步骤。

所有被授予这些角色的用户都可以在指定项目的 Google Cloud 控制台中访问 Gemini for Google Cloud 功能。如需了解详情，请参阅 Gemini for Google Cloud 概览。

在 IDE 中安装 Gemini Code Assist 插件

贵组织的用户在其首选 IDE 中安装 Gemini Code Assist。如需了解详情，请参阅以下内容：

• Cloud Workstations： 使用 Gemini Code Assist 进行编码
• Cloud Shell 编辑器：使用 Gemini Code Assist 编写代码
• VS Code： 使用 Gemini Code Assist 编写代码
• IntelliJ 和其他 JetBrains IDE：使用 Gemini Code Assist 编写代码

高级设置任务

您可以执行以下任一操作，而不是使用 Google Cloud 控制台或 gcloud CLI 授予预定义的 IAM 角色：

• 使用 IAM REST API 或 IAM 客户端库授予角色。

  如果您使用这些接口，请使用完全限定的角色名称：

  • roles/cloudaicompanion.user
  • roles/serviceusage.serviceUsageConsumer

  如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

• 创建和授予自定义角色。

  您创建的任何自定义角色都需要具备以下权限，您才能访问 Gemini Code Assist：

  • cloudaicompanion.companions.generateChat
  • cloudaicompanion.companions.generateCode
  • cloudaicompanion.instances.completeCode
  • cloudaicompanion.instances.completeTask
  • cloudaicompanion.instances.generateCode
  • cloudaicompanion.instances.generateText
  • serviceusage.services.enable

• 分配和管理许可。

  您创建的任何自定义角色都需要具备以下权限，您才能访问 Gemini Code Assist：

  • consumerprocurement.orders.get
  • consumerprocurement.orders.licensePools..*
  • consumerprocurement.orders.licensePools.update
  • consumerprocurement.orders.licensePools.get
  • consumerprocurement.orders.licensePools.assign
  • consumerprocurement.orders.licensePools.unassign
  • consumerprocurement.orders.licensePools.enumerateLicensedUsers

另请注意，如需上述任何权限正常运行，您需要在分配各项权限的同一 Google Cloud 项目中启用 Gemini for Google Cloud API。

后续步骤

• 详细了解 Gemini for Google Cloud 提供的生成式 AI 辅助类型。
• 了解 Google Cloud 专用 Gemini 如何使用您的数据。
• 了解如何访问和管理 Gemini Code Assist 管理控制台。
• 了解如何配置代码自定义。
• 为 Gemini 配置 VPC Service Controls。