必须从退出码识别、异步控制、参数校验三处切入：1. 依赖mmx-cli语义化退出码（128/129/130/131）分支处理失败；2. 长耗时工具必加--async并轮询task_id；3. 强制--strict参数与json结构校验，杜绝隐式容错。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让MiniMax Agent在连续调用Shell、Browser、Python等工具时不再随机失败、卡死或返回空结果，必须从退出码识别、异步控制、参数校验三处切入，缺一不可。
识别并响应语义化退出码
Agent不能靠读报错文本判断失败类型，必须依赖MMX-CLI返回的数字退出码做分支处理。
执行命令后立即检查$?值：成功为0，鉴权失败固定返回130，参数错误返回128，网络超时返回129，模型内部错误返回131。
在Shell脚本中写明分支逻辑：if [ $? -eq 130 ]; then echo "API key失效" >&2; exit 130; fi。
【退出码未捕获将导致Agent无限重试或静默失败】。普通CLI只返回1，而MMX-CLI的128/129/130/131是唯一可靠信号源，不读它就等于闭眼开车。
启用非阻塞异步模式
长耗时工具（如视频生成、大文件解析）必须加--async参数，否则Agent线程会被挂起，无法响应其他任务。
第一步：调用命令末尾添加--async，例如mmx video-gen --prompt "科技感开场动画" --async。
第二步：命令立即返回JSON，含task_id和status字段，例如{"task_id":"t_abc123","status":"queued"}。
UP 简历 AI 求职助手。创建专业简历、搜索校招/社招/实习岗位、JD 对照优化、简历诊断、每日求职监控、智能投递指导。当用户说"创建简历"、"编辑简历"、"搜索校招"、"找工作"、"优化简历"、"投递"、"监控校招"时使用。
第三步：用task_id轮询状态：mmx task-status --id t_abc123，直到status变为"completed"或"failed"。
注意：不加--async时，视频生成可能阻塞30秒以上，Agent在此期间无法处理任何新请求。
强制参数校验与结构收敛
MiniMax M2.5默认允许宽松参数输入，但松散结构会触发工具调用链路中的隐式容错降级，导致返回空或格式错乱。
方法一：在调用前用jq校验JSON结构是否符合工具注册Schema
echo '{"query":"AI趋势"}' | jq '.query | type == "string"' || exit 128
方法二：对所有工具调用统一加--strict参数，使MMX-CLI在参数缺失或类型不符时直接返回128退出码，而非尝试补全或忽略。
方法三：在Agent提示词末尾追加硬性约束：“所有工具调用必须输出完整JSON，字段名与类型严格匹配注册Schema，禁止省略required字段，禁止添加未声明字段。”
【--strict参数不启用时，shell_exec可能因缺少cwd参数而静默失败】。该参数是防止“看似执行成功实则无输出”的关键开关。
