共用方式為

部署 GitLab Issues 雲端 Microsoft 365 Copilot 連接器

GitLab Issues Cloud 連接器允許您的組織索引儲存在 GitLab 中的議題，並將它們提供在 Microsoft 365 Copilot 和 Microsoft Search 中。 本文說明部署與自訂 GitLab Issues Cloud 連接器的步驟。

必要條件

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

  • 確認你的 GitLab 實例是否能透過 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 Issues Cloud 連接器：

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

集合顯示名稱

顯示名稱用來識別 Copilot 回應中的參考資料，並幫助使用者辨識相關內容來源。 你可以接受預設 的 GitLab Issues Cloud 顯示名稱，或自訂以符合組織需求。

欲了解更多資訊，請參閱 增強 Copilot 對連接器內容的發現。

設定實例網址

請提供 GitLab 實例的網址。 對於 GitLab Cloud，這個網址通常是：

https://gitlab.com

選擇認證類型

該連接器支援 GitLab 的 OAuth 2.0 。

要驗證：

  • 輸入 GitLab 的客戶端 ID 和客戶端秘密。
  • 選擇 [授權]。

關於如何在 GitLab 中建立 OAuth 應用程式的資訊，請參閱 「配置 GitLab 作為 OAuth 2.0 認證身份提供者」。

推出

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

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

下表列出預設值。

類別 預設值
使用者 只有有權取得此資料來源的人
內容 時間範圍濾波器：365天
同步處理 漸進爬行：每15分鐘一次
完整爬行：每日

要自訂這些數值，請選擇 自訂設定。 欲了解更多資訊，請參閱 自訂設定。

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

自訂設定 (可選)

你可以自訂 GitLab Issues 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 身份地圖。

自訂內容設定

查詢字串

檢視或編輯預設查詢字串，以精細化哪些項目被索引。

管理物業

你可以從資料來源新增或移除可用屬性，為屬性指派可搜尋、可查詢、可檢索或可精煉 () 的結構，更改語意標籤，並為屬性加上別名。 下表列出連接器預設索引的屬性。

Property 語意標籤 描述 結構屬性
title 標題 問題標題 可搜尋、可檢索
描述 內文 問題描述 可搜尋、可檢索
唱片公司 標記 發行標籤 可查詢、可精煉
作者 作者 問題作者 可搜尋、可檢索
created_at 建立日期 創作時間戳記 可查詢、可檢索
updated_at 修改日期 最後更新的時間戳記 可查詢、可檢索

自訂同步間隔

你可以自訂完整和增量爬行間隔。 以下是預設值：

  • 增量爬行： 每15分鐘一次。
  • 完整爬行： 每天。

欲了解更多資訊，請參閱 同步設定指引。

速率限制

下表列出適用於 GitLab Issues Cloud 連接器的速率限制。

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

相關內容

  • Last updated on