GitHub Microsoft Graph 连接器 (预览版)
GitHub Graph 连接器允许对 GitHub 存储库中的内容编制索引，使其可在 Microsoft 365 生态系统中轻松进行搜索。 此连接器非常适合使用 GitHub 进行文档、项目文件或内容管理的组织。 通过将 GitHub 数据与Microsoft搜索集成，用户可以直接在 Microsoft 365 应用程序中访问相关内容，从而简化工作流并减少在平台之间切换的需要。
本文适用于 Microsoft 365 管理员或配置、运行和监视 GitHub Graph 连接器的任何人。
注意
GitHub Graph 连接器为预览版。 如果希望提前访问以试用，请使用 此表单注册。
功能
- 为 GitHub 存储库和 markdown 文件编制索引，使项目文档在 Microsoft 365 中可访问。
- 使最终用户能够在 Copilot 中提出与项目文档和技术指南相关的问题。
- 如何实现设置 Project Alpha？
- 在哪里可以找到部署说明？
- 此项目的体系结构概述是什么？
- 汇总项目文档中的关键部分以供快速参考
- 在 Copilot 中使用语义搜索 ，使用户能够根据关键字、个人偏好和社交关系查找相关内容。
限制
- 仅对存储库元数据和 markdown 文件编制索引。 其他 GitHub 实体（如问题、拉取请求和注释）不会编制索引。
- 仅支持大小为 1 MB 的 Markdown 文件。 不会为较大的文件编制索引。
先决条件
你必须是组织的 Microsoft 365 租户的 搜索管理员 。
必须具有一个有效的 GitHub 帐户，在该帐户中可以访问要编制索引的所有存储库。
a. 对于个人存储库，你必须是以下人员之一：
- 存储库所有者
- 存储库协作者
b. 对于组织拥有的存储库，必须满足以下条件之一：
- 外部协作者
- 作为直接协作者的组织成员
- 通过团队成员身份访问的组织成员
- 通过默认组织权限具有访问权限的组织成员
- 组织所有者。
必须具有 PAT) (个人访问令牌。 若要了解有关个人访问令牌的详细信息，请参阅 管理个人访问令牌 - GitHub Docs。
你的个人访问令牌必须有权访问要编制索引的所有存储库，并且必须被授予下面列出的权限。
对于经典令牌：
类别 权限 备注 回购 全部 完全控制专用存储库 用户 read：user 读取所有用户配置文件数据 用户 read：email (只读) 访问用户电子邮件地址 对于细化标记：
类别 权限 权限级别 存储库权限 目录 只读 存储库权限 Metadata 只读 帐户权限 电子邮件地址 只读 如果你有组织拥有的存储库，请执行以下额外步骤：
- 组织管理员需要允许通过个人访问令牌进行访问。 有关说明，请参阅 为组织设置个人访问令牌策略 - GitHub Docs
- 如果使用细化令牌，请选择组织作为资源所有者。
入门
1. 显示名称
显示名称用于标识 Copilot 中的每个引文，帮助用户轻松识别关联的文件或项目。 显示名称还表示受信任的内容。 显示名称也用作 内容源筛选器。 此字段存在默认值，但你可以将其自定义为组织中的用户可识别的名称。
2.身份验证类型
若要对 GitHub 中的内容进行身份验证和同步，请使用：
身份验证类型
选择“基本”选项个人访问令牌 (PAT)
使用个人访问令牌代替密码。 可用于索引的存储库取决于令牌授予的访问权限。
自定义设置
自定义设置适用于想要编辑所列设置的默认值的管理员。 单击“自定义设置”选项后，会看到另外三个选项卡 - 用户、内容和同步。
用户
访问权限
GitHub 连接器支持对有权访问此数据源的 每个人 可见的搜索权限。 对于“所有人”，索引数据将显示在所有用户的搜索结果中。 有关标识转换，请参阅 映射非 Azure AD 标识 |Microsoft Learn。
内容
选择存储库和文件类型 (最初 markdown 文件和其他非代码文档) 您希望搜索。
管理属性
在这里，可以在 GitHub 数据源中添加或删除可用属性，将架构分配给属性， (定义属性是可搜索的、可查询的、可检索的还是可精简的) ，更改语义标签并向属性添加别名。
同步
刷新间隔确定数据在数据源和 Graph 连接器索引之间同步的频率。 有两种类型的刷新间隔 - 完全爬网和增量爬网。 有关详细信息，请参阅 刷新设置。
如果需要，可以从此处更改刷新间隔的默认值。
疑难解答
发布连接后，可以在管理中心的“数据源”选项卡下查看状态。 若要了解如何进行更新和删除，请参阅 管理连接器。
如果遇到问题或想要提供反馈，请联系 Microsoft Graph |支持。