提示
受到推崇的: 从 Work IQ 开发工具 开始,用于受支持的专业代码声明代理和插件方案。 请参阅 WIQD 快速入门。 基于工具包的说明仍然可用于需要它们的现有项目和工作流。 在选择工具之前,请检查 功能和目标体验支持 : WIQD 不面向自定义引擎代理。
测试是为 智能 Microsoft 365 Copilot 副驾驶® 对话助手开发声明性代理的过程的重要部分。 可以在测试代理时使用 开发人员模式 来验证 Copilot 业务流程协调程序是否以及如何选择知识源来响应给定的提示。
此外,还可以使用 Microsoft 365 Agents Toolkit 中的“预览应用 (F5) ”功能在本地开发环境中测试代理。 此功能提供了一种交互式方式来直接从开发界面验证行为和排查问题。
在 Copilot 对话助手和代理工具包中使用开发人员模式
可以通过在 Agents Toolkit 窗格中选择 Preview your app (F5) 来测试 Visual Studio Code 中的 Agents Toolkit 中的代理。 这会在基于浏览器的 Copilot 对话助手体验中启动代理,使你能够快速验证它在响应提示时的行为方式。
在智能 智能 Microsoft 365 Copilot 副驾驶® 对话助手中选择代理后,通过键-developer on入启用开发人员模式。 要禁用开发人员模式,请键入 -developer off。
启用开发人员模式后,每当业务流程协调程序在代理中) (企业知识、数据) 、功能或技能 (操作或插件中搜索时,包含调试信息的卡将返回。 在代理工具包中,此调试信息显示在 “调试”面板 中,包括以下字段:
- 代理元数据:代理和对话的标识符
- 功能:为代理配置的功能列表,以及其执行状态和响应统计信息 (如果) 执行
-
操作:为代理配置的操作列表
- 匹配的函数:运行时应用索引查找中匹配的函数的状态
- 选择要执行的函数:根据 orchestrator 推理选择进行调用的函数的状态
代理元数据部分
代理元数据提供有关代理和当前调试会话的关键详细信息,包括:
- 摘要 - 配置的知识源及其使用统计信息的高级概述
- 代理 ID - 代理的唯一标识符,包括游戏 ID 和清单 ID
- 代理版本 – 当前使用的代理的版本号
- 对话 ID - 活动聊天会话或对话的标识符
- 请求 ID - 对话中特定提示的标识符
代理功能
代理功能部分显示代理配置的功能,定义其可访问知识源的范围。 为提示使用的每种功能提供了以下详细信息。
- 执行状态 - 指示在业务流程期间是否使用了该功能
- 诊断日志文件 - 一个可下载的 .txt 文件,其中包含详细的执行结果,包括成功或失败消息,有助于故障排除和验证
代理操作
代理操作部分提供了有关在编排期间如何处理代理的操作 (功能或插件) 的详细见解。 此信息分为三个关键领域: 操作元数据、 功能匹配和选择以及 执行详细信息。
操作元数据
此部分显示有关为代理注册的操作的一般信息。 此信息包括 操作 ID (操作) 的唯一标识符,以及使用) 的操作定义版本 (版本 号 。
功能匹配与选择
此部分展示了业务流程协调程序如何解释用户提示,以及是否有任何函数与执行相关:
匹配的函数 – 在运行时应用索引查找期间与用户提示语义匹配的函数。 如果给定提示未返回匹配的函数,则提示可能没有明确提及操作名称。
选定的要执行的函数 - 根据业务流程协调程序的推理和与提示的相关性选择进行调用的函数。 如果未启用任何操作,则操作部分指示未启用任何操作。
执行详细信息
操作执行详细信息包括函数及其状态,以及延迟、请求信息 (请求终结点、HTTP 方法、请求标头) 和响应。
排除故障
以下是调试代理时可能遇到的常见故障以及故障的可能原因。
无调试信息
启动代理后,检查与浏览器的连接是否在调试面板中标记为成功。 如果没有,请尝试在 Visual Studio Code 中再次运行 F5 以启动新会话。
如果连接成功,但看不到调试信息,可能是因为业务流程协调程序不需要你的 Microsoft 365 数据或技能来响应。 在这种情况下,不会返回调试信息卡。
在容量限制的情况下也不会返回调试信息,在容量限制的情况下,通常会看到错误消息以稍后重试。
未选择要执行的函数的调试信息
如果没有操作函数与提示的搜索意图匹配,则调试信息卡将报告未选择要执行的函数。 原因可能是清单中的命令说明与给定提示的搜索意向在语义上不相关。
如果 Copilot 以前匹配并成功运行了函数,则请求可能会受到限制。
包含空或失败的调试信息 无函数执行详细信息
对于 API 插件,如果有失败或没有函数执行详细信息,则表示在代理尝试将参数分配给插件的所选函数期间出现故障。 如果失败一致,则很可能是由于操作或参数描述不清晰、主机 URL 无效或 Open API 定义存在其他问题。
对于消息扩展插件,最佳实践是针对 9 秒以内的响应进行优化。 有关详细信息,请查看消息扩展插件的 技术要求 。
目前,Copilot 执行插件 API 的超时限制设置为 10 秒。
报告问题
使用拇指向上或拇指向下按钮,报告与代理有关的任何反馈或问题。 在报表中包含该 #extensibility 标记。