秘訣
推薦項目: 從 Work IQ 開發工具 開始,支援專業程式碼宣告式代理程式和外掛程式案例。 請參閱 WIQD 快速入門。 工具組式指示仍然適用於需要工具組的指示的現有專案和工作流程。 在選擇工具之前,請先檢查 功能和目標體驗支援 : WIQD 不會以自訂引擎代理程式為目標。
本逐步解說會保留工具組的同步連接器範本。 它建置擷取服務,而不是 WIQD 外掛程式所使用的遠端 MCP 連接器設定。
Microsoft 365 Copilot 連接器可讓您將企業營運資料擷取至 Microsoft Graph,以供 Microsoft 365 Copilot 使用。 擷取您的資料時,Copilot 可以推理資料,並使用它來回應使用者提示。
本逐步解說會建立同步處理的 Copilot 連接器,其能以 Microsoft 365 Copilot 外掛程式的元件形式提供外部資料存取。 它不會建立或封裝完整的外掛程式。
Microsoft 365 代理程式工具組包含可用來建置 Copilot 連接器的範本。 Copilot 連接器範本的設計目的是要協助您使用 Microsoft Graph 中的 Copilot 連接器 API 快速建立連接器。 該範本會搭建一個連接器,將資料從 GitHub API 提取到 Microsoft Graph。 建置連接器之後,您可以透過 F5 體驗在本機執行它,或透過 Azure Functions 部署它。
本文提供使用 Visual Studio Code 中的 Microsoft 365 代理程式工具組建置第一個 Copilot 連接器的步驟逐步解說。
開始之前,請確認您的元件計劃將同步處理的連接器識別為適當的模型,且 Microsoft 365 Agents Toolkit 支援您的目標體驗。 如需規劃指導方針,請參閱 將連接器做為外掛程式功能。
注意
本逐步解說將建立同步處理的連接器。 它不會建置同盟連接器、MCP 外掛程式、MCP 伺服器或代理程式連接器。
您建立的內容
在本逐步解說中,Agents Toolkit 會建立可擷取 GitHub 問題的同步連接器實作。 當您執行專案時,工具組會佈建 Microsoft Entra 應用程式、在 Microsoft Graph 中建立外部連線和結構描述,以及從已設定的 GitHub 存放庫擷取外部項目。
連接器是解決方案的其中一個元件。 請分別完成任何其他外掛程式元件,然後一起整合和測試元件。
先決條件
若要完成本文中的步驟,需要具備下列必要條件:
Node.js,支援的版本:18、20、22
已啟用上傳自訂應用程式的 Microsoft 365 Copilot 授權或 Microsoft 365 開發人員租用戶。
注意
若要在 Microsoft 365 Copilot Chat 中測試您的連接器,您需要 Microsoft 365 Copilot 授權。
您必須能夠在 Microsoft Entra 系統管理中心進行系統管理同意。 您必須是或完成此步驟的全域管理員。 請參閱 授與全租用戶系統管理員同意 給所需角色的應用程式。
您的使用者必須具有搜尋系統管理員、雲端應用程式開發人員的角色,才能在 Microsoft 365 系統管理中心查看連接器。
建立您的第一個自訂連接器
使用下列步驟建立您的第一個連接器。
在 Visual Studio Code 的提要欄位中,選擇 [Microsoft 365 代理程式工具組>] 建立新的代理程式/應用程式。
選取 Copilot 連接器。
輸入
Github Issues作為連接器名稱。為連接器建立全租用戶唯一識別碼。 如需連接器識別碼需求的詳細資訊,請參閱 externalConnection 資源的 id 屬性。
選取 [預設資料夾] ,將專案根資料夾儲存在預設位置。
使用檔案中的
.env.local欄位,CONNECTOR_REPOS設定要從中提取問題的存放庫。
按 F5 以在本機執行連接器。 工具組會為您的連接器建立 Microsoft Entra 應用程式,並開始佈建程序。
遵循終端機中的連結前往 Microsoft Entra 系統管理中心,然後選取 [授與系統管理員同意]。
注意
若要完成此步驟,您必須是貴組織中的全域管理員。
應用程式會建立連線、註冊結構描述,然後執行完整編目以擷取項目。
注意
註冊結構描述可能需要最多 10 分鐘。
完整編目完成後,在 Microsoft 365 系統管理中心:
在左窗格中,移至 [設定>] [搜尋] & [情報>資料來源]。
尋找您的連線識別碼。
選擇 [包含連接器結果]。
注意
若要完成此步驟,您必須是搜尋管理員。此步驟可讓連接器的結果可供 Microsoft 365 Copilot Chat 使用。 如果您只打算使用此連接器做 為宣告式代理程式的知識來源,則不需要此步驟。
秘訣
如果您需要以程式設計方式而不是在系統管理中心中查找連線識別碼,您可以使用範圍在
ExternalConnection.Read.AllGraph 總管中查詢現有的連接器。若要確認項目已編製索引,請選擇相關的連接器名稱。 檢查 [項目編製索引] 欄位以查看已編製索引的問題數。
開啟 Microsoft 365 Copilot Chat 並測試範例提示,例如「最新的兩個 GitHub 問題為何?」。 請注意頁面底部的外部項目引文。 這些引文是來自 Copilot 連接器的資料。
此測試確認連接器可獨立運作。 它不會驗證完整的外掛程式套件,也不會確認連接器可與其他外掛程式元件一起使用。
自訂資料來源的範本
若要自訂自訂資料的範本,您可以更新下列資料夾的內容:
src/custom:包含收集和轉換要擷取至 Microsoft Graph 之資料的自訂程式碼。 雖然此範例使用 GitHub 問題 API,但您可以使用任何其他 API 取代它。src/references:包含連接器的結構描述定義。 加以調整以符合您想要擷取的資料和中繼資料。src/models:包含資料和組態的內部表示法的模型定義。 兩種型號都可以根據您的需求進行客製化。
除了這些資料夾之外,您還可以根據案例自訂程式碼的其他部分。 您可以在程式碼中搜尋以字串開頭 [Customization point] 的註解。 這些註解指出了可能自訂的區域。
後續步驟
使用 連接器整合檢查 來驗證驗證、結構描述、索引、新鮮度和許可權。 包括驗證過期、拒絕存取以及無法使用的連線或資料來源的 失敗和邊界測試 。
在實作記錄中記錄連線 ID、架構、環境、權限、測試證據和連接器擁有者。 如果您的外掛程式包含其他元件,請在 整合和測試外掛程式元件之前建置這些元件。