GitHub Cloud Issues Microsoft 365 Copilot 連接器讓您的組織能夠索引 GitHub 議題，使其能在 Microsoft 365 Copilot 和 Microsoft Search 體驗中被呈現。 本文說明在 Microsoft 365 系統管理中心部署與自訂連接器的步驟。
欲了解進階的 GitHub 設定資訊，請參閱 「設定 GitHub 服務以擷取連接器」。
必要條件
在部署 GitHub Cloud Issues 連接器之前，請確保 GitHub Cloud 環境已在你的組織中被設定妥當。 下表總結了設定環境及部署連接器的步驟。
| 工作 | 角色 |
|---|---|
| 設定環境 | GitHub 管理員 |
| 在 Microsoft 365 系統管理中心部署連接器 | Microsoft 365 系統管理員 |
| 自訂連接器設定 (可選) | Microsoft 365 系統管理員 |
在部署 GitHub Cloud Issues 連接器之前，請確保：
- 你是 Microsoft 365 管理員。
- 你的 GitHub 環境是透過 API 配置並存取的。
- 會建立一個 GitHub 應用程式，用於取得所需權限的認證。
- 存取已索引 GitHub 資料的使用者，會擁有對應的 Microsoft Entra ID 身份以進行權限映射。
- 對於透過單一登入 (SSO) 進行認證的企業管理用戶，帳號在設定前就已登入。 GitHub 的認證流程在設定時不支援 SSO。
展開連接器
要為你的組織新增 GitHub Cloud Issues 連接器：
- 在 Microsoft 365 系統管理中心左側窗格，選擇 Copilot>連接器。
- 到「 連接器 」分頁，在左側窗格選擇 「圖庫」。
- 從可用連接器列表中，選擇 GitHub Cloud Issues。
集合顯示名稱
顯示名稱用來識別 Copilot 回應中的參考資料，並幫助使用者辨識相關內容來源。 你可以接受預設的 GitHub Cloud Issues 顯示名稱，或自訂它。
欲了解更多資訊，請參閱 增強 Copilot 對連接器內容的發現。
選擇認證類型
連接器支援以下認證類型：
OAuth (推薦) ：使用 OAuth 認證：
- 在 GitHub 組織中安裝 GitHub Issues 的 GitHub 應用程式 。
- 選擇一個顯示名稱，幫助使用者辨識連結。
- 輸入你的組織名稱。
- 選擇 授權 登入並授權存取。
注意事項
此認證方法目前仍處於預覽階段。
代表使用者) 自訂的 GitHub 應用程式 (：從 GitHub 應用程式輸入你的客戶端 ID 和客戶端秘密，並授權存取權限。
自訂 GitHub 應用程式 (安裝) ：使用由 GitHub 應用程式產生的私鑰。 輸入客戶 ID 和組織名稱，並上傳私鑰。
關於如何建立 GitHub 應用程式的資訊，請參閱「 使用自訂 GitHub 應用程式進行認證」。
推出
若要推展至有限受眾，請選擇「 有限受眾 」旁的切換，並指定使用者與群組。 欲了解更多資訊，請參閱 Copilot 連接器的分階段部署。
選擇 建立 來部署連線。 GitHub Cloud Issues 連接器會立即開始索引內容。
下表列出部署連接器時設定的預設值。
| 類別 | 預設值 |
|---|---|
| 使用者 | 基於電子郵件的身份映射 |
| 內容 | 以元資料、標籤和時間戳標記索引的問題 |
| 同步處理 | 每15分鐘進行一次漸進爬行;每日完整爬行 |
要自訂這些數值，請選擇 自訂設定。 欲了解更多資訊，請參閱 自訂設定。
建立連線後，請檢視 Microsoft 365 系統管理中心連接器區塊的狀態。
自訂設定 (可選)
你可以自訂 GitHub Cloud Issues 連接器設定的預設值。 要自訂設定，在管理中心的連接器頁面選擇 自訂設定。
自訂使用者設定
存取權限
指定哪些使用者和群組可以存取已索引的 GitHub 內容。
映射恆等式
為確保權限正確應用，請將 GitHub 使用者身份對應至 Microsoft Entra ID。 請選擇以下之一的映射選項：
- Email：Maps GitHub 電子郵件到 Microsoft Entra ID 使用者屬性。
- 登入：Maps GitHub 登入時會用 Microsoft Entra ID 使用者屬性。
- 姓名：Maps GitHub 名稱與 Microsoft Entra ID 使用者屬性。
若直接映射失敗，使用正則表達式 (正則表達式) 來轉換資料。 例如：[a-zA-Z0-9]+。 欲了解更多資訊，請參閱 Microsoft Entra 身份地圖。
如果組織管理員設定預設成員權限以限制儲存庫存取，連接器會遵守此設定。 使用者無法查看組織倉庫，除非他們被明確加入為協作者。
對於使用 Bring Your Own Key (BYOK) 模式而非 EMU) 企業管理使用者 (企業，每位使用者都必須在其 GitHub 帳號設定中啟用分享所需身份欄位的權限。 此步驟確保 GitHub 與組織目錄間的身份正確映射。
自訂內容設定
在內容標籤中，你可以驗證範例資料中的屬性映射，涵蓋內容、標籤、描述和時間戳記等元資料。
內容過濾器
你可以為接頭設定一個時間範圍濾波器。 預設設定是 365 天。
管理物業
你可以從資料來源新增或移除可用屬性，為屬性指派可搜尋、可查詢、可檢索或可精煉 () 的結構，更改語意標籤，並為屬性加上別名。 連接器預設索引以下屬性。
| Property | 語意標籤 | 描述 | 結構屬性 |
|---|---|---|---|
| title | 標題 | 問題標題 | 可搜尋 |
| 描述 | 內容 | 問題描述 | 可搜尋 |
| 唱片公司 | 標記 | 發行標籤 | 可精簡搜尋 |
| 時間戳記 | Date | 創建與更新日期 | 可排序 |
自訂同步間隔
設定完整與增量爬行同步間隔。 以下是預設值：
- 增量爬行： 每15分鐘一次
- 完整爬行： 每日
你可以調整這些間隔以符合組織需求。 欲了解更多資訊，請參閱 同步設定指引。
注意事項
Webhook 支援現已提供預覽版。 請務必在儲存庫層級和組織層級 (設定 Webhook 的讀取與寫入) 權限。 Webhook 讓您能利用強化的自動化與即時更新，確保更無縫且靈敏的整合體驗。