使用 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 中的开发人员模式来测试和调试代理

测试是开发智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®声明性代理的过程的重要部分。 可以使用 Copilot Studio 中的开发人员模式来测试代理,并验证 Copilot 业务流程协调程序是否以及如何选择知识源以用于响应给定提示。

在 Copilot 中使用开发人员模式

要在 Copilot 中启用开发人员模式,请键入 -developer on。 要禁用开发人员模式,请键入 -developer off。

智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 会话的屏幕截图,用户在其中键入“-developer on”以成功启用开发人员模式

启用开发人员模式后,每当业务流程协调程序专门在代理中搜索企业知识 (数据) 、功能或技能 (操作或) 插件以响应提示时,将返回包含调试信息的卡。 调试信息卡包含以下字段:

  • 代理元数据:代理和对话的标识符。
  • 功能:为代理配置的功能列表。
  • 操作:为代理配置的操作列表
    • 匹配的函数:运行时应用索引查找中匹配的函数的状态
    • 选择要执行的函数:根据 orchestrator 推理选择进行调用的函数的状态
  • 执行:提示的已执行功能和操作的列表
    • 已执行的功能:已执行功能的状态和响应统计信息。
    • 已执行的操作:操作的请求和响应执行状态。

代理元数据部分

智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®会话的屏幕截图,其中 Copilot 返回了显示代理元数据的调试信息的卡

代理元数据提供有关代理和当前调试会话的关键详细信息,包括:

  • 代理 ID - 代理的唯一标识符,包括游戏 ID 和清单 ID。
  • 代理版本 – 当前使用的代理的版本号。
  • 对话 ID - 标识活动的聊天会话或对话。
  • 请求 ID - 标识对话中的特定提示。

注意

代理 ID 中的前缀指示代理的分布方式:

  • U_ 指示用户作用域 (旁加载) 代理。
  • T_ 指示 (发布到租户存储或组织目录) 的租户范围代理。
  • P_ 指示公开可用的代理。

有关相关发布指南,请参阅:

代理功能

智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®会话的屏幕截图,其中 Copilot 返回了显示配置代理功能的调试信息的卡

代理功能部分显示代理的配置功能,定义其可访问的知识源的范围。

重要

如果“代理功能”部分指示已启用 WebSearch ,这仅意味着代理已启用该功能。 它不反映 Allow web search in Copilot 管理员可用于禁用其组织的 Web 搜索的云策略设置。 有关详细信息,请参阅 Microsoft 365 管理中心中的管理 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®方案。

代理操作

智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 会话的屏幕截图,其中 Copilot 返回了显示配置代理操作的调试信息的卡

代理操作显示操作 ID 和版本号、操作的配置功能及其匹配和选择状态。

未启用任何操作的卡

如果未启用任何操作,则操作部分指示未启用任何操作。

没有匹配函数的卡

如果给定提示未返回匹配的函数,这可能表明提示未明确提及操作名称。

执行详细信息

已执行的详细信息部分显示是否为提示执行了配置的功能或操作以及执行详细信息和状态。

功能执行详细信息

智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 会话的屏幕截图,其中 Copilot 返回了显示已执行功能的调试信息的卡

功能执行详细信息显示已执行的功能及其状态。 每种功能可能具有不同的执行详细信息,例如使用的搜索文本、功能的响应和/或返回的结果数。

操作执行详细信息

智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 会话的屏幕截图,其中 Copilot 返回了显示已执行操作的调试信息的卡

操作执行详细信息包括函数及其状态,以及延迟、请求信息 (请求终结点、HTTP 方法、请求标头) 和响应。

未选择要执行的函数的卡

如果没有操作函数与提示的搜索意图匹配,则调试信息卡将报告未选择要执行的函数。 这可能是因为清单中的命令说明与给定提示的搜索意向在语义上不相关。

如果 Copilot 以前匹配并成功运行了函数,则可能存在限制。

具有空或失败的卡 无函数执行详细信息

对于非消息扩展插件,如果有失败或没有函数执行详细信息,则表示在代理尝试将参数分配给插件的所选函数期间失败。 如果失败一致,则很可能是由于操作或参数描述不清晰、主机 URL 无效或 Open API 定义存在其他问题。

对于消息扩展插件,最佳实践是针对 9 秒以内的响应进行优化。 有关详细信息,请查看消息扩展插件的 技术要求 。

目前,Copilot 执行插件 API 的超时限制设置为 10 秒。

排除故障

以下是调试代理时可能遇到的常见故障以及故障的可能原因。

无调试卡

如果业务流程协调程序不需要 Microsoft 365 数据或技能来响应提示,则不会返回调试信息卡。

在容量限制的情况下也不会返回调试卡,通常会看到错误消息以稍后重试。

报告问题

使用拇指向上或拇指向下按钮,报告与代理有关的任何反馈或问题。 在报告中包含 #extensibility 标记。

智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 赞或取消赞反馈选项的屏幕截图

在文本框中输入一条消息,包括 #extensibility 标记。

文本框中 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 反馈的屏幕截图