设置 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 项目中启用 Cloud AI Companion API。 通常由管理员执行此步骤。

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

4. 可选：收件人 在 IDE 中使用 Gemini Code Assist； 安装 Cloud Code 插件。

可选：购买 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 现已启用结算功能。您现在需要 启用 Cloud AI Companion API 在与此结算账号关联的一个或多个项目中。用户 只有在你至少启用一个 Gemini 后，它才会看到它 项目。

在 Google Cloud 项目中启用 Cloud AI Companion API

本部分介绍了启用 Google Cloud 项目中的 Cloud AI Companion API。

控制台

1. 如需启用 Cloud AI Companion API，请参阅 Gemini for Google Cloud 页面。

   前往 Google Cloud 专用 Gemini

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

3. 点击启用。

   该页面会更新并显示已启用状态。 Gemini 现已支持所选的 将其分配给拥有所需 Google Cloud 项目访问权限的所有用户， IAM 角色。

gcloud

1. 在 Google Cloud 控制台中，激活 Cloud Shell。

   激活 Cloud Shell

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

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

   gcloud services enable cloudaicompanion.googleapis.com
   

   如果您想在不同的可用区中启用 Cloud AI Companion 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.
   

Google Cloud 专用 Gemini 现已在指定的 Google Cloud 项目中面向所有用户推出 拥有所需 IAM 角色的用户。

在 Google Cloud 项目中授予 IAM 角色

本部分介绍了向 Cloud AI Companion User 授予 Service Usage Consumer IAM 角色。

控制台

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

   进入“IAM 和管理”

2. 在主账号列中，找到 想要启用 Gemini 访问权限，然后点击 在该行中 修改主账号。

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

4. 在选择角色中，选择 Cloud AI Companion User。

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

6. 点击保存。

gcloud

1. 在 Google Cloud 控制台中，激活 Cloud Shell。

   激活 Cloud Shell

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

3. 授予 Cloud AI Companion 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。

所有已被授予这些角色的用户都可以访问 Google Cloud 专用 Gemini 特定项目内 Google Cloud 控制台中的功能。有关 请参阅 Google Cloud 专用 Gemini 概览。

可选：在 IDE 中使用 Gemini Code Assist

如果您是一名开发者，想要在 IDE 中使用 Gemini，那么 您需要安装 Cloud Code 插件。如需了解详情，请参阅 以下：

• 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：

  • cloudaicompanion.companions.generateChat
  • cloudaicompanion.companions.generateCode
  • serviceusage.services.use

后续步骤

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