设置 Gemini Code Assist

您的团队需要先执行本文档中所述的设置步骤，然后您才能使用 Gemini Code Assist：

  1. 可选：订阅 Gemini Code Assist。 Gemini Code Assist 可在 2024 年 7 月 11 日之前免费试用，每个结算账号仅限一位用户试用。

  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 订阅

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

  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. 如果您同意这些条款，请点击 Complete Purchase（完成购买），然后确认您的订阅。

Gemini 现已启用结算功能。现在，您需要在与此结算帐号关联的一个或多个项目中启用 Cloud AI Companion API。您必须在至少一个项目中激活 Gemini，用户才能看到它。

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

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

控制台

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

    前往 Google Cloud 专用 Gemini

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

  3. 点击启用。

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

gcloud

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

    激活 Cloud Shell

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

  3. 使用 gcloud services enable 命令启用 Gemini 的 Cloud AI Companion API：

    gcloud services enable cloudaicompanion.googleapis.com

    如果您要在其他 Google Cloud 项目中启用 Cloud AI Companion API，请添加 --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.

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

在 Google Cloud 项目中授予 IAM 角色

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

控制台

  1. 如需授予使用 Gemini 所需的 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:cloudysanfrancisco@gmail.com、group:admins@example.com、serviceAccount:test123@example.domain.com 或 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 for Google Cloud 功能。如需了解详情，请参阅 Google Cloud 专用 Gemini 概览。

可选：在 IDE 中使用 Gemini Code Assist

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

高级设置任务

您可以执行以下任一操作，而不是使用 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

后续步骤