從 MCP 伺服器建置宣告式代理程式的外掛程式

秘訣

推薦項目: 從 Work IQ 開發工具 開始,支援專業程式碼宣告式代理程式和外掛程式案例。 請參閱 WIQD 快速入門。 工具組式指示仍然適用於需要工具組的指示的現有專案和工作流程。 在選擇工具之前,請先檢查 功能和目標體驗支援 : WIQD 不會以自訂引擎代理程式為目標。

本指南說明如何使用 Microsoft 365 代理程式工具組新增將代理程式連線至伺服器的 MCP 外掛程式,以將您的服務與 Microsoft 365 Copilot 的宣告式代理程式整合。 遵循這些步驟,您可以為商務使用者啟用對 MCP 公開服務的交談式 AI 支援存取。

本逐步解說使用 MCP 外掛程式建立宣告式代理程式。 外掛程式資訊清單會將代理程式連線至遠端 MCP 伺服器;它不會封裝或裝載執行中的伺服器。

本逐步解說涵蓋宣告式代理程式動作路線。 若要改為在外掛程式套件層級連線伺服器,請參閱 在應用程式資訊清單中設定遠端 MCP 伺服器。 如需兩個資訊清單模型的關聯性,請參閱 外掛程式和宣告式代理程式動作。 使用目標體驗支援的路線。

本逐步解說使用 GitHub MCP 伺服器 做為範例。 GitHub MCP 伺服器是由 GitHub 提供和維護的遠端 MCP 伺服器,公開使用存放庫、問題、提取要求和其他 GitHub 功能的工具。 您在這裡使用它來建置一個代理程式,可以從自然語言提示搜尋 GitHub 存放庫和使用者。 您可以使用自己的 MCP 伺服器執行相同的步驟。

以四個步驟建置和測試功能:建立 OAuth 用戶端以進行驗證、建立代理程式、佈建和側載以供開發,以及使用代理程式。

先決條件

開始之前,請確定您具備下列先決條件:

若要完成本逐步解說中的 GitHub 範例,您也需要 GitHub 帳戶。 從您自己的 MCP 伺服器建置外掛程式不需要 GitHub 帳戶。

步驟 1:建立 OAuth 用戶端以進行驗證

GitHub MCP 伺服器需要每個使用者先登入才能傳回資料,因此外掛程式需要 OAuth 用戶端。 在本指南中,使用 OAuth (與靜態註冊) 。 當您建立代理程式並選取此驗證類型時,Agents Toolkit 會立即提示您輸入這些值,因此請先建立用戶端。 然後,每次代理程式呼叫 MCP 伺服器時,Copilot 會使用註冊代表登入使用者取得存取權杖。

秘訣

如果您的 MCP 伺服器支援 OAuth 2.0 動態用戶端註冊 (DCR) ,則可以略過本節。 當您建立代理程式時,請選取具有 動態註冊) 作為驗證類型的 OAuth ( 。 MCP 伺服器會在執行階段登錄用戶端,因此不需要用戶端識別碼或密碼。 Agents Toolkit 會為您將註冊寫入外掛程式資訊清單。

若要建立 OAuth 用戶端:

  1. 在瀏覽器中移至 https://github.com/settings/developers 。 選取 [新增 OAuth 應用程式>]。

  2. 為您的應用程式新增名稱和首頁 URL,並設定為https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect授權回呼 URL。 選取 [註冊應用程式]。

  3. 應用程式建立之後,選取 [產生新的用戶端密碼]。 複製密碼和 用戶端 ID 以在建立代理程式時輸入。

注意

這些步驟是 GitHub 特有的步驟。 對於您自己的 MCP 伺服器,請使用伺服器使用的身分識別提供者建立 OAuth 用戶端,並設定 https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect 為重新導向 (回呼) URL。 當您建立代理程式並選取具有 靜態註冊) 的 OAuth (時,Agents Toolkit 會提示您輸入用戶端識別碼、用戶端密碼和選用範圍。 如果您的 MCP 伺服器支援動態用戶端註冊 (DCR) ,您可以改為選取 具有動態註冊) 的 OAuth (,MCP 伺服器會在執行階段註冊用戶端 - 不需要手動建立用戶端、用戶端識別碼或密碼。 如果您的 MCP 伺服器使用單一登入 (SSO) 而不是 OAuth Microsoft Entra選取Entra SSO,Agents Toolkit 會提示您輸入Microsoft Entra應用程式用戶端識別碼。 在每種情況下,Agents Toolkit 都會為您更新外掛程式資訊清單。 如需每個選項的詳細資訊,請參閱 在代理程式中設定 MCP 和 API 外掛程式的驗證。

步驟 2:建立代理程式

若要建立代理程式:

  1. 開啟 Visual Studio Code,然後選取活動列中的 Microsoft 365 代理程式工具組圖示。

  2. 在 [代理程式工具組] 工作窗格中選取 [建立新的代理程式/應用程式 ]。

    Agents Toolkit 介面的螢幕擷取畫面

  3. 選取 宣告式代理程式。

  4. 選取 [新增動作],然後選取 [使用 MCP 伺服器開始]。

  5. 輸入 GitHub MCP 伺服器 URL https://api.githubcopilot.com/mcp/。

    輸入 MCP 伺服器 URL 的提示螢幕擷取畫面

  6. 選取驗證類型。 在本練習中,請選取具有 靜態註冊) 的 OAuth (。

    選取驗證類型提示的螢幕擷取畫面,顯示 OAuth 靜態、OAuth 動態、Entra SSO 和 None 選項

  7. 當系統提示時,請從您註冊的 OAuth 應用程式輸入 用戶端識別碼 ,然後輸入 用戶端密碼。

  8. 當系統提示輸入範圍時,請按 Enter 繼續。

  9. 為代理專案選擇一個位置。

  10. 輸入代理程式的名稱。

完成這些步驟之後,Agents Toolkit 會產生代理程式所需的檔案,並開啟載入代理程式專案的新 Visual Studio Code 視窗。

Agents Toolkit 會設定產生的外掛程式資訊清單 (ai-plugin.json 動態 工具探索的) ,因此代理程式會在執行階段解析 MCP 伺服器的工具,包括任何傳回 UI 小工具 (MCP 應用程式) 的工具,而您不需要手動新增工具。 若要改為釘選一組固定的精選工具,請參閱 使用 Agents Toolkit 設定釘選的工具。

步驟 3:佈建和側載用於開發的代理程式

若要在開發租用戶中佈建和側載代理程式:

  1. 在 [代理程式工具組 帳戶] 窗格中,選取 [ 登入至 Microsoft 365]。 (如果您已經登入,請繼續進行下一個步驟) 。

  2. 確認 [ 已啟用自訂應用程式上傳] 和 [已啟用 Copilot 存取 ] 都顯示在您的 Microsoft 365 帳戶下。 如果沒有,請洽詢貴組織的系統管理員。如需詳細資訊,請參閱 Copilot 擴充性選項的需求 。

  3. 在 [ 生命週期 ] 窗格中,選取 [佈建]。

  4. 閱讀對話方塊中的訊息,然後選取 [ 確認] 以繼續。

  5. 等候工具組報告已完成佈建。

注意

Work IQ 開發工具 — 對於宣告式代理程式專案,請 wiqd agent add action --mcp-server-url <https-endpoint> 使用伺服器所需的驗證選項。 用於 wiqd agent validate --mode source 離線來源檢查。 在需要時佈建選取的環境以解析套件身分識別,然後以相同的--env值執行wiqd agent package。 separate wiqd plugin add connector 命令將遠端連接器新增到獨立的外掛程式專案,而不是對宣告式代理程式專案的操作。 如需目前的選項,請參閱 WIQD 命令參考。

步驟 4: 使用代理程式

若要使用代理程式:

  1. 在瀏覽器中,移至 https://m365.cloud.microsoft/chat。

  2. 在提要欄位的 「代理程式 」區段中,找到您的代理程式。 它會列為您 在步驟 2:建立代理程式中提供的名稱,並在 dev 結尾附加。 選取代理程式。

  3. 要求代理程式尋找存放庫或使用者。 例如, can you find a repo for kiota?.

  4. 當系統提示時,選取 [登入 {agent-name}]。 在彈出視窗中,使用您的 GitHub 帳戶登入並授權代理程式。

  5. 當快顯視窗關閉時,代理程式會傳回回應。

    代理程式回應存放庫查詢的螢幕擷取畫面

  6. 如果代理呼叫的工具傳回 UI 小工具 (MCP 應用程式) ,請確認代理程式在回應中內嵌呈現小工具。 如需詳細資訊,請參閱將 MCP 應用程式新增至 Microsoft 365 Copilot 中的宣告式代理程式。

後續步驟

測試代理程式及其 MCP 動作之後,如果您要在外掛程式套件中包含代理程式,請按照 封裝外掛程式進行 。