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 插件始终使用插件清单中定义的工具。 有关详细信息,请参阅从 MCP 服务器构建插件以进行智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®和在 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 中为 MCP 插件动态工具发现。
此默认值适用于用作声明性代理操作的 MCP 插件。 对于通过 agentConnectors Microsoft 365 应用清单中引用远程 MCP 服务器的插件,动态工具发现需要应用清单版本 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 插件清单配置代理的操作集成。 通过其支持的 app-package 路由打包和分发包含的代理;操作清单不是一个可独立安装的插件包。
提示
Work IQ 开发工具 现已正式发布。
wiqd agent add action 将操作添加到声明式代理项目,并 wiqd agent validate --mode source 对保存的代理源运行脱机检查。 通过的源检查不会建立运行时或 OpenAPI 终结点的可访问性、身份验证的正确性或最终包接受度。 如果省 --mode略 ,验证默认为 package,这将上传现有 ZIP 的副本,并且可能需要登录。 有关验证模式和覆盖范围,请参阅 WIQD 命令参考 和 验证和 MVL。
限制
这些限制涉及用作声明式代理操作的 API 和 MCP 插件,而不是可安装插件包中的技能、代理或连接器数量。
当声明性代理包含声明 式代理清单中定义的最多五个插件时,代理始终将插件注入提示中。 当代理包含 5 个以上插件时,它使用语义匹配。 语义匹配基于插件的描述,而不是插件本身中的任何单个功能或工具。
插件可以包含无限数量的函数或 MCP 工具。 返回所有匹配的插件的功能或工具,即使只有一个匹配。 对于使用 动态工具发现的 MCP 插件,在运行时从 MCP 服务器解析的工具将计入此总计。 由于令牌窗口限制,如果包含超过 10 个函数或工具,响应的质量可能会降低。
插件输入和输出的令牌窗口会截断较大的内容。 功能限制可能会随着模型的改进而变化,并取决于任何系统开销。 针对较小的令牌长度进行优化,或根据需要选择允许流式传输大型内容的可扩展性选项。
后续步骤
实现选定的 MCP 操作 或 API 操作。 组件单独工作后,进入 Package & test with Integrate 并测试您的组件。
相关内容
- 从 MCP 服务器生成适用于智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 的插件
- 将 MCP 应用添加到智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 中的声明性代理
- 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 中 MCP 插件的动态工具发现
- 基于现有 API 生成 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® API 插件
- 使用适用于智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®的新 API 生成 API 插件
- 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 的 API 和 MCP 插件清单架构
- 使用 API 插件编写声明式代理的有效说明