GitLab 智能 Microsoft 365 Copilot 副驾驶®连接器

2025-06-24

借助 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

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。

入门

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 支持。

通过