调试bot需打开调试面板发送消息启动会话，实时查看日志定位节点执行异常、变量值错误及插件调用失败问题，注意日志不保存且调试打印节点仅限调试使用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在扣子（Coze）平台开发Bot时，遇到消息不触发、逻辑跳转异常或变量值不符合预期，必须通过调试面板实时观察Bot运行过程与日志输出才能准确定位问题。
打开调试面板并启动会话
进入Bot编辑页 → 点击右上角「调试」按钮 → 在弹出的调试面板中，直接在输入框发送任意消息（如“你好”）即可自动启动一次新会话。
这一步操作起来很简单，直接发送消息就能触发Bot完整执行链，无需额外配置启动参数。注意：调试会话仅对当前浏览器标签页有效，关闭后即终止，且【不会保存历史记录】，刷新页面会丢失全部日志。
查看实时运行日志与节点执行状态
调试面板左侧显示会话消息流，右侧默认展开「日志」标签页，每条Bot响应下方都附带一个「查看日志」链接，点击即可展开该轮响应对应的完整执行日志。
日志按时间倒序排列，每条含时间戳、节点ID、节点类型（如「LLM」、「条件判断」、「插件调用」）和原始输出内容。关键字段如node_id、status、error_message会高亮显示，其中status: failed行需优先检查。
如果某节点未执行，日志中将完全缺失该节点条目——说明流程在前序分支已中断，此时应回看上一条「条件判断」节点的output值是否符合预期分支条件。
扣子 (Windows) 是字节跳动推出的一站式 AI Agent 平台客户端，支持多 Agent 协作、可视化工作流和知识库管理。最新版本新增 Claude Code 与 Codex CLI 接入、多端同步和项目级管理功能，同时优化了插件生态和 AI 响应速度，让用户在 Windows 上即可高效创建、运行和协作智能体，满足个人、团队及企业场景需求。
定位变量值与上下文传递问题
方法一：在关键节点后插入「调试打印」节点
在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，不校验字段映射逻辑是否生效。
