遇到MiniMax Agent任务失败时，应使用结构化Bug排查指令替代手动盲搜：①直接粘贴完整错误堆栈让Agent分析根因；②指定路径读取本地日志并分类/还原调用链；③启用systematic-debugging技能执行四步排障；④用trace_id反向还原执行路径定位首错点。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在MiniMax Agent运行中遇到“任务失败”却找不到具体哪步出错，日志里混着LLM响应、工具调用结果和错误堆栈，靠肉眼翻600行根本定位不了根因时，必须用结构化、可触发的Bug排查指令来替代手动盲搜。
直接扔报错给Agent分析
这是最快上手的方式，适合终端或日志里已明确捕获到完整错误堆栈的场景。
第一步：复制完整的错误输出，包括panic信息、goroutine栈、文件路径与行号；
第二步：在MiniMax Agent对话框中输入：“我运行测试的时候出现这个错误，帮我分析根因”，然后粘贴全部报错内容；
这一步操作起来很简单，直接把错误文本拖进去就行。Agent会自动识别nil pointer、timeout、JSON decode failure等典型模式，并指出问题发生在哪个对象未初始化、哪行代码越界、哪个工具返回了非预期结构体。
让Agent读取本地日志文件
适用于线上环境日志已落盘但无法实时复制粘贴的场景，比如/var/log/app/error.log或~/.minimax/agent/logs/下的滚动日志。
方法一：指定路径+分析要求
输入：“帮我看一下 /var/log/app/error.log 最近的错误，按类型分类找出频率最高的前5个，分析可能的原因”；
方法二：限定时间范围+聚焦异常链
输入：“读取 ~/.minimax/agent/logs/agent-20260811*.log 中从 14:00 到 15:30 的日志，提取所有含 ‘failed’ 或 ‘panic’ 的行，把它们按调用链还原成执行步骤序列”；
【注意：路径必须是Agent有权限读取的目录，不能写 ~/Downloads 或 /root 下的路径】
启用systematic-debugging技能
这是最接近专业SRE排障流程的指令写法，能避免凭直觉乱试导致的时间浪费。
① 先激活技能：输入“激活 systematic-debugging skill”；
② 再提交上下文：提供任务ID、失败时间戳、涉及的工具列表（如search_knowledge_base、send_email、parse_pdf）；
③ 最后下指令：“对 task_id=ag-8d2f9c 的失败执行完整排障流程”；
Agent收到后会严格按四步走：先收集日志片段与配置快照→生成3个最可能根因假设→逐个验证（例如重放某次tool call输入、检查对应缓存key是否存在）→确认后给出修复代码补丁和回归测试建议。这一步不依赖你是否理解Redis pipeline或Go context超时机制，它自己会查。
用trace ID反向定位执行路径
如果你已在代码中植入了trace层（比如每步生成唯一span_id并打点到日志），就可以用ID驱动Agent精准回溯。
输入：“根据 trace_id=tr-7a1b3e9f 查找所有关联日志行，按时间顺序还原执行路径，标出第一个返回非200或抛出异常的工具调用”；
这比翻原始日志快十倍。Agent会自动过滤无关行，只提取带该trace_id的日志，并把Calling tool、Tool result、LLM response、Error stack四类事件按毫秒级时间戳串成因果链——你一眼就能看到是第7步调用search_knowledge_base时返回了空数组，导致第8步LLM生成了无效SQL。
