扣子智能体调试面板使用教程与日志查看技巧

调试Bot并非难事，关键在于掌握调试面板的正确用法。打开面板后随意发送一条消息，Bot的完整执行链路便会清晰呈现。日志实时追踪每一步运行状态，节点错误、变量异常一目了然。需要注意的是，调试会话仅限当前浏览器标签页有效，关闭即终止，且不会保存历史记录——刷新页面后，所有日志全部丢失。

在扣子平台构建Bot时，消息无法触发、逻辑跳转偏离预期、变量值与设计不符是常见故障。调试面板正是针对性工具——实时监控Bot运行轨迹与日志输出，精准定位问题根源。

开启调试面板并启动会话

操作极简：进入Bot编辑界面，点击右上角“调试”按钮，在弹出面板中输入任意消息（例如“你好”），即可自动发起新会话。无需配置启动参数，发送消息即刻触发Bot完整执行链路。

务必注意：调试会话仅作用于当前浏览器标签页，关闭即终止，且不保存历史记录。一旦刷新页面，全部日志消失。

查阅实时运行日志与节点执行状态

面板左侧展示会话消息流，右侧默认显示“日志”标签。每条Bot响应下方均有“查看日志”链接，点击即可展开该轮响应对应的完整执行日志。

日志按时间倒序排列，每条记录包含时间戳、节点ID、节点类型（如“LLM”“条件判断”“插件调用”）及原始输出内容。关键字段高亮显示，例如node_id、status、error_message。若出现status: failed，应优先排查该行。

若某节点完全未执行，日志中会缺失该节点条目——表明流程在前序分支已中断。此时，检查上一条“条件判断”节点的output值是否匹配预期分支条件，即可定位症结。

定位变量值与上下文传递问题

变量值传递异常是最棘手的问题。以下两种方法能快速定位：

方法一：在关键节点后插入“调试打印”节点
在Bot流程图中，将鼠标悬停在任意连接线上，点击“+”号，选择“调试打印”节点，输入需观测的变量名（例如{{user_input}}或{{api_result.data[0].title}}），保存后重新触发调试会话。

方法二：解析日志中的context快照
在日志中搜索"context": {，其后JSON块即为当前节点执行前的完整上下文。注意：快照仅包含显式赋值或上游传递的变量，不含动态计算字段。若变量名拼写错误或路径越界（如{{data.items.99.title}}），该位置将显示null或直接缺失键。

切记：调试打印节点不影响Bot线上行为，仅限调试面板输出。上线前必须移除，防止敏感字段泄露。

复现并隔离插件调用失败

插件调用失败是高频故障。按以下三步处理：

第一步：在调试面板中找到报错插件节点的日志行，确认status为failed，并包含error_message字段。
第二步：复制该日志中的request_payload内容（通常为JSON），粘贴至Postman或curl命令重放请求。
第三步：比对响应结果与插件配置中的“返回字段映射”是否一致。例如：插件文档要求返回{"code":0,"data":{...}}，但实际返回{"status":"success","result":{...}}——映射规则需同步调整，否则Bot后续读取data内的字段时将直接扑空。

此步骤必须手动验证。调试面板仅展示插件返回的原始body，不校验字段映射逻辑是否生效。映射不匹配，Bot后续无法读取正确数据。因此，不要仅依赖面板，亲自验证更为可靠。

来源：互联网