声明式代理体系结构

声明性代理在 智能 Microsoft 365 Copilot 副驾驶® 的托管业务流程和语言模型基础结构上运行。 您可以配置代理的说明、知识源和支持的功能,而不是实现和托管自己的对话运行时。

代理可以使用 Microsoft 365 知识源、代码解释器等内置功能、 自定义技能 (预览) ,以及 MCP 服务器或 REST API 提供的操作。 它还可以将任务委派给 连接的代理。 可用性取决于创作工具、清单版本、目标体验、许可和组织策略。

使用本文了解托管平台与配置或操作的组件之间的界限。 要与可让您控制编排和模型托管的架构进行比较,请参阅 比较声明式和自定义引擎代理。

体系结构组件

智能 Microsoft 365 Copilot 副驾驶® 提供的运行时可解释用户请求、检索相关上下文、选择功能和生成响应。 您的配置和外部服务确定代理可用于完成任务的内容。

声明性代理的体系结构示意图。

组件 托管平台 开发者职责
客户端 在受支持的 Microsoft 365 体验中主持对话。 选择目标体验并测试其支持的交互、文档上下文和响应格式。
基础结构 托管 Copilot 业务流程和模型运行时。 配置代理并托管它使用的任何外部 API、MCP 服务器或其他服务。
目录和分发 提供受支持的采集、发布和管理体验。 选择支持的包和分发路由,维护版本,并与管理员合作进行访问和部署。
安全与合规 应用 Microsoft 365 标识、数据访问和平台保护。 配置权限和身份验证,评估数据流,并在外部服务中强制执行授权和数据保护。
业务流程协调程序和语言模型 选择和调用功能并生成响应。 编写说明和工具说明,配置支持的行为设置,并评估生成的行为。 您不会使用自定义运行时代码替换托管业务流程协调程序。
知识和能力 检索支持的知识并运行启用的内置功能。 选择相关来源和功能,确认用户访问,并测试检索质量。
工具调用 通过支持的集成调用配置的 MCP 或 API 操作。 定义工具输入和输出,配置身份验证和确认,并实施可靠的服务行为。

支持的配置设置会影响托管运行时;它们不允许您完全控制其实现。 例如,清单支持用户可替代的 默认响应模式。 按照所选的清单架构和创作工具获取可用设置。

注意

检索的内容和工具响应可能包含不受信任的指令。 平台保护并不能取代服务中的授权检查或对代理行为的评估。 规划适用 的数据、隐私和安全要求。

声明式代理数据流

以下概念流介绍了代理如何使用其配置和功能。 它不是固定的执行顺序,也不是对发生多少检索或工具调用的保证。

  1. 接收请求。 用户在受支持的体验中提交提示。 对话历史记录和可用的应用上下文可能会影响请求。
  2. 选择相关的上下文和功能。 Copilot 使用代理的说明、知识配置和工具说明来确定如何处理请求。
  3. 检索信息或调用操作。 Copilot 检索可用知识或调用已启用的功能。 外部操作使用配置的身份验证和 确认行为。 外部服务强制实施自己的授权和业务规则。
  4. 生成响应。 Copilot 使用可用的上下文和功能结果进行响应。 根据任务的不同,交互可能包括进一步的呼叫、用户输入请求或委派给连接的代理。

声明性代理可以链接 API 调用,使用一个调用的输出作为另一个调用的输入,并将 SharePoint 知识或代码解释器与 API 操作相结合。 有关支持的模式和示例,请参阅在 API 插件中链接函数调用。

指令指导模型行为;它们不能替代必须强制执行事务、确切执行顺序或恢复过程的应用程序逻辑。 在 API 或工作流服务中实现这些要求,或者在需要拥有业务流程时评估自定义引擎体系结构。

针对特定于功能的限制进行设计

检查指南中针对每种功能和集成的限制。 清单字段的字符限制、知识源配置限制和运行时上下文限制描述了不同的约束。

区域 设计注意事项 指南
代理配置 使用所选架构版本和创作工具支持的属性和功能。 声明性代理清单引用
知识检索 选择相关来源并遵循特定于来源的文件、范围、访问和索引要求。 响应不一定包括源中的每个项目。 知识源 和 优化内容检索
工具定义和有效负载 保持工具专注,让输入和输出保持相关。 大型插件输入和输出可以被截断,有效的上下文限制可以随模型和系统开销而变化。 MCP 和 API 插件限制
文档上下文 遵循主机应用支持的文档交互和内容格式,而不是假定所有文档内容都以相同的方式表示。 与文档交互
服务行为和延迟 测试响应时间、身份验证失败、服务错误以及外部 API 或 MCP 服务器的限制。 集成和测试组件

对于大型数据集,设计 API 以筛选、聚合或返回相关子集,而不是将所有记录发送到对话中。 当方案需要文档内容时,请测试受支持的主机体验:声明式代理可以在 Word 和 PowerPoint 中访问整个打开的文档,但需考虑 文档格式。

优点和局限性

声明式代理的主要优点和主要限制有助于确定此架构何时适用于特定用例。

主要优势

声明式代理为希望在现有 Microsoft 365 环境中实施 AI 解决方案的组织提供了显著优势:

  • 托管对话运行时:Microsoft 托管业务流程协调程序和模型基础结构,因此无需实现该运行时。
  • 访问 Microsoft 功能:代理可以在外部工具中使用受支持的知识源和内置功能。
  • 基于配置的定制:指令、功能和操作无需自定义对话引擎即可定制体验。 外部集成仍可能需要代码和托管。

主要限制

声明式方法还引入了可能限制某些用例的约束:

  • 托管业务流程:你可以通过支持的配置而不是控制每个运行时决策来影响行为。 评估代表性任务,而不是将指令视为确定性的工作流引擎。
  • 平台和主机依赖项:功能、响应呈现、许可和管理取决于所选的 Microsoft 365 体验。 确认每个目标主机的支持。
  • 上下文和检索约束:知识检索和工具结果必须适合可用的上下文。 大型源或有效负载不能保证响应中完全覆盖。
  • 动态 Web 内容注意事项:特定范围的 Web 搜索使用必应索引内容,而不是直接查询基础数据源。 动态生成的内容可能不完整或陈旧。 当任务需要直接访问当前结构化数据时,请使用受支持的 API 集成。 请参阅 Web 搜索基础和动态内容。
  • 持续评估:平台和模型更新可能会更改行为。 随着代理及其依赖项的发展,测试指令、检索和工具使用。

用例对齐

根据解决方案所需的控制来选择架构,而不仅仅是根据任务是否有多个步骤。

最佳方案

声明性代理最适合:

  • 信息检索:主要需要搜索和汇总来自 Microsoft 365 或外部来源的信息的代理。
  • 辅助操作:将知识与支持的 API 或 MCP 操作相结合以帮助用户完成任务的代理。
  • 文档协助和分析:使用受支持的文档上下文或使用代码解释器等功能的代理。
  • 工作效率增强:受益于 Microsoft 365 中的托管对话体验的任务。

不适宜的方案

当您的要求包括以下内容时,请考虑使用自定义引擎代理或单独实施的工作流:

  • 自定义运行时控制:必须实现自己的业务流程、模型托管或用户界面,而不是使用托管的 Copilot 运行时。
  • 持久业务流程:系统必须独立于对话强制执行精确的执行顺序、事务边界、重试或恢复。
  • 大规模数据处理:该任务需要对数据集进行详尽的处理,而不是检索或分析相关的对话上下文。 在服务中执行该处理,并将适当的结果暴露给代理。
  • 直接访问动态源:该任务需要来自未在 Web 搜索中充分表示的源的当前有序结果。 提供受支持的 API 或 MCP 集成,而不是仅依赖范围的 Web 搜索。

这些要求并不总是排除声明式代理作为对话接口。 当代理收集输入、调用受支持的操作并显示结果时,服务可以拥有业务流程。