借助 GitLab 智能 Microsoft 365 Copilot 副驾驶®连接器,组织可以对 GitLab 中存储的合并请求、问题、wiki 和文档编制索引。 配置连接器并索引 GitLab 内容后,用户可以通过Microsoft搜索和智能 Microsoft 365 Copilot 副驾驶®来搜索和检索信息。
本文适用于 Microsoft 365 管理员或配置、运行或监视 GitLab 智能 Microsoft 365 Copilot 副驾驶® 连接器的任何人。
功能
- 为 GitLab 存储库、合并请求和访问问题、Wiki 和文档编制索引。
- 启用Microsoft搜索和智能 Microsoft 365 Copilot 副驾驶®,以有效地检索 GitLab 数据。
- 维护 GitLab ACL 和用户权限。
- 允许管理员自定义爬网频率和索引首选项。
限制
- 除了状态索引之外,连接器不支持为 GitLab CI/CD 管道编制索引。
- 仅对存储库、议题、合并请求、.md、.txt 文件和 wiki 编制索引。
- 禁止用户作为权限规则不受支持。 作为一种解决方法,管理员可以改为从组中删除用户。
- 不支持按 IP 地址限制组访问。 建议管理员创建专用组来管理访问权限。
- 由于Microsoft内部测试期间发现的稳定性问题,对Planner角色的支持已保守地弃用。 访问权限现在仅限于记者角色及更高版本。 用户在将团队成员分配到Planner角色时可能会遇到问题。 若要缓解潜在问题,请分配“记者”角色或更高版本。 我们密切监视此功能,并继续改进。
- 对于 GitLab Server Copilot 连接器,出于安全考虑,对公共项目的合并请求的访问权限(可见性仅限于项目成员)被保守地设置为“报告者”角色及更高角色。
先决条件
在设置连接器之前,请确保以下各项:
- 确认可以通过 API 访问 GitLab 实例。
- 从 GitLab 生成 客户端 ID 和 客户端密码 以进行身份验证。
- 身份验证用户帐户必须有权访问存储库、问题、合并请求、知识文件和 Wiki 页面。
-
客户端 ID 和客户端密码必须包含以下范围:
read_api
read_repository
read_user
- 访问已编制索引的 GitLab 数据的用户必须具有相应的Microsoft Entra ID标识才能进行权限映射。
- 在 GitLab 身份验证设置过程中设置相应的 重定向 URL :
-
Microsoft 365 企业版:
https://gcs.office.com/v1.0/admin/oauth/callback
-
Microsoft 365 政府版:
https://gcsgcc.office.com/v1.0/admin/oauth/callback
-
Microsoft 365 企业版:
GitLab 服务器 Copilot 连接器的详细信息
对于 自托管 GitLab 实例,请确保以下各项:
- GitLab 版本必须为 17.7 或更高版本。
- Microsoft Graph 连接器代理版本必须为 3.1.8.0 或更高版本,并且必须安装在可以连接到 GitLab 实例的服务器上。
按照 安装指南 配置代理。 - 身份验证帐户必须具有 管理权限 才能启用 ACL 爬网。
- 为了获得更好的性能,请在 “用户和 IP 速率 限制”设置中禁用或提高限制。 有关详细信息,请参阅 GitLab 文档。
建议的配置是:
- 用户和 IP 速率限制:取消选中
Enable authenticated API request rate limit
和Enable authenticated web request rate limit
。 - 文件 API 速率限制:取消选中
Enable authenticated API request rate limit
。 - 弃用的 API 速率限制:取消选中
Enable authenticated API request rate limit
。 - 用户 API 速率限制:设置为
Max requests per 10 minutes per user
高值 (例如100000
,) 。 - 组 API 速率限制:将所有值设置为
0
以禁用限制。 - 项目 API 速率限制:将所有值设置为
0
以禁用限制。 - 成员 API 速率限制:设置为
0
。
- 用户和 IP 速率限制:取消选中
入门
1.选择显示名称
选择帮助用户识别 Copilot 响应中的合并请求、问题或文档的显示名称。
2. 身份验证
- 输入 GitLab 中的 客户端 ID 和 客户端密码 。
- 选择 “授权” 以登录并授予访问权限。
- 授予所需的 API 范围。
3. 面向有限受众推出
在部署连接器之前,请在 Copilot 和 Microsoft Search 中使用有限的用户群测试连接。
自定义设置
自定义设置适用于想要编辑任何设置的默认值的管理员。 选择 “自定义设置”时,会看到其他三个选项卡: “用户”、“ 内容”和 “同步”。
用户
标识映射
为确保正确实施权限,请将以下 GitLab 用户标识之一映射到Microsoft Entra ID。
- Email:将 GitLab 用户电子邮件与Microsoft Entra ID电子邮件匹配。 (默认和建议的映射)
- 用户名:将 GitLab 用户名与 UPN) (用户主体名称Microsoft Entra ID匹配。
- 名称:使用Microsoft Entra ID显示名称映射 GitLab 用户名。
如果直接映射失败,请使用正则表达式 (正则表达式) 进行转换。
内容
可以在示例数据中验证“内容”选项卡上的元数据的属性映射,例如标题、说明、状态和时间戳。
同步
可以根据此处提供的计划选项配置完整爬网和增量爬网。 默认情况下,增量爬网设置为每 15 分钟一次,并为每天设置完全爬网。 如果需要,可以调整这些计划以满足数据刷新需求。
后续步骤
有关故障排除信息,请参阅 GitLab 故障排除指南。
如果遇到问题或需要支持,请参阅 Microsoft Graph 支持。