GitLab Issues Server Microsoft 365 Copilot 連接器將 GitLab 議題資料整合進 Microsoft 365。 當你部署此連接器時，Microsoft 365 Copilot 與 Microsoft Search 可以直接在 Teams、Outlook 和 SharePoint 等應用程式中顯示相關的 GitLab 問題。 本文說明部署與配置 GitLab Issues Server 連接器的步驟。
必要條件
在部署連接器前，請確保你符合以下先決條件：
- 確認你的 GitLab 實例是否能透過 API 存取。
- 從 GitLab 產生 一個客戶端 ID 和 客戶端秘密 以便驗證。
- 確保認證帳號能存取資料庫、議題、合併請求、知識檔案和維基頁面。
- 請確保 GitLab OAuth 範圍包含以下範圍：
read_api、、read_repositoryread_user。 - 確保存取索引 GitLab 資料的使用者擁有 Microsoft Entra ID 身份，以便權限映射。
- 在 GitLab 認證設定時，請設定正確的重定向網址：
- 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 實例，請確保：
- 你使用的是 GitLab 版本 17.7 或更新版本。
- 你在有 GitLab 存取權限的伺服器上安裝了 Microsoft Graph 連接器代理程式版本 3.1.8.0 或更新版本。
- 認證帳號擁有存取控制清單 (ACL) 爬行的管理權限。
- 為了達到最佳效能，請依建議調整 GitLab 的速率限制 ：
- 使用者與 IP 速率限制：取消勾選 啟用認證 API 請求速率限制 及 啟用認證網頁請求速率限制。
- 檔案 API 速率限制：取消勾 選 啟用認證 API 請求速率限制。
- 已棄用的 API 速率限制：取消勾選 啟用認證 API 請求速率限制。
- 使用者 API 速率限制：將 每位使用者每 10 分鐘的最大請求 設定為高值 (，例如 100000) 。
- 群組 API 與專案 API 速率限制：將所有值設為 0 以停用限制。
- 成員 API 速率限制：設為 0。
速率上限建議
請依照下表中的指引，根據 GitLab 問題的大致數量選擇速率限制設定。
| 項目數量大致 | 建議的速率限制設定 | 近似攝取時間 |
|---|---|---|
| 多達10萬 | 每小時20,000次請求 | 幾小時到一天 |
| 100,000 到 1,000,000 | 每小時25,000筆請求 | 兩天到一週 |
| 1,000,000 或更多 | 每小時25,000筆請求 | 1至2週 (依環境負荷而異) |
展開連接器
要為你的組織新增 GitLab Issues Server 連接器：
- 在 Microsoft 365 系統管理中心左側窗格，選擇 Copilot>連接器。
- 選擇 圖庫 標籤。
- 從可用連接器列表中，選擇 GitLab Issues Server。
集合顯示名稱
顯示名稱用來識別 Copilot 回應中的參考資料，並幫助使用者辨識相關內容來源。
你可以接受預設的 GitLab Issues Server 顯示名稱，或自訂它。
設定實例網址
請提供你 GitLab Server 實例的基礎網址。 基礎 URL 是連接器用來透過 GitLab REST API 存取發行資料的 URL。
選擇圖形連接器代理
選擇管理 GitLab 資料匯入 Microsoft 365 的 Microsoft Graph 連接器代理程式。 欲了解更多資訊，請參閱 Microsoft Graph 連接器代理程式。
選擇認證類型
GitLab Issues Server 連接器支援 OAuth 2.0。 輸入 GitLab 客戶端 ID 和 客戶端秘密，然後選擇 授權。
推出
要將連接器推展至有限受眾，請選擇「 有限受眾 」旁的切換，並指定使用者或群組。
選擇 建立 來部署連線。 GitLab Issues Server 連接器會立即開始索引內容。
要自訂連線，請選擇 自訂設定。 欲了解更多資訊，請參閱 自訂設定
建立連線後，您可以在 Microsoft 365 系統管理中心的 Copilot>連接器中查看連線狀態。
自訂設定 (可選)
你可以自訂 GitLab Issues Server 連接器設定的預設值。 要自訂設定，請在連接器頁面選擇 自訂設定 。
自訂使用者設定
存取權限
選擇索引資料是否可見於：
- 只有有權限存取此資料來源的人 (預設)
- 所有人
如果你選擇 僅限有權限存取此資料來源的人，索引資料只會顯示給授權使用者。 如果你選擇 「所有人」，所有使用者的索引資料就會出現。
對應身分識別
將 GitLab 使用者身份映射到 Microsoft Entra ID。 選項包括：
- Email：Maps GitLab 郵件寄到 Microsoft Entra ID 使用者屬性。
- 登入：Maps GitLab 登入時，會用 Microsoft Entra ID 的使用者屬性。
- 名稱：Maps GitLab 名稱搭配 Microsoft Entra ID 使用者屬性。
若直接映射失敗，使用正則表達式 (正則表達式) 來轉換資料。 例如：[a-zA-Z0-9]+。 欲了解更多資訊，請參閱 Microsoft Entra 身份地圖。
自訂內容設定
在 「資料」 標籤中，你可以驗證範例資料中內容、標籤、描述和時間戳等元資料的屬性映射。
內容過濾器
你可以為接頭設定一個時間範圍濾波器。 預設設定是 365 天。
管理物業
你可以從資料來源新增或移除可用屬性，為屬性指派可搜尋、可查詢、可檢索或可精煉 () 的結構，更改語意標籤，並為屬性加上別名。
自訂同步間隔
設定 完整 與 增量 爬行同步間隔。 以下是預設值：
- 增量爬行：每15分鐘一次
- 完整爬行：每日
根據組織的需求調整間隔。