设置 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. 贵组织的用户安装 Cloud Code 插件，以便在 IDE 中使用 Gemini Code Assist。

购买 Gemini Code Assist 订阅

购买 Gemini Code Assist 订阅所需的步骤 取决于您购买的版本：企业版或 标准。如需查看各个版本提供的功能列表，请参阅支持的功能。

企业版

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

标准版

Gemini Code Assist 标准版可在 2024 年 11 月 8 日之前免费试用，无需订阅，每个结算账号仅限一位用户使用。每个结算账号有多个用户的组织需要购买 订阅（如本节所述）。

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

1. 前往 Google Cloud 专用 Gemini 页面。

   前往适用于 Google Cloud 的 Gemini

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

2. 点击获取 Gemini Code Assist。如果您的项目已启用 Gemini Code Assist，则此文本会显示 Manage Gemini Code Assist（管理 Gemini Code Assist）。

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

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

   • 订阅名称。
   • 订阅中的许可数量。
   • 订阅期（按月或按年）。包年订阅采用按月付款方式，而不是一次性付款，并且享受折扣优惠。
   • 在承诺期限（按月）后自动续订您的订阅 或每年）。自动续订会将您的订阅和许可保持有效状态。 如果订阅没有自动续订，则将在当前订阅期结束时结束。 您需要重新执行购买流程 许可。

4. 如需查看订阅详情，请点击继续。

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

6. 点击 Next: Manage Gemini License Assignments。

您现已购买 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。

适用于 Google Cloud 的 Gemini 现已在 拥有该角色的所有用户 所需的 IAM 角色。

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

除了启用 Gemini for Google Cloud API 之外，受防火墙保护的用户还可能会 还需要启用以下 API：

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

在 Google Cloud 项目中授予 IAM 角色

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

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

安装 Cloud Code 插件以在 IDE 中使用 Gemini Code Assist

贵组织的用户会在自己的 首选的 IDE如需了解详情，请参阅以下内容：

• Cloud Workstations： 使用 Gemini Code Assist 编写代码
• Cloud Shell Editor： 使用 Gemini Code Assist 编写代码
• 适用于 VS Code 的 Cloud Code： 使用 Gemini Code Assist 编写代码
• Cloud Code for 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 才能正常运行。

后续步骤

• 详细了解 适用于 Google Cloud 的 Gemini Code Assist 中提供的各种生成式 AI 辅助功能。
• 了解 Google Cloud 专用 Gemini Code Assist 如何使用您的数据。
• 了解 如何访问和管理 Gemini Code Assist 管理员控件。
• 了解如何配置代码自定义。