設定代理程式中 MCP 和 API 外掛程式的驗證

秘訣

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

Microsoft 365 Copilot 中的宣告式代理程式會透過 API 或 MCP 外掛程式連線到後端服務。 這些動作整合會將代理程式連線至模型內容通訊協定 (MCP) 伺服器或 OpenAPI 文件所描述的 API。 設定驗證,讓 Microsoft 365 Copilot 可以代表登入的使用者取得並傳送正確的認證。

注意

本文在宣告式代理程式的 API 或 MCP 外掛程式資訊清單中設定驗證。 它不會設定外部可安裝套件。 請參閱資訊清單關聯性的 外掛程式和宣告式代理程式動作 。

驗證逐步解說使用 MCP 外掛程式做為預設範例。 MCP 外掛程式是代理與遠端伺服器的整合,而不是伺服器本身。 相同的設定步驟也適用於從 OpenAPI 文件建置的 API 外掛程式,除非每篇文章中有說明。

支援的驗證配置

選擇符合 MCP 伺服器或 API 保護端點方式的驗證配置:

驗證配置 MCP 外掛程式 API 外掛程式 文章
Microsoft Entra單一登入 (SSO) 支援 支援 設定 Microsoft Entra SSO 驗證
動態用戶端註冊 (DCR) 支援 不支援 設定動態用戶端註冊
OAuth 2.0 授權碼流程 支援 支援 設定 OAuth 2.0 驗證
API 金鑰 不支援 支援 設定 API 金鑰驗證
無驗證 (匿名) 支援 支援 匿名) (設定無驗證

注意

下表涵蓋做為宣告式代理程式動作的 MCP 和 API 外掛程式。 透過 agentConnectors 在 Microsoft 365 應用程式資訊清單中參考遠端 MCP 伺服器的外掛程式使用不同的授權設定。 該結構描述包括 ApiKeyPluginVault,而用作宣告式代理程式動作的 MCP 外掛程式不支援 API 金鑰。 如需設定和主機需求,請參閱為 Microsoft 365 Copilot 外掛程式設定遠端 MCP 伺服器。

外掛程式驗證的運作方式

對於需要認證的配置, 驗證設定 (驗證設定) 是儲存在 Microsoft Enterprise 權杖存放區中的記錄,其中包含向 MCP 伺服器或 API 驗證所需的認證或用戶端詳細資料。 匿名存取不需要驗證設定。選擇專案支援的設定路徑:

  • 工作 IQ 開發工具 (建議使用) 當您使用 wiqd agent add action新增 OpenAPI 或遠端 MCP 動作時,會設定驗證。 若要在現有的外掛程式資訊清單中設定支援的驗證類型,請使用 wiqd agent add auth。 請遵循下列配置特定的 WIQD 指引以取得正確的選項,然後為您的環境完成代理的佈建工作流程。
  • Microsoft 365 Agents Toolkit 會在您建置代理程式時,自動建立驗證設定並更新您的外掛程式資訊清單。
  • 宣告式代理程式開發人員技能僅 (MCP 外掛程式) 建立驗證設定,並從自然語言指示為您更新資訊清單。
  • Microsoft Teams 開發人員入口網站可讓您 手動建立驗證設定,或管理代理程式工具組或技能建立的驗證設定。

對於已驗證的配置,您的外掛程式資訊清單會依 其在執行階段驗證物件中的識別碼參考驗證組態。 在執行階段,Microsoft 365 Copilot 會使用驗證設定從權杖存放區取得權杖或 API 金鑰,並在外掛程式呼叫您的 MCP 伺服器或 API 時將其包含在內。

從所選驗證配置的 WIQD 區段開始。 相同的文章在支援的情況下保留工具組、開發人員技能、入口網站和手動替代方案。

注意

如需將 Cowork 連線至遠端 MCP 伺服器的外掛程式套件,請遵循應用程式資訊清單中的驗證。 共用認證註冊步驟不會使該設定可與代理程式的 MCP 外掛程式資訊清單設定交換。 如果您的 OAuth 提供者使用 Microsoft 身分識別平台,且連線需要自動重新整理權杖,請在 OAuth 設定的 [範圍] 欄位中包含offline_access任何 API 特定的委派範圍。