提示
受到推崇的: 从 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 进行身份验证所需的凭据或客户端详细信息。 匿名访问不需要身份验证配置。为项目选择支持的配置路径:
-
建议使用 Work IQ Dev Tools () 在添加 OpenAPI 或远程 MCP 操作时
wiqd agent add action配置身份验证。 若要在现有插件清单中配置受支持的身份验证类型,请使用wiqd agent add auth. 请按照下面特定于方案的 WIQD 指南获取正确的选项,然后为你的环境完成代理的预配工作流。 - Microsoft 365 Agents Toolkit 会创建身份验证配置,并在生成代理时自动更新插件清单。
- 声明式代理开发人员技能仅 (MCP 插件) 根据自然语言说明创建身份验证配置并更新清单。
- Microsoft Teams 开发人员门户 允许您手动创建身份验证配置,或管理 Agents Toolkit 或技能创建的身份验证配置。
对于经过身份验证的方案,插件清单通过 其在运行时身份验证对象中的 ID 引用身份验证配置。 在运行时,智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 使用身份验证配置从令牌存储获取令牌或 API 密钥,并在插件调用 MCP 服务器或 API 时包含它。
从所选身份验证方案的 WIQD 部分开始。 相同的文章保留工具包、开发人员技能、门户和手动替代方案(如果支持)。
- 使用 WIQD 配置 Microsoft Entra SSO 身份验证
- 使用 WIQD 配置动态客户端注册
- 使用 WIQD 配置 OAuth 2.0 身份验证
- 使用 WIQD 配置 API 密钥身份验证
- 使用 WIQD 配置匿名身份验证
注意
对于将 Cowork 连接到远程 MCP 服务器的插件包,请按照应用清单中的身份验证进行操作。 共享凭据注册步骤不会使该配置可与代理的 MCP 插件清单配置互换。 如果 OAuth 提供程序使用 Microsoft 标识平台,并且连接需要自动令牌刷新,请在 OAuth 配置的“范围”字段中包含offline_access任何特定于 API 的委派范围。