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

借助 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 连接器,出于安全考虑,对公共项目的合并请求的访问权限(可见性仅限于项目成员)被保守地设置为“报告者”角色及更高角色。

先决条件

在设置连接器之前,请确保以下各项:

  1. 确认可以通过 API 访问 GitLab 实例。
  2. 从 GitLab 生成 客户端 ID客户端密码 以进行身份验证。
  3. 身份验证用户帐户必须有权访问存储库、问题、合并请求、知识文件和 Wiki 页面。
  4. 客户端 ID客户端密码必须包含以下范围:
    • read_api
    • read_repository
    • read_user
  5. 访问已编制索引的 GitLab 数据的用户必须具有相应的Microsoft Entra ID标识才能进行权限映射。
  6. 在 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 爬网。
  1. 为了获得更好的性能,请在 “用户和 IP 速率 限制”设置中禁用或提高限制。 有关详细信息,请参阅 GitLab 文档。 建议的配置是:
    • 用户和 IP 速率限制:取消选中 Enable authenticated API request rate limitEnable 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 支持