GitLab Knowledge Server 連接器允許 Microsoft 365 Copilot 與 Microsoft Search 索引儲存在 GitLab 自我管理實例中的知識內容。 本文提供你在連接器部署、設定或資料擷取過程中常見錯誤的故障排除指引。
認證失敗
若在連接器授權過程中認證失敗：
- 確認用戶端 ID 和用戶端秘密是從正確的 GitLab OAuth 應用程式產生的。
- 驗證所需的範圍是否被授予：
read_api、、read_repositoryread_user和 。 - 確保重定向網址與環境相符：
- Microsoft 365 企業版：
https://gcs.office.com/v1.0/admin/oauth/callback - Microsoft 365 政府：
https://gcsgcc.office.com/v1.0/admin/oauth/callback
- Microsoft 365 企業版：
- 確保認證帳號能存取資料庫、維基和文件檔案。
內容未被索引
如果開始吞食但沒有出現任何物品：
- 確認 GitLab 實例是否可從執行 Microsoft Graph 連接器代理的伺服器存取。
- 確保 GitLab 的 API 速率限制沒有阻擋資料擷取。 停用或提高使用者、IP 或 API 請求限制。
- 確認 GitLab 版本是 17.7 或更新版本。
- 請確認代理版本是 3.1.8.0 或更新版本。
- 確認連結帳號擁有所有相關專案的倉庫和維基存取權。
緩慢吞食或爬行延遲
如果攝取過程緩慢：
- 提高 GitLab 對使用者、IP、檔案 API、已棄用 API、使用者 API、群組 API、專案 API 及成員 API 的速率限制門檻。
- 對於大型環境，請使用以下指引：
- 最多 100,000 件商品：每小時 9,000 件請求
- 100,000–1,000,000 件商品：每小時 15,000 件請求
- 超過1,000,000件商品：每小時15,000件請求;攝取時間可能需1至2週，視系統負載而定
權限不匹配
如果使用者看到不應該有的搜尋結果，或沒有看到他們應該有的結果：
- 確認身份映射設定正確。 支援的映射屬性包括電子郵件、登入資訊和姓名。
- 如果 GitLab 和 Microsoft Entra ID 的使用者屬性不符，請設定正規表達式 (正則表達式) 來轉換值。
- 檢查電子郵件可見性設定或 GitLab 的混合網域是否阻礙了精確的對應。
- 確保所選存取模式 (只有擁有此資料來源存取 權的人或 所有人) 符合你組織的需求。
合併請求或基於角色的存取問題
若使用者在合併請求或某些 GitLab 角色中遇到權限問題：
- 僅限專案成員對公共專案的合併申請權限，則在報告員或更高階職位時會被強制執行。
- 規劃師角色因穩定性考量被棄用。 將報告者角色或更高角色指派給需要存取權限的使用者。
Microsoft Graph 連接器代理問題
若代理無法連線或報告錯誤：
- 確認代理主機電腦能透過所需埠口存取 GitLab Server 實例。
- 確認代理程式有足夠的記憶體和 CPU 容量。
- 重新啟動代理服務並嘗試再次攝取。