设置 Gemini Code Assist

注意 ：Gemini Code Assist 可在 11 月之前免费试用 2024 年 8 月 1 日，每个结算账号仅限一位用户使用。组织可以点击此处购买许可。

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

1. 可选：购买 Gemini Code Assist 订阅。Gemini Code Assist 可免费试用，直到 自 2024 年 11 月 8 日起，每个结算账号仅限一位用户。

2. 在 Google Cloud 项目中启用 Gemini for Google Cloud API。 通常由管理员执行此步骤。

3. 在 Google Cloud 项目中授予 Identity and Access Management (IAM) 角色。此步骤通常由管理员执行。

4. 安装 Cloud Code 插件即可使用 IDE 中的 Gemini Code Assist。

可选：购买 Gemini Code Assist 订阅

Gemini Code Assist 可在 2024 年 11 月 8 日之前免费试用，无需订阅，每个结算账号仅限一位用户使用。每个结算账号有多个用户的组织需要购买 订阅，如本节所述。如果您已与 Google 签订合同 请与我们的销售 Google Cloud 联系，然后再购买 订阅。

注意：您必须拥有 billing.subscriptions.create Identity and Access Management (IAM) 权限，才能购买 Gemini 订阅。billing.subscriptions.create 权限包含在 roles/billing.admin IAM 角色、 也可以为自定义角色添加相应权限。

1. 在 Google Cloud 控制台中，前往 Google Cloud 专用 Gemini 页面。

   前往 Google Cloud 专用 Gemini

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

2. 选择 Gemini Code Assist。

   系统会显示 Gemini Code Assist 面板。

3. 点击获取 Gemini Code Assist。

4. 如果出现提示，请选择结算账号，然后点击 前往 Gemini 的“管理”页面。

   系统随即会打开购买 Gemini Code Assist 订阅页面。

5. 在配置订阅中，填写相应字段以配置 订阅，包括承诺期限（包月或包年）和 订阅的许可数。

   注意：包年订阅的费用是按月收取折扣后的包年价格，而不是一次性付清。

   选择是否要在以下日期后自动续订 承诺期限（按月或按年）。自动续订功能可保持订阅 个有效许可。如果订阅没有自动续订，将于以下时间结束： 当前订阅期结束，您需要完成购买流程 以重新获得许可。

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

7. 如果您同意这些条款，请点击完成购买，然后确认订阅。

Gemini 现已启用结算功能。您现在需要 启用 Gemini for Google Cloud API 在与此结算账号关联的一个或多个项目中。用户 只有在你至少启用一个 Gemini 后，它才会看到它 项目。

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

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

控制台

1. 如需启用 Gemini for Google Cloud API，请前往 Gemini for Google Cloud 页面。

   前往适用于 Google Cloud 的 Gemini

2. 在项目选择器中，选择一个项目。

3. 点击启用。

   该页面会更新并显示已启用状态。 现在，具有所需 IAM 角色的所有用户都可以在所选 Google Cloud 项目中使用 Gemini。

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

2. 在项目选择器菜单中，选择一个项目。

3. 通过以下方式启用 Gemini for Google Cloud API for Gemini： gcloud services enable 命令：

   gcloud services enable cloudaicompanion.googleapis.com
   

   如果您想为 Google Cloud 专用 Gemini API 启用 Google Cloud 项目，请将 --project 参数：

   gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID
   

   将 PROJECT_ID 替换为您的 Google Cloud 项目 ID。

   输出类似于以下内容：

   Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
   Operation finished successfully.
   

Gemini for Google Cloud 现已在指定的 Google Cloud 项目中面向具有必要 IAM 角色的所有用户推出。

在 Google Cloud 项目中授予 IAM 角色

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

控制台

1. 如需授予使用 Gemini 所需的 IAM 角色，请前往 IAM 和管理页面。

   进入“IAM 和管理”

2. 在主账号列中，找到要为其启用 Gemini 访问权限的主账号，然后在对应的行中点击 修改主账号。

3. 在修改权限窗格中，点击　　添加其他角色。

4. 在选择角色中，选择 Gemini for Google Cloud User。

5. 点击 Add another role，然后选择 Service Usage Consumer。

6. 点击保存。

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

2. 在项目选择器菜单中，选择一个项目。

3. 授予 Gemini for Google Cloud User 角色：

   gcloud projects add-iam-policy-binding  PROJECT_ID \
       --member=PRINCIPAL --role=roles/cloudaicompanion.user
   

   将 PRINCIPAL 替换为主账号的标识符。标识符的格式为 user|group|serviceAccount:email 或 domain:domain，例如 user:[e-mail]、group:[e-mail]、serviceAccount:[e-mail] 或 domain:example.domain.com。

   输出是一个政策绑定列表，其中包含以下内容：

   - members:
     - user:PRINCIPAL
     role: roles/cloudaicompanion.user
   

4. 授予 Service Usage Consumer 角色：

   gcloud projects add-iam-policy-binding  PROJECT_ID \
       --member=PRINCIPAL --role=roles/serviceusage.serviceUsageConsumer
   

   输出是一个政策绑定列表，其中包含以下内容：

   - members:
     - user:PRINCIPAL
     role: roles/serviceusage.serviceUsageConsumer
   

如需了解详情，请参阅授予单个角色和　gcloud projects add-iam-policy-binding。

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

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

如果您是希望在 IDE 中使用 Gemini 的开发者，则需要安装 Cloud Code 插件。如需了解详情，请参阅 以下：

• Cloud Workstations： 使用 Gemini Code Assist 编写代码
• Cloud Shell 编辑器：使用 Gemini Code Assist 编写代码
• Cloud Code for VS 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：

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

后续步骤

• 详细了解 Google Cloud 专用 Gemini 提供的各种生成式 AI 辅助功能。
• 了解 Google Cloud 专用 Gemini 如何使用您的数据。
• 不妨了解如何访问和管理 Gemini 管理控制设置。