GitHub Cloud Knowledge Microsoft 365 Copilot 連接器讓組織能夠將 GitHub 倉庫中的 markdown 與文字檔案索引到 Microsoft 365 Copilot 與 Microsoft Search 體驗中。 透過將 GitHub 內容與 Microsoft 365 整合，使用者能直接在熟悉的應用程式中存取專案文件與技術指南，減少上下文切換並提升生產力。
為什麼要使用 GitHub Cloud Knowledge 連接器來索引你的資料？
GitHub Cloud Knowledge 連接器非常適合使用 GitHub 進行文件、專案檔案或內容管理的組織。 你可以用這個連接器來：
- 讓專案文件在 Microsoft 365 中可搜尋。
- 允許使用者向 Copilot 提問，例如：
- 如何？設定 Project Alpha？
- 我在哪裡可以找到部署說明？
- 這個專案的架構概述是什麼？
- 在專案文件中總結關鍵章節以便快速查閱。
使用 GitHub Cloud Knowledge 連接器建置代理程式
開發者可以在使用 Copilot Studio、Microsoft 365 Copilot 中的 Agent Builder，或 Microsoft 365 Agents 工具包時，將此連接器作為知識來源。
代理提示
以下範例展示了代理建構者可用來幫助使用者從 GitHub Cloud 知識連接器取回資訊的提示。
| 角色 | 範例提示 |
|---|---|
| Developer | 總結 Project Alpha 的架構概述。 |
| 專案經理 | 列出最新版本的所有部署步驟。 |
| 支援工程師 | 我在哪裡可以找到 API 整合的故障排除說明？ |
GitHub Cloud Knowledge 連接器的功能與限制
GitHub Cloud Knowledge 連接器讓使用者能夠：
- 索引 GitHub Cloud 倉庫、標記清單和文字檔，讓專案文件在 Microsoft 365 中可存取。
- 在 Copilot 中執行自然語言查詢以取得技術指南與文件。
- 利用語意搜尋根據關鍵字、偏好和社交連結尋找相關內容。
- 總結專案文件以便快速查閱。
GitHub Cloud Knowledge 連接器有以下限制：
- 只有儲存庫的元資料、markdown 和文字檔案會被索引。 問題、拉取請求和評論都不會被索引。
- 僅支援 Markdown 及大小不超過 30 MB 的文字檔。 較大的檔案不會被索引。
- 出於安全考量，該連接器不支援所有資料庫皆為公開的組織進行索引。 要解除此情境阻擋，請聯絡 Microsoft 客服。
資料型別索引自 GitHub Cloud Knowledge
連接器索引以下資料型態。
| 資料類型 | 描述 |
|---|---|
| Markdown 檔案 | 專案文件與指南 |
| 文字檔 | 技術說明與說明 |
| 儲存庫元資料 | 基本儲存庫資訊 |
索引內容會出現在 Microsoft 365 Copilot 回應和 Microsoft 搜尋結果中。
權限模型與存取控制
該連接器在顯示搜尋結果時會強制執行 GitHub 權限。 索引資料可顯示為：
- 只有有權限存取此資料來源的人 (預設) ：結果只顯示在 GitHub 有權限的使用者。
- 所有人：結果會顯示組織中所有使用者的結果。
為了準確執行權限，必須在 GitHub 與 Microsoft Entra ID 之間進行身份映射。 地圖選項包括：
- 電子郵件
- 登入
- 名稱
如果直接映射失敗，你可以用正則表達式 (正則表達式) 來轉換身份資料。