此页面由 Cloud Translation API 翻译。

配置 Gemini Code Assist 代码自定义

本文档介绍了如何通过将 Gemini Code Assist 连接到您的私有代码库，在 API 控制台中使用 Google Cloud CLI 或 Terraform 设置 Gemini Code Assist 代码自定义。借助 Gemini Code Assist 代码自定义功能，您可以接收代码建议，这些建议来自贵组织的内部库、专用 API 和编码样式。

准备工作

使用 Enterprise 订阅设置 Gemini Code Assist。
验证您是否在拥有订阅的项目中拥有以下 Identity and Access Management 角色：
- Code Repository Indexes Admin (roles/cloudaicompanion.codeRepositoryIndexesAdmin)
- Gemini for Google Cloud User (roles/cloudaicompanion.user)
创建或配置用户账号。贵组织中使用 Gemini Code Assist 的每位开发者都必须在 Google Cloud 中拥有有权访问您的 Google Cloud 项目的用户身份。如需了解详情，请参阅在 Google Cloud 控制台中授予角色。验证每位用户是否都拥有以下角色：
- Gemini for Google Cloud User
- Repository Groups User
代码自定义功能使用 Developer Connect 来访问您的私有代码库并为其编制索引。确保您的 Developer Connect 代码库连接所在的 Developer Connect 区域也是代码自定义支持的位置。如果 Developer Connect 连接位于不受支持的区域，则无法使用代码自定义功能。如需查看支持的地区列表，请参阅代码自定义限制。

选择要编入索引的代码库

最佳做法是，您应为具有以下特征的代码库编制索引：

代码的样式或结构与您希望开发者编写的代码类似。
您希望从当前代码库中调用的私有库或 API。

可选：选择哪些文件不应被编入索引

默认情况下，代码自定义会将您指定代码库中所有受支持的代码文件编入索引。

为防止您不希望编入索引的代码被公开，您可以使用分支模式控制对索引的访问权限并使用稳定分支，例如 main。

或者，您也可以通过创建 .aiexclude 文件来排除不希望编入索引的文件。

配置 Gemini Code Assist 代码自定义

选择以下某个选项：

控制台

在 API 控制台中，前往代码自定义页面。

前往“Gemini Code Assist 代码自定义”页面

系统会加载 Gemini Code Assist 代码自定义页面。
创建索引。代码自定义功能依赖于索引来分析和解析您的代码库，以便更快地提供代码生成建议和查询。
1. 点击创建，然后配置索引详细信息：
  - 选择您的 Cloud 项目中在 Developer Connect 中配置的区域。
  - 输入索引的名称。记下您的索引名称。您需要在本文档中的多个步骤中使用它。
2. 点击创建。
索引创建通常需要 30 分钟才能完成，但最长可能需要 1 小时。完成索引编制后，您会在 Google API 控制台中收到通知。

Google 将每个项目和组织的代码库索引数量限制为 1 个。
使用代码库组控制对索引的访问权限。

代码库组是索引编制配置的容器，其中包含代码库及其分支模式。代码库组支持精细化 IAM 控制，开发者只有在拥有 cloudaicompanion.repositoryGroups.use 权限的情况下，才能访问这些组中已编入索引的数据。

代码库组包含来自同一项目和位置的 Developer Connect 代码库或链接。
在 Gemini Code Assist 的代码自定义页面上，点击添加代码库，然后选择添加源代码库。

系统会显示 Developer Connect 中针对您在上一步中配置的区域创建索引的现有代码库列表。

如果您需要向代码库组添加新代码库，请点击关联代码库，然后按照 Google API 控制台中的步骤操作。

此外，您还可以选择一个或多个代码库，然后对其进行修改以添加新分支。
选择要向其添加新代码库的代码库组。或者，点击创建新的代码库组以创建和配置新的代码库组。
如需开始为所选代码库编制索引，请点击编制索引。

编入索引的时间因代码库的大小而异。

CLI

验证您是否已配置开发者连接并连接到您的代码库：
在 shell 环境中，运行 gcloud components update 命令，以验证您已将 gcloud 的所有已安装组件更新到最新版本。在此步骤中，您可以安装并初始化 gcloud，也可以使用 Cloud Shell 编辑器。
```
gcloud components update
```
创建索引。代码自定义功能依赖于索引来分析和解析您的代码库，以便更快地提供代码生成建议和查询。
1. 如需创建索引，请在 shell 环境中使用 gemini code-repository-indexes create 命令：
```
gcloud gemini code-repository-indexes create INDEX_NAME \
    --project=PROJECT_ID \
    --location=REGION
```
  替换以下内容：
  - INDEX_NAME：您的索引名称。重要提示：请记下您的索引名称。您需要在本文档中的多个步骤中使用它。
  - PROJECT_ID：您的 Google Cloud 项目 ID。
  - REGION：您的 Cloud 项目中在 Developer Connect 中配置的区域。
  索引创建通常需要 30 分钟才能完成，但最长可能需要 1 小时。
  
  Google 将每个项目和组织的代码库索引数量限制为 1 个。
使用代码库组控制对索引的访问权限。代码库组是索引编制配置的容器，其中包含代码库及其分支模式。代码库组支持精细化 IAM 控制，开发者只有在拥有 cloudaicompanion.repositoryGroups.use 权限的情况下，才能访问这些组中已编入索引的数据。

代码库组包含来自同一项目和位置的 Developer Connect 代码库或链接。

管理员执行以下操作：
- 创建代码库索引资源。
- 在同一项目和位置中，配置新的 Developer Connect 连接。
- 在连接中关联 Git 代码库。
- 获取链接的资源名称，为每个链接选择要编入索引的分支格式，并将其放入一个或多个代码库组。
如需创建代码库组，请在 shell 环境中使用 gemini code-repository-indexes repository-groups create 命令：
```
gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories='[{"resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "BRANCH_NAMES"}]'
```
注意：您可以使用 RE2 语法中的正则表达式来指定分支名称。

替换以下内容：
- REPOSITORY_GROUP：代码库组的名称，例如 default。
- REPOSITORY_RESOURCE_NAME：Developer Connect 连接中的代码库名称。如需查找代码库的名称，请前往 Google Cloud 控制台中的 Git 代码库页面，然后在代码库标签页中，查找表格连接列下的连接 ID。如需复制资源名称，请点击 more_vert 菜单查看更多选项，然后选择复制资源路径。
- BRANCH_NAMES：您要编入索引的分支的名称，例如 main|dev。
您还可以使用 JSON（或 YAML）文件中定义的代码库创建代码库组，格式如下所示：
JSON
```
[
  {
      "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "main|dev"
  },
  {
      "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "dev"
  }
]
```
YAML
```
- resource: REPOSITORY_RESOURCE_NAME
  branchPattern: main|dev

- resource: REPOSITORY_RESOURCE_NAME
  branchPattern: dev
```
如需根据 JSON 或 YAML 文件创建代码库组，请在 shell 环境中使用 gemini code-repository-indexes repository-groups create 命令：
JSON
```
gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories=FILEPATH.json
```
YAML
```
gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories=FILEPATH.yaml
```
如果您愿意，可以通过 Cloud Key Management Service 使用客户管理的加密密钥 (CMEK) 对数据进行加密和控制。如需详细了解如何使用 CMEK，请参阅使用客户管理的加密密钥加密数据。
向项目中的代码库组授予 IAM 角色。

您只能收到索引中代码库的建议。每个代码库都属于一个或多个代码库组。如需访问建议，您必须通过以下任一方式向代码库组授予 Cloud AI Companion Repository Groups User IAM 角色 (roles/cloudaicompanion.repositoryGroupsUser)，该角色包含所需的 cloudaicompanion.repositoryGroups.user IAM 权限：
- 向主账号授予访问整个索引的权限。
- 向主账号授予对索引子集的访问权限。
整个指数
1. 如需为项目绑定 IAM 政策，请在 shell 环境中使用 projects add-iam-policy-binding 命令：
  gcloud projects add-iam-policy-binding PROJECT_ID \ --member='PRINCIPAL' \ --role='roles/cloudaicompanion.repositoryGroupsUser'
  替换以下内容：
  - PRINCIPAL：需要访问权限的主账号的电子邮件地址，例如，对于个人，为 user:test-user@gmail.com；对于群组，为 group:admins@example.com。
  如需了解详情，请参阅 gcloud projects set-iam-policy。
2. 当系统提示您指定条件时，请输入 None。
索引的子集
您可以创建多个代码库组，并向不同的 IAM 主账号分配 IAM 角色。

如需设置 IAM 政策，您必须准备 IAM 政策 JSON 或 YAML 文件，其中将包含 IAM 组和已分配角色的列表。例如：
```
  bindings:
  - members:
    - group:my-group@example.com
    - user:test-user@example.com
    role: roles/cloudaicompanion.repositoryGroupsUser
```
如需了解更多详情和语法，请参阅了解允许政策。

注意：您可以向 IAM 组分配自定义角色，但自定义角色必须包含 roles/cloudaicompanion.repositoryGroupsUser 角色的所有权限。

如需设置 IAM 政策，请在 shell 环境中使用 gemini code-repository-indexes repository-groups set-iam-policy 命令：
```
  gcloud gemini code-repository-indexes repository-groups set-iam-policy GROUP_NAMEPOLICY_FILE \
      --project=PROJECT_ID \
      --location=REGION \
      --code-repository-index=INDEX_NAME
```
替换以下内容：
- GROUP_NAME：您在之前的步骤中创建的代码库组名称，用于使用代码库组控制对索引的访问权限。
- POLICY_FILE：IAM 政策。
  
  如需了解详情，请参阅 gcloud gemini code-repository-indexes repository-groups set-iam-policy。

Terraform

验证您已配置 Developer Connect 并连接到您的代码库：
创建索引。代码自定义功能依赖于索引来分析和解析您的代码库，以便更快地提供代码生成建议和查询。
```
resource "google_gemini_code_repository_index" "example" {
  location = "REGION"
  code_repository_index_id = "INDEX_NAME"
}
```
替换以下内容：
- INDEX_NAME：您的索引名称。重要提示：请记下您的索引名称。您需要在本文档中的多个步骤中使用它。
- PROJECT_ID：您的 Google Cloud 项目 ID。
- REGION：您的 Cloud 项目中在 Developer Connect 中配置的区域。
索引创建通常需要 30 分钟才能完成，但最长可能需要 1 小时。

Google 将每个项目和组织的代码库索引数量限制为 1 个。
使用代码库组控制对索引的访问权限。代码库组是索引编制配置的容器，其中包含代码库及其分支模式。代码库组支持精细化 IAM 控制，开发者只有在拥有 cloudaicompanion.repositoryGroups.use 权限的情况下，才能访问这些组中已编入索引的数据。

代码库组包含来自同一项目和位置的 Developer Connect 代码库或链接。

管理员执行以下操作：
- 创建代码库索引资源。
- 在同一项目和位置中，配置新的 Developer Connect 连接。
- 在连接中关联 Git 代码库。
- 获取链接的资源名称，为每个链接选择要编入索引的分支格式，并将其放入一个或多个代码库组。
```
resource "google_gemini_repository_group" "example" {
  location = "REGION"
  code_repository_index = "INDEX_NAME"
  repository_group_id = "REPOSITORY_GROUP"
  repositories {
    resource = "REPOSITORY_RESOURCE_NAME"
    branch_pattern = "BRANCH_NAMES"
  }
}
```
注意：您可以使用 RE2 语法中的正则表达式来指定分支名称。

替换以下内容：
- REPOSITORY_GROUP：代码库组的名称，例如 default。
- REPOSITORY_RESOURCE_NAME：Developer Connect 连接中的代码库名称。如需查找代码库的名称，请前往 Google Cloud 控制台中的 Git 代码库页面，然后在代码库标签页中，查找表格连接列下的连接 ID。如需复制资源名称，请点击 more_vert 菜单查看更多选项，然后选择复制资源路径。
- BRANCH_NAMES：您要编入索引的分支的名称，例如 main|dev。
您还可以使用 JSON（或 YAML）文件中定义的代码库创建代码库组，格式如下所示：
JSON
```
[
  {
      "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "main|dev"
  },
  {
      "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "dev"
  }
]
```
YAML
```
- resource: REPOSITORY_RESOURCE_NAME
  branchPattern: main|dev

- resource: REPOSITORY_RESOURCE_NAME
  branchPattern: dev
```
如需根据 JSON 或 YAML 文件创建代码库组，请在 shell 环境中使用 gemini code-repository-indexes repository-groups create 命令：
JSON
```
gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories=FILEPATH.json
```
YAML
```
gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories=FILEPATH.yaml
```
如果您愿意，可以通过 Cloud Key Management Service 使用客户管理的加密密钥 (CMEK) 对数据进行加密和控制。如需详细了解如何使用 CMEK，请参阅使用客户管理的加密密钥加密数据。

向项目中的代码库组授予 IAM 角色。

您只能收到索引中代码库的建议。每个代码库都属于一个或多个代码库组。如需访问建议，您必须通过以下任一方式向代码库组授予 Cloud AI Companion Repository Groups User IAM 角色 (roles/cloudaicompanion.repositoryGroupsUser)，该角色包含所需的 cloudaicompanion.repositoryGroups.user IAM 权限：

向主账号授予访问整个索引的权限。
向主账号授予对索引子集的访问权限。

整个指数

如需为项目绑定 IAM 政策，请在 shell 环境中使用 projects add-iam-policy-binding 命令：
```
gcloud projects add-iam-policy-binding PROJECT_ID \
    --member='PRINCIPAL' \
    --role='roles/cloudaicompanion.repositoryGroupsUser'
```
替换以下内容：
- PRINCIPAL：需要访问权限的主账号的电子邮件地址，例如，对于个人，为 user:test-user@gmail.com；对于群组，为 group:admins@example.com。
  
  如需了解详情，请参阅 gcloud projects set-iam-policy。
当系统提示您指定条件时，请输入 None。

索引的子集

您可以创建多个代码库组，并向不同的 IAM 主账号分配 IAM 角色。

  data "google_iam_policy" "foo" {
    binding {
      role = "roles/cloudaicompanion.repositoryGroupsUser"
      members = ["test-user@example.com"]
    }
  }

  resource "google_gemini_repository_group_iam_policy" "foo" {
    project = "PROJECT_ID"
    location = "REGION"
    code_repository_index_id = "INDEX_NAME"
    repository_group_id = "GROUP_NAME"
    policy_data = data.google_iam_policy.foo.policy_data
  }

  data "google_gemini_repository_group_iam_policy" "foo" {
    project = "PROJECT_ID"
    location = "REGION"
    code_repository_index_id = "INDEX_NAME"
    repository_group_id = "GROUP_NAME"
    depends_on = [
      google_gemini_repository_group_iam_policy.foo
    ]
  }

您还可以创建以下绑定：

  resource "google_gemini_repository_group_iam_binding" "foo" {
    project = "PROJECT_ID"
    location = "REGION"
    code_repository_index_id = "INDEX_NAME"
    repository_group_id = "GROUP_NAME"
    role = "roles/cloudaicompanion.repositoryGroupsUser"
    members = ["test-user@example.com"]
  }

替换以下内容：

GROUP_NAME：您在之前的步骤中创建的代码库组名称，用于使用代码库组控制对索引的访问权限。

查看索引编制状态

索引编制内容最长可能需要 24 小时，具体取决于您要编入索引的代码库的数量及其大小。对于大型代码库，索引编制可能需要更长时间。索引编制每 24 小时进行一次，并会捕获代码库中所做的任何更改。

搜索 indexing 日志。如需了解详情，请参阅 Logging 查询语言。
控制台
1. 在 Google API 控制台中，前往 Logs Explorer。
  
  转到日志浏览器
2. 使用日志名称过滤器查看 indexing 日志。
CLI
如需搜索索引编制日志，请在 shell 环境中使用 logging read 命令：
```
gcloud logging read "logName="projects/PROJECT_ID/logs/indexing""
```
将 PROJECT_ID 替换为代码库组所在的项目 ID。

例如，如需查看 indexing 日志中的错误，请运行以下命令：
```
gcloud logging read "logName="projects/PROJECT_ID/logs/indexing" AND severity>=ERROR"
```
查看相关的索引编制状态，例如：
- 代码库索引编制的起始位置，例如 Indexing repository REPOSITORY_NAME. Total number of repositories: 10, succeeded: 6, failed: 0.
- 结束单个代码库索引编制，例如：
  - 成功：Successfully finished indexing repository REPOSITORY_NAME. Total number of repositories: 10, succeeded: 7, failed: 0.
  - 失败：Failed to index repository REPOSITORY_NAME. Error: [<error message>]. Total number of repositories: 10, succeeded: 7, failed: 1.
- 结束代码库索引编制，例如：
  - 成功：Finished indexing process. Repositories attempted: 10. Repositories successfully indexed: 9. Repositories unsuccessfully fetched: 0.
  - 失败：Finished indexing process. Repositories attempted: 10. Repositories successfully indexed: 9. Repositories unsuccessfully fetched: 1. Repositories that were not successfully fetched will be retried in the next run.
在索引状态中，REPOSITORY_NAME 是您要查看的代码库。
查看相关的索引编制错误，例如：
- 提取代码库失败。
- 未能列出代码库文件。
- 未能从索引中检索代码库信息。
- 未能从索引中检索文件。
- 内部错误。

使用代码自定义

设置代码自定义后，您将开始看到代码补全和代码生成建议，这些建议可能基于您已编入索引的私有代码，以及完整代码库感知的结果。

如需详细了解如何使用代码自定义和最佳做法，请参阅使用代码自定义。

关闭代码自定义

选择以下某个选项：

控制台

在 API 控制台中，前往 Gemini 产品页面。

前往 Gemini 产品

系统会加载 Gemini 产品页面。
在导航菜单中，点击代码自定义。

系统会加载代码自定义页面。
如需删除索引，请点击删除。

系统会显示一条警告消息。如果您想继续并删除索引，请输入索引名称，然后点击删除。

CLI

如需列出当前索引的所有代码库组，请在 shell 环境中使用 gemini code-repository-indexes repository-groups list 命令：
```
gcloud gemini code-repository-indexes repository-groups list --location=REGION \
    --project=PROJECT_ID \
    --code-repository-index=INDEX_NAME --uri
```
替换以下内容：
- REGION：您的 Cloud 项目中在 Developer Connect 中配置的区域。请注意，如果您指定的地区不受支持，命令将失败。如需查看支持的地区列表，请参阅代码自定义限制。
- PROJECT_ID：您的 Google Cloud 项目 ID。
- INDEX_NAME：您在之前的步骤中为了创建索引而创建的索引的名称。

如需从当前索引中删除代码库组，请使用 gemini code-repository-indexes repository-groups delete 命令：

gcloud gemini code-repository-indexes repository-groups delete REPOSITORY_GROUP \
    --location=REGION \
    --project=PROJECT_ID \
    --code-repository-index=INDEX_NAME

对每个代码库组重复上述步骤，直到将所有代码库组从索引中删除。

可选：如需删除索引，请在 shell 环境中使用 gemini code-repository-indexes delete 命令：

gcloud gemini code-repository-indexes delete INDEX_NAME \
    --location=REGION \
    --project=PROJECT_ID

后续步骤

开始使用 Gemini Code Assist：
- VS Code、IntelliJ 和其他受支持的 JetBrains IDE：使用 Gemini Code Assist 编写代码
- Cloud Shell：使用 Gemini Code Assist 编写代码
- Cloud Workstations：使用 Gemini Code Assist 编写代码
了解如何使用代码自定义和最佳做法。
了解如何使用客户管理的加密密钥 (CMEK) 加密数据。
详细了解 Developer Connect。
了解 Gemini for Google Cloud 如何以及何时使用您的数据。

配置 Gemini Code Assist 代码自定义 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

准备工作

选择要编入索引的代码库

可选：选择哪些文件不应被编入索引

配置 Gemini Code Assist 代码自定义

控制台

CLI

JSON

YAML

JSON

YAML

整个指数

索引的子集

Terraform

JSON

YAML

JSON

YAML

整个指数

索引的子集

查看索引编制状态

控制台

CLI

使用代码自定义

关闭代码自定义

控制台

CLI

后续步骤

配置 Gemini Code Assist 代码自定义