GitHub AI Connector

誰可以將 GitHub 連接到 Notion AI？

• 您必須是 GitHub 組織擁有者和 Notion 工作空間擁有者。

• 你的工作空間必須使用商業版 (Business) 或企業版 (Enterprise) 方案，且成員人數需超過一人。

一旦為工作空間設定好 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 連接器，它就能索引程式碼、提取要求（PR）、問題（Issues）、檔案與 README。

每位使用者僅能使用 Notion AI 查看並搜尋他們在 GitHub 中有權存取的內容。Notion AI 可以檢索過去一年的提取要求相關資訊。

您可以透過下列位置的 Notion AI 連接器搜尋 GitHub：

• Notion 右下角的 Notion AI 聊天視窗。

• 首頁頂端的 Notion AI 小工具。

• 側邊欄中的搜尋。

您可以透過在聊天中開啟 所有來源 切換開關、以及在 首頁 選取 GitHub，將搜尋範圍縮小至僅限 GitHub。您也可以篩選 Notion AI 搜尋 結果，僅顯示來自 GitHub 的資訊。

GitHub AI 連接器最有助於：

• 詢問近期變更與專案更新。

• 尋找程式碼實作。

• 查詢問題及其狀態。

• 除錯問題。例如，您可以透過閱讀近期的提取要求來取得功能失效或出現錯誤時的背景資訊。

• 尋找安全性模式。

你可以嘗試使用以下（文字）指令來詢問 Notion AI：

• 「{project name} 的最新進度為何？」

• 「我們上週處理了哪些提取要求？」

• 「我們驗證系統近期的變更為何？」

• 「向我展示我們如何在程式碼庫中實作錯誤處理的範例。」

• 「我們前端元件中使用的主要相依性有哪些？」

• 「尋找資料庫遷移函數的實作。」

• 「我們對 API 端點使用了哪些安全性模式？」