Microsoft 365 Copilot 中 MCP 外掛程式的動態工具探索

秘訣

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

動態工具探索可讓使用 MCP 伺服器型外掛程式 的宣告式代理程式在執行階段直接從 MCP 伺服器解析其可用工具,而不是僅限於發佈時代理程式外掛程式資訊清單中擷取的工具清單。 此功能允許使用者近乎即時地存取 MCP 伺服器的最新功能,而無需等待代理程式重新封裝、重新驗證和重新發佈。

注意

動態工具探索包含) (MCP 應用程式 傳回互動式 UI 小工具的工具。 代理程式無需額外設定即可呈現這些小工具。

注意

本文涵蓋了用作宣告式代理程式動作的 MCP 外掛程式。 針對透過 Microsoft 365 應用程式資訊清單中參考遠端 MCP 伺服器 agentConnectors 的外掛程式,動態工具探索需要應用程式資訊清單版本 1.29 或更新版本, 以及 允許它的主機。 如需詳細資訊,請參閱為 Microsoft 365 Copilot 外掛程式設定遠端 MCP 伺服器。

動態工具探索與釘選工具有何不同

使用 釘選工具時,代理程式開發人員可以選取 MCP 伺服器公開的工具、在外掛程式資訊清單中宣告它們,並將它們作為代理程式套件的一部分提供。 對工具介面進行任何變更,例如新增新工具、移除已取代的工具、重新命名參數或精簡描述,都需要代理程式開發人員更新資訊清單、重新提交代理程式,並在使用者看到變更之前重新驗證並重新發佈代理程式。

透過 動態工具探索,代理程式不再攜帶固定的工具清單。 平台會在執行階段從 MCP 伺服器擷取目前的工具定義,將它們與上一個已知集進行比較、驗證變更並套用它們,以便代理程式在伺服器功能的最新檢視上進行操作。

下表摘要說明其中的差異。

外觀 釘選的工具 動態工具探索
工具定義的來源 與代理程式一起封裝的外掛程式資訊清單 MCP 伺服器,在執行階段擷取
解析工具定義時 在代理程式發佈時間 在執行階段,每個工作階段
新增或移除工具 需要更新資訊清單、重新提交代理程式,然後重新發佈 一旦 MCP 伺服器公開變更和執行階段驗證通過,就會自動反映
更新工具的結構描述或描述 需要重新發佈代理程式 在執行階段挑選
使用者特定的工具介面 (例如,依 SKU、角色或權利) 不支援。 每個使用者都會看到相同的資訊清單定義工具清單。 支援。 MCP 伺服器可以傳回專為登入使用者量身打造的工具清單。
是時候推出新的工具功能了 幾天到幾週,受代理程式重新發佈週期限制 近乎即時,僅在 MCP 伺服器部署和執行階段驗證上受控
是時候淘汰已淘汰的工具了 幾天到幾週 近乎即時
工具定義的信任和安全檢查 在發佈時間執行商店驗證期間 發佈時間代理程式層級驗證 加上 負責執行階段的 AI (RAI) 和交叉提示注入攻擊 (XPIA) 在啟動之前對其進行驗證

外掛程式資訊清單差異

外掛程式資訊清單透過執行階段的 RemoteMCPServer 設定來表示探索模式。

使用 釘選工具,列出陣列中的 functions 工具和執行階段的 run_for_functions 屬性。 將其定義儲存在執行階段的 mcp_tool_description 屬性中:

{
  "functions": [
    { "name": "search_repositories" },
    { "name": "search_users" }
  ],
  "runtimes": [
    {
      "type": "RemoteMCPServer",
      "spec": {
        "url": "https://api.contoso.com/mcp",
        "mcp_tool_description": {
          "file": "mcp-tools.json"
        }
      },
      "run_for_functions": [
        "search_repositories",
        "search_users"
      ]
    }
  ]
}

使用 動態工具探索時, functions 陣列是空的,且執行階段的內容 run_for_functions 設定為 ["*"],因此代理程式會在執行階段解析伺服器的所有工具:

{
  "functions": [],
  "runtimes": [
    {
      "type": "RemoteMCPServer",
      "spec": {
        "url": "https://api.contoso.com/mcp"
      },
      "run_for_functions": [
        "*"
      ]
    }
  ]
}

如需詳細資訊,請參閱 MCP 伺服器規格物件。

使用 Agents Toolkit 設定釘選的工具

根據預設, Microsoft 365 代理程式工具組 會為動態工具探索設定新的 MCP 外掛程式。 若要改為釘選一組固定的、策劃過的工具 (例如,僅公開伺服器工具的子集,或在發行之間保持工具表面不變) 請選取 Agents Toolkit 中的工具。 然後,工具介面不會變更,除非您更新資訊清單並重新發佈代理程式。

若要釘選一組特定的工具:

  1. 開啟 .vscode/mcp.json 檔案。 選取檔案編輯器中的 [開始 ] 按鈕。

  2. 如果出現驗證提示,請選取 [允許] 以驗證。

  3. 在檔案編輯器中選取 攻擊力:從 MCP 擷取動作 按鈕,然後選取 ai-plugin.json。

    mcp.json 中「攻擊: 從 MCP 擷取動作」和「開始」按鈕的螢幕擷取畫面

  4. 選取代理程式要使用的工具。

    VS Code 中工具選擇介面的螢幕擷取畫面

選取工具之後,Agents Toolkit 會使用釘選的工具 ai-plugin.json 更新,如 外掛程式資訊清單差異中所示。 Agents Toolkit 會將工具定義儲存在執行階段的內容 mcp_tool_description 中,可以內嵌在陣列中 tools ,或作為包含工具定義的參照 file 。 定義符合 MCP 伺服器 tools/list 方法所傳回的格式。

適用於系統管理員的透明度、控管和稽核

當 探索工具時 ,動態工具探索會從發佈時間移至執行階段。 MCP 伺服器開發人員仍撰寫並擁有工具定義。 為了維持系統管理員所依賴的透明度、治理和合規性保證,平台會透過 Microsoft 365 系統管理中心 (MAC) 和 Microsoft Purview 提供控制和稽核訊號。

區分具有動態探索的代理程式與釘選工具

系統管理員可以從 Microsoft 365 系統管理中心的代理程式詳細資料檢視中,識別其租用戶中的哪些代理程式使用動態工具探索。 在代理詳細資料檢視的資料 & 工具 索引標籤中, 工具 區段下的資訊橫幅表示代理使用的工具可以在執行階段變更的 MCP 伺服器。

Microsoft 365 系統管理中心中代理程式詳細資料檢視的 [資料和工具] 索引標籤的螢幕擷取畫面,其中顯示資訊橫幅,指出代理程式的 MCP 伺服器可能會使用發行者變更的其他工具。

代理程式和連接器目錄清單檢視本身保持不變。 探索機制顯示在每個代理程式的詳細資料頁面上,而不是目錄層級清單中。

停用使用動態工具探索的代理程式

動態工具探索功能本身沒有個別的租用戶或代理程式層級切換。 系統管理員改為使用 Microsoft 365 系統管理中心中現有的代理程式層級控制項:

  • 如果系統管理員不希望使用動態工具探索的特定代理程式在其租用戶中可用,他們可以透過目前用於任何宣告式代理程式的相同代理程式管理控制項來停用或封鎖該代理程式。
  • 使用相同的控制項 (包括將代理程式指派給特定使用者或群組) 以在更廣泛的推出之前暫存使用動態工具探索的代理程式的可用性。

這個方法表示動態工具探索不會引進新的原則介面供系統管理員學習。 代理程式啟用、範圍和停用的運作方式相同,不論代理程式是使用釘選工具還是動態工具探索。 代理詳細資料檢視會告訴系統管理員代理使用哪種探索機制,以便他們能夠就是否允許做出明智的決定。

Microsoft Purview 中的稽核記錄

與使用動態工具探索之代理程式的互動,會記錄在工作負載下的 Copilot Microsoft Purview 稽核記錄中,以及與任何其他宣告式代理程式的互動。 系統管理員可以透過在 Purview 稽核搜尋中篩選Workload = Copilot來找出這些記錄,並可以使用 中的CopilotEventData欄位識別TargetAgentName特定代理程式。

如何維持現有的信任和安全保證

動態工具探索不會繞過目前適用於 MCP 外掛程式的信任和安全模型。 它使用執行階段驗證層擴充模型:

  • ISV (3P) 應用程式 繼續依賴現有的擴充性治理堆疊:發行者證明和 M365 認證、租用戶和 ISV 服務合約和使用條款,以及在發佈時執行的商店驗證。
  • 企業營運 (LOB) 應用程式 會繼續仰賴租用戶現有的第一方和內部應用程式內部上線與合規性程序。
  • 執行階段驗證:每個新發現或修改的工具都會由 RAI 和 XPIA 分類器篩選,然後才為使用者啟用工具。 此程序會封鎖未通過驗證的工具變更。

這些程式共同保證了客戶在發佈時所依賴的保證,隨著工具在運行時的發展而繼續有效。