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