调试

用户9256

2024年6月28日修改

在搭建 Bot 后，你可以在预览与调试界面与 Bot 进行对话，并根据 Bot 执行过程及响应信息对 Bot 配置进行优化与调整。在实际使用 Bot 时，如果 Bot 响应不符合预期、速度过慢甚至不响应时，也可以通过调试台查看 Bot 的执行细节，排查问题。 ​

调试台介绍

扣子的调试台功能提供全链路调试，你可以在调试台查看每一条用户请求从输入到响应的全流程，包括模型调用、配置的工作流或知识库等详细信息，方便你精准并快速定位问题，调整 Bot 配置。 ​

调试台适用于以下场景的问题分析：

•
开发调试：搭建 Bot 时，发现 Bot 输出不符合预期，例如回答与问题不符，需要修改 Bot 流程。 ​

•
线上排障：收到 Bot 用户反馈，例如 Bot 不响应、返回错误信息，需要诊断定位问题。​

打开调试台

你可以通过 Bot 的编排页面进入调试台，操作步骤如下：

登录扣子。

2.
在左侧导航栏，选择一个空间，进入到目标 Bot 或创建一个新的 Bot。​

3.
在 Bot 编排页面右侧的预览与调试区域，发送一条消息内容开始与 Bot 对话。 ​

4.
在收到 Bot 响应后，点击消息卡片下方的调试按钮，或点击右上角的调试选项进入调试台页面。​

进入调试台页面后，默认展示当前消息的响应过程，你可以筛选或选择查看之前某次对话的响应过程。​

调试信息说明

调试台中展示每轮对话运行的全链路，包括会话的 Logid 等基础信息、调用流程、每个节点的状态和耗时等节点详情、节点的输入和输出等信息。 ​

基础信息

页面默认展示当前会话的信息，你也可以通过会话时间和会话状态筛选会话，例如查看上周日所有运行异常的会话。会话详情区域用于了解会话的概览数据，例如会话整体耗时、消耗的 token 数量是否超出预期等等。​

参数

说明

耗时

响应返回的整体耗时，即从用户发起会话到 Bot 运行结束的时长，单位为毫秒。 ​

token 数量

该会话消耗的 token 总数量，包括用户输入、运行链路、模型输出、Bot 推荐词等配置消耗的 token 数量。 ​

任务状态

响应返回的状态，成功或失败。

Logid

当前响应的Log ID。如果无法自行排查问题，可以将 Logid 提供给扣子平台，协助处理。 ​

调试​