GitHub Cloud Knowledge 連接器讓組織能夠將 GitHub 倉庫中的 markdown 與文字檔案索引到 Microsoft 365 Copilot 和 Microsoft Search 體驗中。 本文說明部署與客製化連接器的步驟。 關於 Copilot 連接器部署的一般資訊，請參閱 Microsoft 365 系統管理中心的「設定 Copilot 連接器」。
欲了解進階的 GitHub 設定資訊，請參閱 「設定 GitHub 服務以擷取連接器」。
必要條件
在部署 GitHub Cloud Knowledge 連接器之前，請確保 GitHub Cloud 環境已在你的組織中被設定妥當。 下表總結了設定環境及部署連接器的步驟。
| 工作 | 角色 |
|---|---|
| 設定環境 | GitHub 管理員 |
| 展開連接器 | Microsoft 365 系統管理員 |
| 自訂連接器設定 (可選) | Microsoft 365 系統管理員 |
在部署 GitHub Cloud Knowledge 連接器之前，請確保：
- 你是你組織的 Microsoft 365 管理員。
- 你的 GitHub 實例是透過 API 存取的。
- 會建立並設定一個 GitHub 應用程式以進行認證。
- 存取已索引 GitHub 資料的使用者，會擁有對應的 Microsoft Entra ID 身份以進行權限映射。
- 對於透過單一登入 (SSO) 進行認證的企業管理用戶，該帳號在設定前已登入。 GitHub 的認證流程不支援 SSO。
展開連接器
要為你的組織新增 GitHub Cloud Knowledge 連接器：
- 在 Microsoft 365 系統管理中心左側窗格，選擇 Copilot>連接器。
- 到「 連接器 」分頁，在左側窗格選擇 「圖庫」。
- 從可用連接器列表中，選擇 GitHub Cloud Knowledge。
集合顯示名稱
顯示名稱用來識別 Copilot 回應中的參考資料，並表示可信內容。 你可以接受預設的 GitHub Cloud Knowledge 顯示名稱，或選擇組織內使用者熟悉的名稱。
欲了解更多資訊，請參閱 增強 Copilot 對連接器內容的發現。
設定實例網址
輸入連接器會索引的 GitHub 組織網址。 例如：
https://github.com/<organization-name>
選擇認證類型
連接器支援以下認證類型：
OAuth (推薦) ：使用 OAuth 認證：
- 在 GitHub 組織中安裝 GitHub Issues 的 GitHub 應用程式 。
- 選擇一個顯示名稱，幫助使用者辨識連結。
- 輸入你的組織名稱。
- 選擇 授權 登入並授權存取。
注意事項
此認證方法目前仍處於預覽階段。
代表使用者) 自訂的 GitHub 應用程式 (：從 GitHub 應用程式輸入你的客戶端 ID 和客戶端秘密，並授權存取權限。
自訂 GitHub 應用程式 (安裝) ：使用由 GitHub 應用程式產生的私鑰。 輸入客戶 ID 和組織名稱，並上傳私鑰。
關於如何建立 GitHub 應用程式的資訊，請參閱「 使用自訂 GitHub 應用程式進行認證」。
推出
若要推展至有限受眾，請選擇「 有限受眾 」旁的切換，並指定使用者與群組。 欲了解更多資訊，請參閱 Microsoft 365 Copilot 連接器的分階段部署。
選擇 建立 來部署連線。 GitHub Cloud Knowledge 連接器能立即開始索引內容。
下表列出預設值。
| 類別 | 預設值 |
|---|---|
| 使用者 | 只有有權取得此資料來源的人 |
| 內容 | 來自選定軟體庫的 Markdown 與文字檔案 |
| 同步處理 | 每15分鐘進行一次漸進爬行;每日完整爬行 |
要自訂這些數值，請選擇 自訂設定。 欲了解更多資訊，請參閱 自訂設定。
建立連線後，您可以在 Microsoft 365 系統管理中心的連接器區查看狀態。
自訂設定 (可選)
你可以自訂 GitHub Cloud Knowledge 連接器設定的預設值。 要自訂設定，在管理中心的連接器頁面選擇 自訂設定。
自訂使用者設定
存取權限
選擇索引資料是否可見於：
- 只有有權限存取此資料來源的人 (預設)
- 每個人
如果你選擇 「僅限有權限存取此資料來源的人」，索引資料會出現在有權限存取資料的使用者搜尋結果中。 如果你選擇 「所有人」，索引資料會出現在所有使用者的搜尋結果中。
映射恆等式
為確保權限正確應用，請將 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 與組織目錄間的身份正確映射。
自訂內容設定
在 內容 標籤中，你可以驗證範例資料中的屬性映射，涵蓋內容、標籤、描述和時間戳記等元資料。
選擇你想讓可搜尋的 Markdown 檔案、文字文件) 儲存庫和檔案類型 (。
管理物業
你可以新增或移除屬性、指派結構屬性，並定義語意標籤。 以下屬性預設為索引：
| Property | 語意標籤 | 描述 | 結構屬性 |
|---|---|---|---|
| 檔案名稱 | 標題 | 檔案名稱 | 可搜尋、可檢索 |
| 存放庫 | 來源 | GitHub 倉庫名稱 | 可搜尋、可查詢 |
| 內容 | 內文 | Markdown 或文字檔內容 | 可搜尋、可檢索 |
自訂同步間隔
刷新間隔決定了你的資料同步頻率。 預設值：
- 增量爬行：每15分鐘一次
- 完整爬行：每日
你可以根據需要調整這些數值。 欲了解更多資訊，請參閱 同步設定指引。
注意事項
Webhook 支援現已提供預覽版。 請務必在儲存庫層級和組織層級 (設定 Webhook 的讀取與寫入) 權限。 Webhook 讓您能利用強化的自動化與即時更新，確保更無縫且靈敏的整合體驗。