GitLab Knowledge Cloud Microsoft 365 Copilot 連接器問題故障排除

GitLab 知識雲Microsoft 365 Copilot連接器會索引存放在 GitLab 專案中的文件與知識產物，GitLab.com。本文提供你在部署並使用 GitLab Knowledge Cloud 連接器時可能遇到的常見錯誤的故障排除資訊。這些問題通常與驗證、權限、內容遺失或 GitLab API 存取有關。

在 Copilot 或 Microsoft Search 找不到 GitLab 的知識內容

如果使用者在 Copilot 或搜尋結果中找不到 GitLab 文件、維基或知識產物，請參考以下內容：

確認 GitLab 實例的網址是否正確。
確認 GitLab OAuth 應用程式具備所需的範圍：
- read_api
- read_repository
- read_user
確認已認證的 GitLab 帳號是否能存取所有已索引的專案、維基和檔案。
確保使用者擁有正確對應 GitLab 使用者的 Microsoft Entra ID 身份。
除非有自訂) ，請確認內容是否在過去 365 天 (預設索引範圍內。

缺少某些 GitLab 專案、維基或 runbook 的存取權限

如果搜尋結果或 Copilot 回應中缺少部分內容：

確認設定連接器時所使用的 GitLab 帳號的權限。
檢查缺少的專案、維基頁面或執行手冊是否需要專案層級的權限。
確認身份映射規則是否正確地將 GitLab 使用者與 Microsoft Entra ID 帳號配對。
若使用正則表達式轉換，請確保模式符合預期的使用者識別碼。

GitLab OAuth 授權問題

如果你在完成 OAuth 流程時遇到困難：

確認 客戶端 ID 和 客戶端秘密 是有效的，且屬於為你租戶設定的 GitLab OAuth 應用程式。
請確認正確的轉址網址已設定：
- Microsoft 365 企業版：https://gcs.office.com/v1.0/admin/oauth/callback
- Microsoft 365 政府：https://gcsgcc.office.com/v1.0/admin/oauth/callback
檢查你的 GitLab 實例是否啟用了單一登入 (SSO) 。有些 SSO 流程要求帳號在授權前必須單獨登入。

GitLab API 速率限制或不完整擷取

如果索引暫停或內容看起來不完整：

檢查你的 GitLab 租戶是否達到速率限制。
檢視攝取量指引：
- 最多100,000件物品：通常在數小時內完成。
- 100,000 到 1,000,000 件物品：攝取可能需要多天時間。
- 超過1,000,000件：攝取時間可能從數天到數週不等，視負載而定。
例如，暫時縮小索引範圍 (，透過縮小日期範圍) 來判斷效能是否提升。
檢視同步間隔的自訂，以確保符合組織需求：
- 增量爬行：預設 (15 分鐘)
- 完整爬行：每日 (預設)

Copilot 中出現錯誤或意外的搜尋結果

如果 Copilot 回應顯示出意料之外的內容或遺漏了預期的 GitLab 文件：

請在資料標籤中確認屬性映射。
確認重要欄位——如標題、內容、描述、標籤和時間戳——是否正確映射並設定正確。
確認標示 可搜尋、 可檢索或 可精煉 的資產是否符合您的內容需求。
檢查查詢字串設定，確認篩選沒有排除必要內容。

身份映射問題

若使用者無法看到預期內容：

確認身份映射是否與你的 GitLab 租戶相符：
- 電子郵件
- 登入
- 名稱
- 正則表達式轉換
確保 GitLab 和 Microsoft Entra ID 使用者在所有必需屬性上都一致。
如果映射規則複雜，建議用一小組帳號測試以驗證正確的映射行為。

權限問題

若使用者收到 無存取 錯誤：

確認 GitLab REST API 權限允許連接器的服務帳號完整閱讀文件、維基和知識資產。
請檢查 Microsoft 365 的存取設定：
- 只有有權取得此資料來源的人
- 每個人
確認 GitLab 群組或專案層級的權限沒有阻止連接器擷取內容。

GitLab 實例 URL 錯誤

如果連接器回報實例 URL 問題：

確保實例網址與用來架設知識內容的 GitLab 部署相符。
- GitLab.com 的話，請使用 https://gitlab.com。
- 對於 GitLab 自管理實例，請確認 URL 是否可從 Microsoft 365 環境中存取。

Last updated on 2026-01-24

共用方式為