GitHub AI 连接器

谁可以将 GitHub 连接到 Notion AI？

• 你必须是 GitHub 组织所有者和 Notion 工作空间所有者。

• 你的工作空间必须处于商业版或企业版方案，并且拥有多于一名成员。

一旦为工作空间设置了 GitHub AI 连接器，成员即可使用该集成来检索答案：

• 公共仓库：所有者完成初始连接器设置后，无需额外身份验证。

• 私有仓库：每位成员都必须使用 GitHub 登录/进行身份验证以验证访问权限。

我该如何连接 GitHub？

将 GitHub 连接到 Notion AI 有两种不同的方法。要连接 GitHub 组织，你需要是工作空间所有者和 GitHub 所有者。要连接私有仓库，你可以是工作空间成员。

如果你是 Notion 工作空间所有者和 GitHub 所有者：

要将 GitHub 连接到你的 Notion 工作空间：

1. 前往 设置 → Notion AI。

2. 选择 +，位于 GitHub 旁边。

   

3. 你将被跳转至 GitHub。请确保你已登录正确的 GitHub 账号。在设置过程中不要关闭 Notion！

   

4. 在打开的页面中，连接到 GitHub 并选择你想要同步的组织。请注意，如果你想连接个人 GitHub 仓库，必须先创建一个组织，然后将该仓库移动到该组织中。

5. 选择 所有仓库（推荐）或 选择仓库，然后选择 安装。

6. 返回 Notion。

集成设置完成后，它将能够索引自设置完成之日起一年内的拉取请求和问题。你还可以访问所有代码文件，包括 markdown 文件和 README，没有任何时间限制。

连接完成最多可能需要 72 小时。此后，你在 Notion 工作空间中的每位用户都必须单独使用 GitHub 进行身份验证才能使用该集成，他们的权限也将相应地进行映射。

如果你是 Notion 工作空间成员：

如果你不是 Notion 工作空间或 GitHub 组织的所有者，你需要先由所有者将 Notion 与 GitHub 连接，然后你才能使用该集成。一旦所有者完成设置，你就必须登录以连接你的私有仓库。操作步骤如下：

1. 在 Notion 中，打开屏幕底部的 Notion AI，然后点击 ••• → 连接 GitHub。

2. 选择 登录 并连接你的 GitHub 帐号。

一旦为工作空间设置了 AI 连接器，它就可以索引代码、拉取请求、问题、文件和 README。

每个用户只能使用 Notion AI 查看和搜索他们在 GitHub 中有权访问的内容。Notion AI 可以检索过去一年的 PR 信息。

你可以在以下位置，通过 Notion AI 连接器搜索 GitHub：

• Notion 右下角的 Notion AI 聊天。

• 主页顶部的 Notion AI 小组件。

• 侧边栏中的搜索。

你可以在聊天中以及 主页 打开 所有来源 的切换按钮，然后选择 GitHub，从而将搜索范围限定为仅 GitHub。你也可以筛选 Notion AI 搜索 结果，使其只显示来自 GitHub 的信息。

GitHub AI 连接器最适用于：

• 询问有关近期变更和项目更新的信息。

• 查找代码实现。

• 查询问题及其状态。

• 调试问题。例如，当功能出现故障或报错时，你可以通过阅读近期的拉取请求来了解相关上下文。

• 查找安全模式。

你可以尝试向 Notion AI 输入（文字）指令，如下：

• “{project name} 的最新进展如何？”

• “我们上周处理了哪些拉取请求？”

• “我们身份验证系统的近期变更是什么？”

• “向我展示我们在代码库中实现错误处理的示例。”

• “我们前端组件中使用的主要依赖项有哪些？”

• “查找数据库迁移函数的实现。”

• “我们为 API 端点使用了哪些安全模式？”