共用方式為

部署 GitLab 知識雲 Microsoft 365 Copilot 連接器

GitLab 知識雲 Microsoft 365 Copilot 連接器允許您的組織索引儲存在 GitLab 的文件、維基及知識產物，並讓它們在 Microsoft 365 Copilot 與 Microsoft Search 體驗中可用。 本文說明部署與自訂 GitLab Knowledge Cloud 連接器的步驟。

必要條件

在部署連接器前，請確保你符合以下先決條件：

  • 你必須是 Microsoft 365 管理員。
  • 確認你的 GitLab 實例是透過 API 可存取的。
  • 從 GitLab 產生 客戶端 ID 和 客戶端秘密 。
  • 確保認證帳號能存取資料庫、維基、跑手冊、文件和知識檔案。
  • 用戶端 ID 與用戶端秘密必須包含以下範圍：
    • read_api
    • read_repository
    • read_user
  • 存取已索引 GitLab 資料的使用者必須擁有對應的 Microsoft Entra ID 身份以進行權限映射。
  • 在 GitLab 認證設定時，請設定適當的重定向 URL：
    • Microsoft 365 企業版：https://gcs.office.com/v1.0/admin/oauth/callback
    • Microsoft 365 政府：https://gcsgcc.office.com/v1.0/admin/oauth/callback

展開連接器

要為你的組織新增 GitLab Knowledge Cloud 連接器：

  1. 在 Microsoft 365 系統管理中心左側窗格，選擇 Copilot>連接器。
  2. 選擇 圖庫 標籤。
  3. 從可用連接器清單中，選擇 GitLab Knowledge Cloud。

集合顯示名稱

顯示名稱用來識別 Copilot 回應中的參考資料，並協助使用者辨識內容來源。 你可以接受預設 的 GitLab Knowledge Cloud 顯示名稱，或是自訂它。

選擇認證類型

GitLab Knowledge Cloud 連接器支援 OAuth 2.0 認證。 選擇 OAuth 2.0，輸入 你的客戶端 ID 和 客戶端秘密，然後選擇 授權。

推出

若要推送至有限受眾，請選擇「 推展」 旁的「有限受眾」切換，並指定要推送連接器的使用者與群組。 欲了解更多資訊，請參閱 Copilot 連接器的分階段部署。

選擇 建立 來部署連線。 GitLab Knowledge Cloud 連接器能立即開始索引內容。

下表列出預設值。

類別 預設值
使用者 只有有權取得此資料來源的人
內容 過去365天內容被索引
同步處理 增量：15分鐘;完整：每日

要自訂這些數值，請選擇 自訂設定。

建立連線後，您可以在 Microsoft 365 系統管理中心的連接器區查看狀態。

自訂設定 (可選)

你可以自訂 GitLab Knowledge Cloud 連接器設定的預設值。 要自訂設定，在管理中心的連接器頁面選擇 自訂設定。

自訂使用者設定

存取權限

選擇下列其中一個選項：

  • 只有有權限存取此資料來源的人 (預設)
  • 每個人

如果你選擇 「僅限有權限存取此資料來源的人」，索引資料會出現在有權限存取資料的使用者搜尋結果中。 如果你選擇 「所有人」，索引資料會出現在所有使用者的搜尋結果中。

對應身分識別

為確保權限正確應用，請將 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 分鐘一次。
  • 完整爬行： 預設是每日。

你可以調整這些間隔以符合組織需求。 欲了解更多資訊，請參閱 同步設定指引。

下表列出 GitLab Knowledge Cloud 連接器內容擷取的速率限制。

項目數量大致 完成吞食的近似時間
多達10萬 6 小時內
100,000 到 1,000,000 6小時到3天
1,000,000 或更多 3天至2週 (依環境負荷) 而異

相關內容

  • Last updated on