MCP 和 API 外掛程式是自訂動作,可讓 Microsoft 365 Copilot 中的宣告式代理程式與模型內容通訊協定 (MCP) 伺服器或具有 OpenAPI 描述的 REST API 互動。 藉由使用其中一個外掛程式,使用者可以要求宣告式代理程式查詢 MCP 伺服器或 REST API 以取得資訊,並在支援時,透過自然語言提示建立、更新和刪除資料和物件。
本文針對宣告式代理程式所使用的技術 MCP 或 API 自訂動作使用 外掛程式 。 關於客戶面向的外掛程式產品、套件、登錄和生命週期,請參閱 Microsoft 365 Copilot 的外掛程式。
在 建置或重複使用期間,請使用本文來選擇 MCP 或 API 動作,並瞭解協調器如何叫用它。 您完成技術行動模型和實作它的產品程序。 產生的動作是代理的相依性,而不是單獨的公開分發承諾。
重要
MCP 和 API 外掛程式可在 宣告式代理程式內提供動作。 它們不是獨立的可安裝外掛程式套件:只有包含的代理程式才能存取其功能和工具。 如需套件與動作資訊清單關係的相關資訊,請參閱 外掛程式和宣告式代理程式動作。
API 或 MCP 外掛程式會使用 Copilot 讀取的外掛程式資訊清單,以了解代理程式可用的 API 或 MCP 伺服器。 接著,Copilot 可以決定代理程式何時應該使用該整合來回答提示。 若要深入了解此資訊清單,請參閱 API 和 MCP 外掛程式資訊清單架構。 可安裝套件使用單獨的 Microsoft 365 應用程式資訊清單。
Copilot 如何探索 MCP 伺服器工具
如果是以 MCP 伺服器為基礎的外掛程式,Copilot 預設會在執行階段直接從 MCP 伺服器動態解析外掛程式的工具。 動態工具探索意味著您可以獲得 MCP 伺服器公開的最新工具,而無需等待代理程式重新封裝和重新發佈。 建置代理程式時,開發人員可以選擇在外掛程式資訊清單中改為釘選一組固定的工具。 REST API 外掛程式一律使用外掛程式資訊清單中定義的工具。 如需詳細資訊,請參閱從適用於 Microsoft 365 Copilot 的 MCP 伺服器建置外掛程式 和在 Microsoft 365 Copilot 中探索 MCP 外掛程式的動態工具探索。
此預設值適用於用作宣告式代理程式動作的 MCP 外掛程式。 針對透過 Microsoft 365 應用程式資訊清單中參考遠端 MCP 伺服器 agentConnectors 的外掛程式,動態工具探索需要應用程式資訊清單版本 1.29 或更新版本, 以及 允許它的主機。 如需詳細資訊,請參閱為 Microsoft 365 Copilot 外掛程式設定遠端 MCP 伺服器。
外掛程式範例
考慮一個預算 MCP 伺服器,它允許查詢和建立預算、收取費用或向現有預算添加資金。 提示「Contoso 差旅預算還剩多少」可能會觸發預算外掛程式,並叫用 get-budgets 工具。
POST /mcp
Content-Type: application/json
{
"method": "tools/call",
"params": {
"name": "get-budgets",
"arguments": {
"budgetName": "contoso travel"
}
}
}
Copilot 會使用工具結果中的回應來產生其回應:「Contoso 差旅預算目前有 5,000 美元的可用資金。 如果您需要將資金分配到特定類別或追蹤費用,我也可以為您提供協助。 請告訴我我能提供哪些幫助!
提示「為 Megan 的機票向 Contoso 旅遊預算收費 500 美元」可翻譯成下列 MCP 工具呼叫。
POST /mcp
Content-Type: application/json
{
"method": "tools/call",
"params": {
"name": "charge-budget",
"arguments": {
"budgetName": "contoso travel",
"amount": 500,
"description": "Megan's airline ticket"
}
}
}
Copilot 會使用傳回的資訊來回應使用者:「已成功處理 Megan 機票的 $500 費用。 Contoso 差旅預算目前有 $4,500 美元的可用資金。 如果您需要進行更多交易或需要預算方面的進一步幫助,請告訴我!
外掛程式的運作方式
使用者詢問專員「Fourth Coffee 大廳裝修預算還剩多少?」
對於使用 動態工具探索的 MCP 外掛程式,代理程式會在執行階段從外掛程式的 MCP 伺服器擷取目前的工具定義,並在使用任何新的或變更的工具之前驗證它們。 對於具有釘選工具集的外掛程式或 REST API 外掛程式,代理程式會改用外掛程式資訊清單中定義的工具。
代理程式會從其可用外掛程式中識別與預算相關的外掛程式,該外掛程式具有 MCP 伺服器工具或 API
GetBudget來取得預算詳細資料。 它會將使用者問題的部分內容對應至函數的參數:budgetName=""。代理程式 會要求使用者 允許將其傳送
Fourth Coffee lobby renovation至外掛程式。使用者選擇允許與外掛程式共用資料一次,或選擇一律允許共用此功能的資料。
如果外掛程式的 MCP 伺服器或 API 需要 驗證,外掛程式會向權杖存放區要求權杖或 API 金鑰。
權杖存放區會傳回權杖或金鑰。 如有需要,權杖存放區會讓代理程式提示使用者登入。
代理程式會傳送要求至外掛程式的 MCP 伺服器或 API,其裝載在 Microsoft 365 之外。
MCP 伺服器或 API 會傳回回應。
{ "name": "Fourth Coffee lobby renovation", "availableFunds": 5000.00 }代理程式會根據 MCP 伺服器或 API 回應產生回應。
代理人發送回复:“Fourth Coffee 大廳裝修預算中剩餘的可用資金為 5,000 美元。
確認動作
Copilot 會在使用者第一次傳送任何資料至外掛程式之前詢問使用者。
使用者確認連線後,僅擷取資料的 MCP 伺服器工具和 API 不需要確認,而修改資料的工具和 API 則需要確認。 外掛程式開發人員可以覆寫這些預設值。 如需詳細資料,請參閱 Microsoft 365 Copilot 的 MCP 和 API 外掛程式的確認提示。
自訂回應簡報
Copilot 會使用 MCP 伺服器或 API 回應中的資料來產生交談式回應。 外掛程式可以自訂此資料的呈現方式,其機制取決於外掛程式類型。
MCP 外掛程式 可以使用 MCP 應用程式 來提供豐富的互動式回應 - MCP 伺服器在執行階段與工具結果一起傳回的 UI 小工具。 因為小工具是隨工具回應一起提供,而不是在資訊清單中定義,所以無論外掛程式使用固定的工具集還是 動態工具探索,MCP 應用程式都可以運作。
API 外掛程式 可以在外掛程式資訊清單中提供 調適型卡片 範本,以結構化方式顯示資料。 由於範本是針對資訊清單中宣告的作業定義的,因此此方法適用於 API 外掛程式,以及使用一組釘選工具的 MCP 外掛程式。
對於任何外掛程式類型的來源連結引文,Copilot 會使用回應語意,並可以從工具或 API 回應自動推斷引文中繼資料。 自動推斷對於使用動態工具探索的 MCP 外掛程式特別有用,其中工具在執行階段解析,而且沒有要設定的資訊清單工具定義。 如需詳細資訊,請參閱 顯示具有回應語意的引文。
動作回應中的 URL 處理
Microsoft 365 Copilot 聊天體驗可能會將作為動作回應的一部分傳回的 URL(無論是來自 MCP 外掛程式、API 外掛程式、連接器還是流程)轉譯為可點選的連結。 Copilot 執行階段會控制此行為,並且不會針對外掛程式宣告的任何網域進行評估 (,例如 servers API 外掛程式的 OpenAPI 描述) 區段。
平台安全性、信任和原則規則會管理動作回應的 URL 轉譯行為,且可能會隨著時間而變更。 不要依賴生產關鍵案例的動作回應中的可點選 URL。
協助 Copilot 協調器選擇代理程式的動作
準確描述 API 或 MCP 整合、其功能或工具及其輸入,以便協調器可以針對使用者的要求選取正確的動作。 這些描述與代理的操作有關,而不是外部插件套件的名稱或商店描述。
| 動作整合 | 在何處描述 | 深入了解 |
|---|---|---|
| API 外掛程式 | 外掛程式資訊清單和 OpenAPI 作業與參數描述 | 建立有效的 OpenAPI 描述 |
| MCP 外掛程式 | 外掛程式資訊清單和 MCP 工具描述;工具定義在執行階段來自伺服器,或釘選在資訊清單中 | 動態工具探索和釘選工具 |
函數和 MCP 工具與技能中描述 為外掛程式功能的可重複使用指令檔案不同。
使用 API 或 MCP 動作建置宣告式代理程式
對於專業發展,請從 Work IQ 開發工具開始。 先選擇已記錄的環境,然後在需要專案產生或整合功能時,在下列清單中新增工具:
-
Work IQ Dev Tools 是推薦工具。 用
wiqd agent add action來將支援的 OpenAPI 或遠端 MCP 動作新增至宣告式代理程式專案。 - 現有的工具組型逐步解說仍適用於 MCP 伺服器、 OpenAPI 描述或 新的 REST API。 使用 Toolkit 專案時,請遵循這些程序。
- Kiota 可以從現有的 OpenAPI 描述產生 API 外掛程式資訊清單。
API 或 MCP 外掛程式資訊清單會設定代理程式的動作整合。 透過其支援的應用程式套件路由封裝和分發包含代理;動作資訊清單不是可獨立安裝的外掛程式套件。
秘訣
Work IQ 開發工具 正式推出。
wiqd agent add action 將動作新增到宣告式代理程式專案,並 wiqd agent validate --mode source 對儲存的代理程式來源執行離線檢查。 通過的來源檢查不會建立執行階段或 OpenAPI 端點可連線性、驗證正確性或最終封裝接受。 如果您省略 --mode,驗證預設為 package,會上傳現有 ZIP 的複本,且可能需要登入。 有關驗證模式和涵蓋範圍,請參閱 WIQD 命令參考 和 驗證和 MVL。
限制
這些限制涉及用作宣告式代理程式動作的 API 和 MCP 外掛程式,而不是可安裝外掛程式套件中的技能、代理程式或連接器數目。
當宣告式代理程式包含宣 告式代理程式資訊清單中定義的最多五個外掛程式時,代理程式一律會將外掛程式插入提示中。 當代理包含五個以上的外掛程式時,它會使用語意比對。 語義匹配是基於插件的描述,而不是基於插件本身內的任何單獨功能或工具。
外掛程式可以包含無限數量的函數或 MCP 工具。 所有匹配的插件的功能或工具都會被返回,即使只有一個匹配。 對於使用 動態工具探索的 MCP 外掛程式,在執行階段從 MCP 伺服器解析的工具會計入此總數。 由於權杖視窗限制,如果包含超過 10 個函數或工具,回應品質可能會降低。
用於輸入和外掛程式輸出的權杖視窗會截斷大型內容。 功能限制可能會隨著模型的改進而變更,並取決於任何系統額外負荷。 針對較小的 token 長度進行最佳化,或選擇可擴展性選項,以便在必要時允許串流大型內容。
後續步驟
實作選取的 MCP 動作 或 API 動作。 元件個別運作之後,請輸入 封 裝 & 使用 [整合] 測試 並測試您的元件。