启用 Gemini Code Assist 工具

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

本文档介绍了如何启用 Gemini Code Assist 工具。Google Cloud 管理员应完成以下步骤，以便在其 IDE 中为开发者启用工具。

如需详细了解这些工具，请参阅 Gemini Code Assist 工具概览。如需配置 IDE 中使用的工具，请参阅配置 Gemini Code Assist 工具。

准备工作

1. 设置 Gemini Code Assist。

2. Make sure that billing is enabled for your Google Cloud project.

3. Enable the Developer Connect API.

   Enable the API

   Developer Connect 用于在用户账号与 Gemini Code Assist 工具服务之间建立关联。

所需的角色

如需获取启用 Gemini Code Assist 工具所需的权限，请让您的管理员为您授予 Google Cloud 项目的以下 IAM 角色：

• Developer Connect OAuth Admin (roles/developerconnect.oauthAdmin)
• Gemini for Google Cloud Settings Admin (roles/cloudaicompanion.settingsAdmin)

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

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

启用工具

1. 在 Google Cloud 控制台中，前往 Gemini Code Assist 工具页面。

   前往“工具”页面

2. 找到要启用的工具，然后点击启用。系统会打开该工具的详情页面。

3. 在配置部分中，选择一个区域，以便为该工具创建 Developer Connect 账号连接器。Developer Connect 位置中列出了可用的区域。

4. 点击启用。

   该工具已为您的项目启用，开发者可在其 IDE 中使用该工具。

   系统会提示您关联到您的账号，以便在 IDE 中使用该工具。如果您想在 IDE 中使用该工具，请点击关联，然后按照说明关联您的账号。如果您不想使用该工具，可以跳过关联步骤。

5. 如需允许用户向该工具进行身份验证，您必须创建自定义角色并将其授予用户。

   1. 通过运行以下命令创建自定义角色：

      gcloud iam roles create ROLE_NAME \
          --project=PROJECT \
          --title="Gemini Code Assist Tools User" \
          --description="custom role for tools user" \
          --permissions=cloudaicompanion.codeToolsSettings.get,cloudaicompanion.codeToolsSettings.list,cloudaicompanion.settingBindings.codeToolsSettingsGet,cloudaicompanion.settingBindings.codeToolsSettingsList,cloudaicompanion.instances.queryEffectiveSetting
      

      替换以下内容：

      • 将 ROLE_NAME 替换为您要为自定义角色指定的名称。
      • 将 PROJECT 替换为您的 Google Cloud 项目 ID。

   2. 通过运行以下命令为您的用户授予自定义角色：

      gcloud projects add-iam-policy-binding PROJECT \
          --member=PRINCIPAL_TYPE:PRINCIPAL \
          --role=projects/PROJECT/roles/ROLE_NAME
      

      替换以下内容：

      • 将 PROJECT 替换为您的 Google Cloud 项目 ID。
      • 将 PRINCIPAL_TYPE 替换为您要向其授予自定义角色的主账号类型。如需详细了解主账号类型，请参阅主账号标识符。
      • 将 PRINCIPAL 替换为主账号的标识符。

      • 将 ROLE_NAME 替换为您为自定义角色指定的名称。

        以下示例将自定义角色 tools-user 授予项目 test-project 中的单个用户 luka@example.com：

        gcloud projects add-iam-policy-binding test-project \
            --member=user:luka@example.com \
            --role=projects/test-project/roles/tools-user
        

      向用户授予自定义角色后，他们可以通过在 Gemini Code Assist 对话中使用 @TOOL_NAME 提示工具，向已启用的 Gemini Code Assist 工具进行身份验证，其中 TOOL_NAME 是工具的名称。

后续步骤

• 配置 Gemini Code Assist 工具。
• Gemini Code Assist 工具使用入门。