部署 GitHub Cloud Pull Requests Microsoft 365 Copilot 連接器

GitHub Cloud Pull Request Microsoft 365 Copilot 連接器，讓您的組織能將儲存在 GitHub 倉庫中的拉取請求索引至 Microsoft 365 Copilot 與 Microsoft Search 體驗。 本文說明部署與客製化連接器的步驟。 關於 Copilot 連接器部署的一般資訊，請參閱 Microsoft 365 系統管理中心的「設定 Copilot 連接器」。

欲了解進階的 GitHub 設定資訊，請參閱 「設定 GitHub 服務以擷取連接器」。

必要條件

在部署 GitHub Cloud Pull Requests 連接器之前，請確保 GitHub 環境已在你的組織中設定好。 下表總結了配置 GitHub 環境及部署連接器的步驟。

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

• 你是 Microsoft 365 管理員。
• 你的 GitHub 實例是透過 API 存取的。
• 會建立並設定一個 GitHub 應用程式以進行認證。
• 用於認證的帳號可以存取需要索引的倉庫和拉取請求。
• 存取已索引 GitHub 資料的使用者，會擁有對應的 Microsoft Entra ID 身份以進行權限映射。

展開連接器

要為你的組織新增 GitHub Cloud Pull Requests 連接器：

1. 在 Microsoft 365 系統管理中心左側窗格，選擇 Copilot>連接器。
2. 到「 連接器 」分頁，在左側窗格選擇 「圖庫」。
3. 從可用連接器列表中，選擇 GitHub Cloud Pull Requests。

集合顯示名稱

顯示名稱用於識別 Copilot 回應中的參考，幫助使用者辨識相關檔案或項目。 顯示名稱同時代表受信任的內容，並用作內容來源過濾器。

你可以接受預設的 GitHub Cloud Pull Requests 顯示名稱，或自訂值，使用組織使用者熟悉的顯示名稱。

欲了解更多關於連接器顯示名稱與描述的資訊，請參閱「以 Microsoft 365 Copilot 連接器內容強化 Copilot 發現」。

選擇認證類型

連接器支援以下認證類型：

• OAuth (推薦) ：使用 OAuth 認證：

  • 在 GitHub 組織中安裝 GitHub Issues 的 GitHub 應用程式 。
  • 選擇一個顯示名稱，幫助使用者辨識連結。
  • 輸入你的組織名稱。
  • 選擇 授權 登入並授權存取。

  注意事項

  此認證方法目前仍處於預覽階段。

• 代表使用者) 自訂的 GitHub 應用程式 (：從 GitHub 應用程式輸入你的客戶端 ID 和客戶端秘密，並授權存取權限。

• 自訂 GitHub 應用程式 (安裝) ：使用由 GitHub 應用程式產生的私鑰。 輸入客戶 ID 和組織名稱，並上傳私鑰。

關於如何建立 GitHub 應用程式的資訊，請參閱「 使用自訂 GitHub 應用程式進行認證」。

推出

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

選擇 建立 來部署連線。 GitHub 雲端拉取請求 Copilot 連接器會立即開始索引內容。

下表列出預設值。

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

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

自訂設定 (可選)

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

自訂使用者設定

存取權限

選擇索引資料是否可見於：

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

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

映射恆等式

為確保權限執行正確，請將 GitHub 使用者身份映射至 Microsoft Entra ID。 選項如下︰

• Email：Maps GitHub 電子郵件到 Microsoft Entra ID 使用者屬性。
• 登入：Maps GitHub 登入時會用 Microsoft Entra ID 使用者屬性。
• 姓名：Maps GitHub 名稱與 Microsoft Entra ID 使用者屬性。

若直接映射失敗，使用 正則表達式 (正則表達式) 來轉換資料。 例如：[a-zA-Z0-9]+

如果組織管理員設定預設成員權限以限制儲存庫存取，連接器會遵守此設定。 使用者無法查看組織倉庫，除非他們被明確加入為協作者。

對於使用 Bring Your Own Key (BYOK) 模式而非 EMU) 企業管理使用者 (企業，每位使用者都必須在其 GitHub 帳號設定中啟用分享所需身份欄位的權限。 此步驟確保 GitHub 與組織目錄間的身份正確映射。

自訂內容設定

在 內容 標籤中，你可以驗證範例資料中的屬性映射，涵蓋內容、標籤、描述和時間戳記等元資料。

時間範圍濾波器

你可以設定時間範圍過濾器。 預設設定是 365 天。

管理物業

你可以新增或移除屬性、指派結構屬性，並定義語意標籤。 以下屬性預設為索引。

自訂同步間隔

刷新間隔決定了你的資料同步頻率。 您可以自訂以下預設值：

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

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

相關內容

• GitHub Cloud Pull Requests 連接器概述
• 排除 GitHub Cloud Pull Requests 連接器的問題
• 在 Microsoft 365 系統管理中心設置 Copilot 連接器