智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 业务流程协调程序协调语言模型、可用上下文及其用于响应用户请求的功能。 对于声明性代理,这些功能可以包括知识检索、内置功能以及 MCP 或 API 插件提供的操作。
本文重点介绍代理的配置如何影响操作选择和调用。 您提供说明、工具定义和外部服务;Microsoft 管理对话运行时。 有关更广泛的职责划分,请参阅 声明式代理体系结构。
Copilot orchestrator
业务流程协调程序使用代理的配置和可用上下文来确定是直接响应、检索知识还是调用工具。 并非每个请求都需要外部操作。
例如,用户可能会问:“现在分配给我哪些票证?具有适当票务操作的代理可以从票务服务中检索当前信息,而不是依赖模型知识。
下图说明了 API 操作交互。 它只是一个概念视图,而不是固定的执行顺序,也不是每个请求都使用 Microsoft Graph 或外部 API 的保证。
- 解释请求。 Copilot 使用提示、代理说明、对话历史记录和可用应用上下文来识别用户的任务。 平台安全和策略检查可能会影响请求是否以及如何继续进行。
- 选择相关功能。 Copilot 确定配置的知识或工具是否可以提供帮助。 对于外部操作,插件和工具说明有助于确定适当的操作。
- 确定输入并调用工具。 Copilot 将可用信息映射到工具的参数。 说明应指导它要求缺少的必需信息,而不是发明值。 外部调用使用配置的 身份验证 和 确认行为。
- 解释结果。 Copilot 使用返回的数据或错误来确定下一步。 交互可以包括另一次呼叫、澄清请求或对用户的响应。
- 回复用户。 Copilot 使用可用的上下文和结果生成响应。 响应应反映服务实际返回或更改的内容。
声明性代理支持 链接函数调用,包括将一个 API 调用的输出传递到另一个,以及将 API 操作与 SharePoint 知识或代码解释器相结合。 设计和测试所需的交互,而不是假设固定数量的调用总是在一轮中完成。 遵循当前 插件限制 和外部服务的限制。
平台保护和用户确认不能取代外部服务中的授权或业务规则检查。 如果工作流需要精确的执行顺序、事务或恢复,请在服务中实现这些要求,而不是依赖模型指令。
Copilot 的业务流程协调程序如何将操作与用户查询匹配
插件选择和单独工具调用是不同的决策。 插件的说明可帮助 Copilot 识别相关服务或域。 然后,该插件提供的工具将描述 Copilot 可调用的操作及其所需的输入。
当插件选择使用语义匹配时,匹配基于插件的描述,而不是单个函数的描述。 匹配的插件使其功能或工具可用;它不是一个由五个函数组成的固定候选名单。 有关当前选择行为和上下文约束,请参阅 MCP 和 API 插件限制。
在每个级别提供有用的说明:
| 配置 | 要描述的内容 |
|---|---|
| 插件说明 | 服务的用途、支持的用户任务和域。 使描述足够具体,以便将其与其他插件区分开来。 |
| 功能或工具定义 | 操作的目的、何时使用它以及它是检索还是更改数据。 对于 API 插件,请将函数名称映射到 OpenAPI operationId。 |
| 参数 | 必需的输入、类型、格式和有意义的示例。 将标识符与显示名称区分开来,并明确可选行为。 |
| 结果和错误 | 返回的数据、成功操作的含义以及如何表示失败。 使有效负载与任务相关。 |
对于 API 插件,请按照 创建有效的 OpenAPI 说明进行操作。 对于 MCP 插件,请检查工具定义是动态发现还是固定在插件清单中。 通过动态发现,对服务器工具定义的更改可能会在不重新发布代理的情况下影响选择。
改进和评估操作选择
说明和说明会影响选择。 他们不保证为请求的每个表达调用特定工具。
- 阐明重叠操作。 如果多种工具看起来合适,请解释它们的不同用途和所需的输入。 区分读取操作和更改数据的操作。
- 在说明中将任务连接到工具。 说明何时使用配置的工具、如何收集缺失的信息以及如何在后续请求中使用早期结果。 请参阅 使用 API 插件的代理说明。
- 专注于可用工具。 公开代理任务所需的操作。 更多的工具定义和更大的有效负载会消耗上下文并可能降低响应质量。
- 测试实际选择和结果。 包括释义提示、模棱两可的请求、缺少输入、多步骤任务、取消的确认和服务故障。 检查服务收到的操作和参数,而不仅仅是最终的措辞。
- 更改定义时重复测试。 在更改插件说明、工具定义、说明或平台后重新运行代表性案例。 使用动态发现时包括 MCP 服务器更新。
重要
缺少或不完整的对话响应不会确定外部操作是否已完成。 在重试更改数据的操作之前检查服务的结果,并将服务设计为安全地处理重复请求。
有关更广泛的设计建议,请参阅 声明式代理最佳做法。 有关可重复的测试用例和断言,请参阅 代理评估概述。