为项目设置 Gemini Code Assist

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

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

  2. 在 Google Cloud 项目中激活 Gemini Code Assist。 管理员通常会执行此步骤。

  3. 可选：如需在 IDE 中使用 Gemini Code Assist，请安装 Cloud Code 插件。

可选：购买 Gemini Code Assist 订阅

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

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

    前往适用于 Google Cloud 的 Gemini

  2. 点击 Gemini 使用入门。

  3. 如果出现提示，请选择一个结算帐号，然后点击前往 Gemini 管理员页面。

  4. 在配置订阅中，填写用于配置订阅的字段，包括承诺期限（每月或每年）和订阅中的许可数量。

    选择在承诺期限后是按月还是按年自动续订。自动续订功能会使您的订阅和许可保持有效状态。如果订阅未自动续订，则会在当前订阅期结束时结束，并且您需要再次完成购买流程才能重新获得许可。

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

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

Gemini 现已启用结算功能。现在，您需要在与此结算帐号相关联的一个或多个项目中激活 Gemini Code Assist。您必须在至少一个项目中启用 Gemini，否则用户不会看到 Gemini。

在 Google Cloud 项目中激活 Gemini Code Assist

如需在 Google Cloud 项目中激活 Gemini Code Assist，管理员需要启用 Cloud AI Companion API，并向用户授予 Cloud AI Companion User 和 Service Usage Viewer IAM 角色。

控制台

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

    前往适用于 Google Cloud 的 Gemini

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

  3. 点击启用。

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

  4. 如需授予使用 Gemini 所需的 IAM 角色，请转到 IAM 和管理页面。

    进入“IAM 和管理”

  5. 在主账号列中，找到要授予其对 Gemini 的访问权限的主账号，然后点击该行中的 修改主账号。

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

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

  8. 点击添加其他角色，然后选择 Service Usage Viewer。

  9. 点击保存。

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。

  4. 授予使用 Gemini 所需的两个 IAM 角色：

    1. 授予 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

    2. 授予 Service Usage Viewer 角色：

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

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

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

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

所有获得这些角色的用户都可以在 Google Cloud 控制台的指定项目中访问 Gemini 功能。如需了解详情，请参阅使用 Gemini 获得 AI 协助和开发。

可选：在 IDE 中使用 Gemini Code Assist

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

高级设置任务

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

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

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

    • roles/cloudaicompanion.user
    • roles/serviceusage.serviceUsageViewer

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

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

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

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

后续步骤