使用开发人员模式调试代理

在测试代理时,可以使用 开发人员模式 来验证副驾驶业务流程协调程序是否以及如何选择插件以响应给定的提示。

使用 copilot 开发人员模式

copilot Chat 中,可以通过键入 -developer on (或 off 禁用) 来启用开发人员模式。

用户键入“-developer on”以成功启用开发人员模式的“copilot Chat”会话的屏幕截图

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

  • 已启用的插件:为代理启用的插件列表
  • 匹配的函数:运行时应用索引查找中匹配的插件和函数的列表
  • 要执行的所选函数:根据业务流程协调程序推理选择用于调用的插件函数的列表
  • 函数执行详细信息:请求和响应函数执行状态

“copilot Chat”会话的屏幕截图,其中 copilot 返回了一个卡,其中包含调试信息,其中显示已启用插件的成功匹配、选择和函数执行的 “copilot Chat”会话的屏幕截图,其中 copilot 已返回卡,其中调试信息显示成功选择,以及已启用插件的函数执行

排查执行失败问题

下面是调试插件执行时可能会遇到的一些常见故障以及可能的原因。

无调试卡

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

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

启用插件的卡片

如果未启用任何插件,则“已启用的插件”部分指示没有启用插件。

未匹配函数的卡片

如果启用了相关插件,但给定提示未返回匹配的函数,则可能表示提示未显式提及插件名称。

未选择用于执行的函数的卡片

如果没有启用的插件与提示的搜索意向匹配,则调试信息卡报告“未选择执行任何函数”。 这可能是因为清单中的命令说明在语义上与给定提示的搜索意向无关。

如果 copilot 以前成功匹配并执行了插件函数,这可能是限制的指示。

包含空或失败 的卡片无函数执行详细信息

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

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

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

报告问题

使用“向上或向下大拇指”按钮报告插件的任何反馈或问题。 在报表中包含 #extensibility 标记。 选择是竖起大拇指 (“我喜欢某件事”) 还是大拇指向下 (“我不喜欢某个 ) ”副驾驶响应后立即竖起或 大拇指向下反馈选项的屏幕截图

然后,在文本框中输入包含 #extensibility 标记的消息 。文本框中“copilot Chat”反馈的屏幕截图