本文档介绍了如何通过将 Gemini Code Assist 连接到您的私有代码库,在 Google Cloud 控制台中、使用 Google Cloud CLI 或使用 Terraform 设置 Gemini Code Assist 代码自定义。借助 Gemini Code Assist 代码自定义功能,您可以接收代码建议,这些建议来自贵组织的内部库、专用 API 和编码样式。
准备工作
验证您是否在拥有订阅的项目中具有以下 Identity and Access Management (IAM) 角色:
- Code Repository Indexes Admin (
roles/cloudaicompanion.codeRepositoryIndexesAdmin) - Gemini for Google Cloud User (
roles/cloudaicompanion.user)
- Code Repository Indexes Admin (
创建或配置用户账号。贵组织中使用 Gemini Code Assist 的每位开发者都必须在Google Cloud 中拥有有权访问您的 Google Cloud 项目的用户身份。如需了解详情,请参阅在 Google Cloud 控制台中授予角色。验证每位用户都拥有以下角色:
代码定制功能使用 Developer Connect 来访问您的私有代码库并为其编入索引。确保您的 Developer Connect 代码库连接所在的 Developer Connect 区域也是支持代码自定义的位置。如果 Developer Connect 连接位于不受支持的区域,则无法使用代码自定义功能。如需查看支持的区域列表,请参阅代码自定义限制。
选择要编入索引的代码库
最佳做法是,您应为具有以下特征的代码库编入索引:
- 样式或结构与您希望开发者编写的样式或结构类似的代码。
- 您希望从当前代码库中调用的私有库或 API。
可选:选择哪些文件不应被编入索引
默认情况下,代码定制会将您指定代码库中所有受支持的代码文件编入索引。
为防止您不希望编入索引的代码被公开,您可以使用分支模式控制对索引的访问权限并使用稳定分支,例如 main。
或者,您也可以通过创建 .aiexclude 文件来排除不希望编入索引的文件。
配置 Gemini Code Assist 代码自定义
从下列选项中选择一项:
控制台
在 Google Cloud 控制台中,前往代码自定义页面。
系统会加载 Gemini Code Assist 代码定制页面。
创建索引。代码定制功能依赖于索引来分析和解析您的代码库,以便更快地提供代码生成建议和查询。
点击创建,然后配置索引详细信息:
- 选择在 Google Cloud 项目的 Developer Connect 中配置的区域。
- 输入索引的名称。记下您的索引名称。您需要在本文档中的多个步骤中使用它。
点击创建。
索引创建通常需要 30 分钟才能完成,但最长可能需要 1 小时。完成编入索引后,您会在 Google Cloud 控制台中收到通知。
Google 将每个项目和组织的代码库索引数量限制为 1 个。
使用代码库组控制对索引的访问权限。
代码库组是索引编制配置的容器,其中包含代码库及其分支模式。代码库组支持精细化 IAM 控制,开发者只有在拥有
cloudaicompanion.repositoryGroups.use权限的情况下,才能访问这些组中已编入索引的数据。代码库组包含来自同一项目和位置的 Developer Connect 代码库或链接。
在 Gemini Code Assist 代码定制页面上,点击添加代码库,然后选择添加源代码库。
系统会显示 Developer Connect 中针对您在上一步中配置的区域创建索引的现有代码库列表。