为项目设置 Duet AI for Developers

在受支持的 Google Cloud 产品中使用面向开发者的 Duet AI 之前,您的团队需要执行本文档中所述的步骤:

  1. 购买一项或多项 Duet AI 产品的订阅服务。

  2. 在 Google Cloud 项目中激活 Duet AI。此步骤通常由管理员执行。

  3. 如果您希望在 IDE 中使用 Duet AI,请安装 Cloud Code 插件。

购买 Duet AI 订阅

如果您仅使用 Duet AI for BigQuery、Spanner 或 Colab Enterprise,则可以跳过本部分。

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

  1. 在 Google Cloud 控制台中,前往 Duet AI 管理员页面。

    前往 Duet AI 管理员

  2. 查看并确认开始前须知消息。

  3. 如果此结算帐号还没有订阅,则会看到“促销”页面。点击 Duet AI 使用入门

  4. 如果出现提示,请选择一个结算帐号,然后点击继续浏览 Duet AI 管理页面

  5. 订阅页面上,点击购买新订阅

  6. 填写配置订阅的字段,包括订阅的可选名称、承诺期限(每月或每年)以及订阅中的许可数量。

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

  7. 点击继续以查看订阅详情。查看并同意购买条款。

  8. 点击完成购买,然后确认您的订阅。

Duet AI 现已启用结算功能。接下来,在与此结算账号关联的一个或多个项目中激活 Duet AI。您必须在至少一个项目中激活 Duet AI,否则用户不会看到它

在 Google Cloud 项目中激活 Duet AI

如需在 Google Cloud 项目中激活 Duet AI,管理员需要启用 Cloud AI Companion API,并向用户授予 Cloud AI Companion User 和 Service Usage Viewer Identity and Access Management (IAM) 角色。

控制台

  1. 如需启用该 API,请前往 Google Cloud 控制台中的 Cloud AI Companion API 页面。

    前往 Cloud AI Companion API

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

  3. 点击启用

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

  4. 如需授予使用 Duet AI 所需的 IAM 角色,请转到 IAM 页面。

    进入 IAM

  5. 主账号列中,找到要为其启用 Duet AI 访问权限的主账号,然后点击该行中的 修改主账号

  6. 修改访问权限窗格中,点击 添加其他角色

  7. 选择角色中,选择 Cloud AI Companion User

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

  9. 点击保存

gcloud

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

    激活 Cloud Shell

  2. 在项目选择器下拉列表中,选择一个项目。

  3. 使用 gcloud services enable 命令为 Duet AI 启用 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 项目中的 Duet AI。

  4. 授予使用 Duet AI 所需的两个 IAM 角色:

    1. 授予 Cloud AI Companion User 角色:

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

      PRINCIPAL 替换为主帐号的标识符。标识符采用 user|group|serviceAccount:emaildomain:domain 格式,例如 user:cloudysanfrancisco@gmail.comgroup:admins@example.comserviceAccount:test123@example.domain.comdomain: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 控制台中的 Duet AI 功能。如需了解详情,请参阅 Google Cloud 中的 Duet AI 概览

在 IDE 中使用 Duet AI

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

高级设置任务

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

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

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

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

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

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

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

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

后续步骤