应依次启用debug日志、使用诊断终端、注入断点日志、导出执行轨迹、比对内存快照；五步分别用于捕获原始执行流、交互验证状态、追踪中间变量、离线深度分析、识别上下文污染。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在MuleRun中部署的Agent行为异常、响应延迟或输出不符合预期，则可能是由于输入未通过校验、内存上下文错乱、工具调用失败或底层日志未暴露关键错误。以下是调试此问题的步骤：
一、启用并查看Agent运行时Debug日志
该方法用于捕获Agent在云端虚拟机中执行全过程的原始输出，包括工具调用参数、LLM请求/响应载荷、内存加载状态及异常堆栈，是定位逻辑错误的第一手依据。
1、登录MuleRun控制台，进入「我的Agent」页面，点击目标Agent右侧的「设置」图标。
2、在设置面板中切换至「高级配置」标签页，找到「日志级别」下拉菜单，将其设为DEBUG。
3、勾选「启用实时日志流」，并确认「日志保留周期」不低于7天（免费账户默认为3天）。
4、返回Agent卡片，点击「重启Agent」以使日志配置生效。
5、在Agent运行过程中，点击卡片右上角「日志」按钮，即可在弹出窗口中滚动查看带时间戳的完整日志流。
二、使用内置诊断终端执行交互式调试
该方式提供类SSH的轻量终端界面，允许用户在Agent运行上下文中直接执行检查命令、打印变量、手动触发工具或临时覆盖memory状态，适用于需即时验证中间状态的场景。
1、在Agent控制台页面，点击目标Agent下方的「调试」按钮，选择「启动诊断终端」。
2、终端初始化完成后，输入命令mulerun.inspect('chat_history')，查看当前加载的对话历史内容与长度。
3、若怀疑某工具未正确授权，运行mulerun.list_tools()，确认所需工具名是否出现在返回列表中且状态为enabled。
4、如需强制重载最新memory快照，执行mulerun.reload_memory()，系统将同步主记忆库并刷新缓存。
三、注入断点式日志埋点并回传关键变量
该方案适用于复杂链路中难以复现的偶发性问题，通过在Runnable链特定节点插入结构化日志语句，将中间结果实时推送至用户侧，绕过默认日志截断限制。
1、进入Agent编辑页，在「自定义代码」模块中定位到待监控的节点（如after_validation或before_llm_call）。
2、插入如下语句：mulerun.log({'stage': 'before_llm_call', 'input_vars': vars.input, 'context_len': len(memory.chat_history)})。
3、保存并重新部署Agent，确保「日志回传」开关处于开启状态。
4、前往「日志」界面筛选类型为CUSTOM的日志条目，按时间顺序分析各阶段变量值变化趋势。
四、导出完整执行轨迹进行离线分析
该方法生成包含时间戳、操作类型、输入/输出快照、工具调用耗时及错误码的JSONL格式轨迹文件，支持用外部工具（如VS Code、jq）进行深度过滤与关联分析，适合排查长周期任务中的性能衰减或状态漂移。
1、在Agent运行记录列表中，找到目标执行实例，点击其右侧「⋯」展开菜单。
2、选择「导出完整轨迹」，系统将生成唯一下载链接，有效期为24小时。
3、下载得到的trace_20260328_100245.jsonl文件中，每行均为独立JSON对象，含字段"timestamp"、"step"、"output_truncated"等。
4、使用命令行工具提取所有错误事件：grep '"error":' trace_*.jsonl | head -n 20。
五、触发强制内存快照比对识别上下文污染
当Agent出现指代混乱、重复提问或遗忘已确认信息时，往往源于ConversationBufferMemory被意外写入脏数据或实体记忆索引错位，本方法通过双时间点快照对比快速定位污染源。
1、在Agent处于空闲状态时，执行mulerun.snapshot_memory('baseline')，保存初始上下文快照。
2、发起一次典型会话（至少3轮），完成后立即运行mulerun.snapshot_memory('current')。
3、在「记忆管理」页点击「比对快照」，选择baseline与current，系统将高亮显示新增/变更的entity_keys与chat_history_diff。
4、若发现非预期实体（如误识别的“张三”为用户姓名），可在比对结果页点击该实体右侧的「清除」按钮，仅移除本次污染项。
