预览与调试

更新于: 2026-06-24 15:44:40

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

调试台介绍

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

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

在智能体编排页面右侧的预览与调试区域，发送一条消息内容开始与智能体对话。
在收到智能体响应后，点击消息卡片下方的调试按钮，或点击右上角的调试选项进入调试台页面。

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

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

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

参数	说明
耗时	响应返回的整体耗时，即从用户发起会话到智能体运行结束的时长，单位为毫秒。
token 数量	该会话消耗的 token 总数量，包括用户输入、运行链路、模型输出、智能体推荐词等配置消耗的 token 数量。
任务状态	响应返回的状态，成功或失败。
Logid	当前响应的Log ID。如果无法自行排查问题，可以将 Logid 提供给扣子平台，协助处理。
首次响应耗时	第一个字符出现的时长，单位毫秒。

在排查和定位问题时，往往需要查看请求的完整调用链路，扣子编程通过可视化的方式展示了整个请求响应的完整链路和各节点的执行情况包括输入、输出、耗时等，帮助你快速定位问题和故障

调试台的火焰图可以帮助你清晰地了解各节点的耗时，有针对性的进行性能调优。

场景	调试方法
工作流	当智能体使用了工作流时，你可以通过调试台查看每次请求响应的工作流节点的输入和输出，以及调用出错的节点，方便你快速定位工作流中有问题的节点。
插件	与工作流类型，你也可以通过调试台查看每次请求响应中调用的插件的运行情况，以及运行出错的插件节点。
知识库	知识库作为智能体配置中重要的信息存储和知识来源，知识库的召回速度和准确性会直接影响回复的准确性。在调试台中你可以查看知识库节点的运行情况。此外，你可以在请求响应运行完毕后，在调试与预览页面中，点击运行完毕选项，然后展开知识库节点，查看召回的内容片段是否正确。