GitHub Server Knowledge 連接器將 GitHub Enterprise 知識整合進 Microsoft 365，使 Copilot 與 Microsoft Search 能直接在 Teams、Outlook 和 SharePoint 等應用程式中顯示相關的維基頁面、標記檔案和部落格。 本文說明部署與客製化連接器的步驟。
關於 GitHub 設定資訊，請參見 「設定 GitHub 服務以擷取連接器」。
必要條件
在部署 GitHub Server Knowledge 連接器之前，請確保 GitHub 環境已在你的組織中被設定妥當。 下表總結了配置 GitHub 環境及部署連接器的步驟：
| 工作 | 角色 |
|---|---|
| 配置 GitHub 環境 | GitHub 管理員 |
| 在 Microsoft 365 系統管理中心部署連接器 | Microsoft 365 系統管理員 |
| 自訂連接器設定 (可選) | Microsoft 365 系統管理員 |
在部署連接器前，請確保：
- 你是 Microsoft 365 管理員。
- 你的 GitHub Enterprise 實例是透過 API 存取的。
- 會建立並安裝一個 GitHub 應用程式，並取得所需的權限。
- 用於認證的使用者帳號擁有存取待索引的資料庫與知識。
- 存取已索引 GitHub 資料的使用者，會擁有對應的 Microsoft Entra ID 身份以進行權限映射。
- Microsoft Graph Connector Agent 安裝在擁有 GitHub 實例存取權限的裝置上， (3.1.11.0 版本或更新版本) 。
展開連接器
要為你的組織新增 GitHub Server Knowledge 連接器：
- 在 Microsoft 365 系統管理中心左側窗格，選擇 Copilot>連接器。
- 到「 連接器 」分頁，在左側窗格選擇 「圖庫」。
- 從可用的連接器列表中，選擇 GitHub Server Knowledge。
集合顯示名稱
顯示名稱用來識別 Copilot 回應中的參考資料，並表示可信內容。 你可以接受預設的 GitHub Server Knowledge 顯示名稱，或自訂為使用者熟悉的名稱。
設定實例網址
輸入你 GitHub Enterprise 伺服器的實例網址。 此網址通常格式如下：
https://github.<your-domain>.com
選擇認證類型
連接器支援以下認證類型：
- GitHub 應用程式 (代表使用者) ：大多數情境推薦。 從 GitHub 應用程式輸入你的客戶 ID 和客戶秘密，並授權存取權限。
- GitHub 應用程式 (安裝) ：使用從你的 GitHub 應用程式產生的私鑰。 輸入客戶 ID 和組織名稱，並上傳私鑰。 請注意，此認證類型目前仍處於預覽階段。 若要使用此認證類型，請聯絡 Microsoft 客服。
關於如何建立 GitHub 應用程式的資訊，請參閱「 使用自訂 GitHub 應用程式進行認證」。
推廣至有限族群
如果你想在擴展部署前，先在 Copilot 和 Microsoft Search 驗證這個連線，建議先部署給有限的使用者群。 欲了解更多，請參閱 Copilot 連接器的分階段部署。
選擇 建立 來部署連線。 GitHub Server Knowledge 連接器會立即開始索引內容。
建立連線後，您可以在 Microsoft 365 系統管理中心的連接器區查看狀態。
下表列出部署連接器時設定的預設值。
| 類別 | 預設值 |
|---|---|
| 使用者 | 存取權限設定為 僅限有權限存取此資料來源的人。 |
| 內容 | 從選定的倉庫索引 Markdown 檔案與文字文件。 |
| 同步處理 | 每15分鐘進行一次漸進爬行;每天全程爬行。 |
要自訂這些數值，請選擇 自訂設定。 你可以編輯使用者權限、管理屬性映射，並調整同步間隔。
自訂設定 (可選)
你可以自訂 GitHub Server 知識連接器設定的預設值。 要自訂設定，在管理中心的連接器頁面選擇 自訂設定。
自訂使用者設定
存取權限
選擇其中之一：
- 只有有權限存取此資料來源的人 (預設)
- 每個人
恆等映射
為確保權限正確應用，請將 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 身份地圖。
如果組織管理員設定預設成員權限以限制儲存庫存取，連接器會遵守此設定。 使用者無法查看組織倉庫，除非他們被明確加入為協作者。
對於使用 BYOU 模型 (而非企業管理使用者) 的企業，每位使用者必須在其 GitHub 帳號設定中啟用分享特定使用者身份欄位的權限，以便進行身份映射。
自訂內容設定
選擇你想讓) 可搜尋的 Markdown 檔案庫和檔案類型 (。
管理物業
你可以從 GitHub 資料來源新增或移除可用屬性，為屬性指派結構 (定義屬性是否可搜尋、查詢、可檢索或可精煉) ，更改語意標籤，並為屬性加上別名。
同步間隔
刷新間隔決定了資料在資料來源與連接器索引之間同步的頻率。 以下是預設值：
- 增量爬行：每15分鐘一次
- 完整爬行：每日
你可以在 同步 標籤中更改這些預設值。欲了解更多資訊，請參閱 同步設定指引。