GitHub Cloud Knowledge Microsoft 365 Copilot 連接器讓組織能夠將 GitHub 倉庫中的 markdown 與文字檔案索引到 Microsoft 365 Copilot 與 Microsoft Search 體驗中。 本文提供你在部署或管理連接器時常見錯誤的故障排除資訊。
若要驗證 GitHub 設定資訊以協助排除錯誤，請參閱 「設定 GitHub 服務以擷取 GitHub Cloud Knowledge 連接器」。
GitHub Cloud Knowledge 連接器故障排除
下表列出常見錯誤及其解決步驟：
| 錯誤訊息或問題 | 可能原因 | 解決方案 |
|---|---|---|
| 認證失敗 | 錯誤的客戶端 ID、客戶端秘密或私鑰 | 確認 GitHub 應用程式的憑證是否正確。 如果需要，可以重新產生客戶端秘密。 詳情請參見 「設定 GitHub 服務」。 |
| 不支援單登入 | GitHub 認證流程在設定時不支援單一登入 (SSO) | 在執行設定操作前，請確保企業管理的使用者先登入。 |
| 無資料被索引 | API 存取未啟用或儲存庫選擇錯誤 | 確認你的 GitHub 實例是否能透過 API 存取，並且在連接器設定中選擇了正確的倉庫。 |
| 權限映射錯誤 | GitHub 身份未映射到 Microsoft Entra ID | 檢視身份映射設定。 使用電子郵件、登入或姓名映射選項。 如果直接映射失敗，則應用正則表達式轉換。 |
| 速率超過上限 | 使用單一帳號進行 OAuth 認證 | 使用不同的使用者帳號來進行 OAuth 認證，以避免觸及 GitHub 的速率限制。 |
| 大小寫敏感搜尋問題 | 儲存庫與檔案名稱依大小寫區分 | 使用索引瀏覽器或排解搜尋結果時，務必確認儲存庫和檔案名稱的外殼。 |