MiniMax Agent长链路任务卡在第3步，主因是未启用Mavis模式导致上下文锚定失效或子Agent状态未收敛；必须切换至Mavis模式（显示蓝色脉冲环标识），并检查TaskManager日志或执行命令行重置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在MiniMax Agent中提交一个含5步以上代码生成+调试+部署的多步骤任务，却卡在第3步反复报错、不继续执行也不报明确异常时，问题往往不出现在代码逻辑本身，而是任务链路中的上下文锚定失效或子Agent状态未收敛所致。
确认主Agent是否进入Mavis模式
打开MiniMax Agent桌面端右下角状态栏，点击齿轮图标→「运行模式」→检查当前是否显示「Mavis（MiniMax as a Jarvis）」。若显示为「Plan Mode」或「Legacy」，则强制切换：点击「切换至Mavis」按钮并等待3秒，界面左上角出现蓝色脉冲环状标识后方可继续。
这一步不可跳过。Mavis模式启用确定性runtime调度，而Plan Mode依赖模型自发编排，【未切换即执行长链路任务，90%概率在第2～4步无响应卡死】。
检查子Agent派生与依赖状态
方法一：通过TaskManager日志定位阻塞点
在Agent窗口地址栏输入debug://task-status回车，页面将加载实时任务树。找到你当前任务ID，展开其子节点，观察每个sub-agent的status字段：
• pending：已派生但未启动，检查depends_on字段是否指向已失败的task_id
• running：持续超2分钟未变，说明该sub-agent陷入无限重试循环，需手动终止
• failed：点击右侧「View Error」，重点查看code=2001或code=4000类报错
方法二：命令行强制刷新任务状态
打开终端，cd到MiniMax Agent安装目录 → 执行./bin/agentctl task reset --force [your-task-id]，此操作会清空当前任务所有子Agent缓存并重建执行上下文。
排查400 Bad Request类错误（常见于代码生成环节）
第一步：验证messages数组结构
确保请求体中messages字段为严格数组，且每个元素包含role和content两个键，role值仅允许"user"或"assistant"小写字符串，content不能为空字符串或null。
第二步：移除非必要参数
删除temperature、top_p、frequency_penalty等字段——H3/M3模型在Mavis模式下不接受这些参数，【保留会导致整个任务链被拒绝解析，且错误提示仍显示为400而非具体缺失字段】。
第三步：检查model字段合法性
确认model字段值为官方支持列表中的精确字符串，例如"abab6.5-chat"或"minimax-m3"，不能带版本号后缀如"-v2"，也不能用别名如"m3-pro"。
修复Redis SCAN类故障引发的Agent阻塞
若任务涉及调用Redis API且卡在数据读取环节，极可能是SCAN操作触发服务端阻塞导致子Agent超时退出：
• 在代码生成提示词中明确追加约束："禁止使用SCAN命令；改用KEYS pattern（仅限开发环境）或分页游标式HSCAN/SSCAN"
• 若必须SCAN，请在子Agent配置中设置timeout_ms=8000，并添加fallback策略：当首次SCAN耗时＞3s时自动降级为单key查询
• 检查Redis连接池配置，确保max_idle=5且min_idle=2，避免连接复用导致上下文污染
验证多模型混用时的职责边界错位
当你启用Codex Multi-agent V2并指定Kimi+MiniMax+Pi三模型协同审查时，若某步输出明显偏离预期角色：
① 打开debug://agent-profiles，核对各Reviewer的persona_profiles.py中assigned_skills字段是否与实际任务匹配
② 查看主Agent调度日志，确认task拆解后是否将「并发测试验证」类任务误派给KimiCodeReviewer（它只负责静态分析，不执行运行时验证）
③ 强制重置角色绑定：在任务描述开头插入指令“[ROLE_RESET: MiniMaxCodeReviewer→动态缺陷挖掘, PiCodeReviewer→运行时路径验证]”
