测试是开发用于智能 Microsoft 365 Copilot 副驾驶® 对话助手的声明性代理过程中的重要部分。 可以在测试代理时使用 开发人员模式 来验证 Copilot 业务流程协调程序是否以及如何选择要用于响应给定提示的知识源。
在 Copilot 对话助手 中使用开发人员模式
若要启用开发人员模式，请在 智能 Microsoft 365 Copilot 副驾驶® 对话助手 中键入 -developer on。 若要禁用开发人员模式，请键入 -developer off。
启用开发人员模式时，每当业务流程协调程序专门搜索企业知识 (数据) 、功能或技能 (代理中) 作或插件以响应提示时，将返回具有调试信息卡。 调试信息卡包含以下字段：
- 代理元数据：代理和会话的标识符。
- 功能：为代理配置的功能列表。
-
作：为代理配置的作列表
- 匹配函数：运行时应用索引查找中匹配的函数的状态
- 要执行的所选函数：根据业务流程协调程序推理选择用于调用的函数的状态
-
执行：提示的已执行功能和作的列表
- 已执行的功能：已执行功能的状态和响应统计信息。
- 已执行的作：作的请求和响应执行状态。
代理元数据部分
代理元数据提供有关代理和当前调试会话的关键详细信息，包括：
- 代理 ID - 代理的唯一标识符，包括游戏 ID 和清单 ID。
- 代理版本 – 当前正在使用的代理的版本号。
- 对话 ID - 标识活动聊天会话或对话。
- 请求 ID - 标识对话中的特定提示。
代理功能
“代理功能”部分显示代理的配置功能，并定义其可访问知识源的范围。
代理作
代理作显示作 ID 和版本号、为作配置的函数及其匹配和选择状态。
未启用“无作”的卡片
如果未启用任何作，则 actions 部分指示未启用任何作。
未匹配函数的卡片
如果未为给定提示返回匹配的函数，则可能表示提示未显式提及作名称。
执行详细信息
执行的详细信息部分显示是否以及是否针对提示执行了配置的功能或作，以及执行详细信息和状态。
功能执行详细信息
功能执行详细信息显示已执行的功能及其状态。 每个功能可能具有不同的执行详细信息，例如使用的搜索文本、功能的响应和/或返回的结果数。
作执行详细信息
作执行详细信息包括 函数及其状态、延迟、请求信息 (请求终结点、HTTP 方法、请求标头) 和响应。
未选择用于执行的函数的卡片
如果没有作函数与提示的搜索意向匹配，则调试信息卡报告“未选择执行任何函数”。 这可能是因为清单中的命令说明在语义上与给定提示的搜索意向无关。
如果 Copilot 以前匹配并成功运行了函数，则这表示存在限制。
包含空或失败 的卡片无函数执行详细信息
对于非消息扩展插件，如果存在失败或没有函数执行详细信息，则表示代理尝试将参数分配给插件的所选函数期间失败。 如果失败是一致的，很可能是由于作或参数说明不明确、主机 URL 无效或 Open API 定义存在其他问题。
对于消息扩展插件，最佳做法是针对 9 秒以下的响应进行优化。 有关详细信息，请查看消息扩展插件 的技术要求 。
目前，Copilot 执行插件 API 的超时限制设置为 10 秒。
排查失败问题
以下是调试代理时可能会遇到的常见故障以及失败的可能原因。
无调试卡
如果业务流程协调程序不需要你的 Microsoft 365 数据或技能来响应提示，则不会返回调试信息卡。
在容量限制的情况下，调试卡也不会返回，在这种情况下，你通常会看到错误消息，以供稍后重试。
报告问题
使用“向上或向下大拇指”按钮报告代理的任何反馈或问题。 在报表中包含 #extensibility 标记。
在文本框中输入一条消息，包括 #extensibility 标记。
