GitHub 云问题智能 Microsoft 365 Copilot 副驾驶®连接器 (预览版)

2025-04-20

GitHub 云问题智能 Microsoft 365 Copilot 副驾驶®连接器允许组织为 GitHub 中存储的问题编制索引。配置连接器并索引 GitHub 内容后，用户可以通过Microsoft搜索和智能 Microsoft 365 Copilot 副驾驶®来搜索和检索信息。本文适用于 Microsoft 365 管理员或配置、运行或监视 GitHub 云问题 Copilot 连接器的任何人。

功能

为 GitHub 问题编制索引。
启用Microsoft搜索和智能 Microsoft 365 Copilot 副驾驶®，以有效地检索 GitHub 数据。
维护 GitHub ACL 和用户权限。
允许管理员自定义爬网频率和索引首选项。

限制

连接器不支持对 GitHub CI/CD 管道编制超出状态索引的索引。
目前不支持本地/自承载 GitHub 实例。
连接器旨在支持 GitHub Enterprise。免费或团队计划的用户可能会遇到有限的功能或减少的支持。

先决条件

确保可以通过 API 访问 GitHub 实例。
设置用于身份验证的GitHub Apps。可以指定 GitHub 应用有权访问哪些组织和存储库，从而有效地确定连接器将爬网的内容。配置 GitLab 身份验证时指定以下重定向 URL：
- 对于Microsoft 365 企业版，请使用https://gcs.office.com/v1.0/admin/oauth/callback
- 对于 Microsoft 365 政府版，请使用 https://gcsgcc.office.com/v1.0/admin/oauth/callback
从GitHub Apps生成客户端 ID 和客户端密码以进行身份验证。
验证用于身份验证的用户帐户是否有权访问存储库和要编制索引的问题。
验证GitHub Apps是否配置了以下权限来读取问题：
- 存储库权限
  - 管理 - 只读
  - 元数据 - 只读
  - 问题 - 只读
- 组织权限
  - 管理 - 只读
  - 成员 - 只读
- 帐户权限
  - Email地址 - 只读
确保访问已编制索引的 GitHub 数据的用户具有相应的权限映射Microsoft Entra ID标识。
对于通过单 Sign-On (SSO) 进行身份验证的企业托管用户，必须在执行任何作之前登录帐户，因为 GitHub 身份验证流当前不支持 SSO 登录。

入门

选择显示名称

选择可帮助用户在 Copilot 响应中识别连接的显示名称。

提供身份验证详细信息

输入GitHub Apps中的客户端 ID 和客户端密码。
选择 “授权” 以登录并授予访问权限。我们建议对每个连接使用单独的用户帐户进行 OAuth 身份验证，因为 GitHub 的速率限制是按用户单独计算的。
授予所需的 API 范围。

3. 面向有限受众推出

在部署连接器之前，请在 Copilot 和 Microsoft Search 中使用有限的用户群测试连接。

自定义设置

在自定义设置中，可以编辑用户、内容和同步的任何默认值。

用户

标识映射

为确保正确实施权限，请将 GitHub 用户标识映射到Microsoft Entra ID。以下是选项：

Email：将 GitHub 电子邮件映射到Microsoft Entra ID用户属性。
登录：使用Microsoft Entra ID用户属性映射 GitHub 登录名。
名字：使用Microsoft Entra ID用户属性映射 GitHub 名称。

如果直接映射失败，请使用 正则表达式 (正则表达式) 转换数据。例如： [a-zA-Z0-9]+ 对于个人帐户，由于电子邮件域和单个电子邮件可见性设置的变化，映射准确性可能会受到影响。

内容

在“内容”选项卡上，可以验证示例数据中的内容、标签、说明和时间戳等元数据的属性映射。

时间范围筛选器

可以在内容选项卡中配置时间范围筛选器。默认设置为 365 天。

同步

可以配置增量爬网和完全爬网。下面是默认值：

默认情况下，增量爬网每 15 分钟运行一次。
完全爬网每天运行，以确保最新的索引编制。

防火墙设置

为了提高安全性，你可以为 Azure SQL 服务器或数据库配置 IP 防火墙规则。有关详细信息，请参阅 IP 防火墙规则。在防火墙设置中添加以下客户端 IP 范围。

地区	Microsoft 365 企业版	Microsoft 365 政府
NAM	52.250.92.252/30, 52.224.250.216/30	52.245.230.216/30, 20.141.117.64/30
EUR	20.54.41.208/30, 51.105.159.88/30	不适用
APC	52.139.188.212/30, 20.43.146.44/30	不适用

设置 IP 限制可能会导致连接器停止工作并导致爬网失败。管理员可以通过根据上表将连接器的 IP 地址添加到允许列表来解决此问题并恢复爬网。

后续步骤

单击“自动生成”，使用建议的默认值快速填充连接说明。它可节省时间并确保设置的一致性。
在Microsoft 365 管理中心查看连接状态。
有关 GitHub 应用和身份验证的配置，请检查以下文档

主题	文档链接
如何创建/注册GitHub Apps	注册GitHub Apps
如何将GitHub Apps安装到组织中	安装自己的GitHub Apps
如何代表用户对GitHub Apps进行身份验证	关于创建 GitHub Apps (代表用户) 代表用户使用GitHub Apps进行身份验证

如果遇到问题或想要提供反馈，请联系 Microsoft Graph 支持。

通过