必须设置 enable_execution_trace: true 才能获取 execution_trace 字段,其中 step_type 分类包括 plan、invoke、tool_call、verify、aggregate;final_answer 可能被截断,推荐从 aggregate 步骤的 output.artifacts 提取完整产物。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要在调用 MiniMax Agent API 后,准确获取其执行过程中的中间步骤与最终输出结果,而不是只拿到一个笼统的文本回复——这关系到你能否做状态校验、错误回溯、前端进度展示或下游系统对接。
确认 API 响应结构含 execution_trace 字段
MiniMax M2.5 Agent 的标准 API 响应默认不返回完整执行链路,必须显式启用 trace 模式。否则你收到的 response.body 只有 final_answer 字段,所有工具调用、子任务分发、Verifier 校验记录全部丢失。
在发起 POST 请求时,【必须在 request body 中设置 enable_execution_trace: true】,否则后续任何解析都无从谈起。
示例请求体关键字段:
{"messages":[{"role":"user","content":"生成一份华东地区2026年Q2新能源汽车销量分析报告"}],"model":"minimax-m25","enable_execution_trace":true,"max_steps":12}
解析 execution_trace 中的 step_type 分类
启用 trace 后,响应体中会新增 execution_trace 数组,每个元素是一个 step 对象。不要直接遍历全部字段——先按 step_type 过滤,再针对性提取。
常见 step_type 有:plan(主Bot拆解任务)、invoke(调用子Bot)、tool_call(执行工具)、verify(Verifier校验)、aggregate(结果聚合)。
例如,你要定位子Bot返回的原始数据,就只关注 step_type === "invoke" 且 status === "success" 的项,然后读取其 output 字段;若要查某次搜索是否被拒绝,则找 tool_call 步骤里 name === "m2.5-search" 且 error 字段非空的条目。
提取 final_answer 与 artifacts 的两种路径
方法一:直接读 response.final_answer(仅当任务成功完成且未中断时存在)
方法二:从 execution_trace 最后一个 aggregate 步骤中提取 output.artifacts ——这是更可靠的方式,因为 Mavis 模式下 final_answer 可能被截断或格式化,而 artifacts 保留原始 JSON 结构、图表 Base64、代码文件内容等完整产物。
【注意:artifacts 字段只在 aggregate 步骤中出现,且可能为空数组;若为空,说明该任务未生成可交付物】
监听 streaming 响应中的 event 类型
如果你使用 SSE(Server-Sent Events)方式调用 /v2/chat/completions 接口,响应流中会出现多种 event:
event: trace_step → data 包含单个 step 对象,可用于实时渲染执行流程图
event: final_answer → data 是纯文本结果,不含结构化信息
event: artifact → data 是 Base64 编码的文件内容(如 PNG 图表、CSV 表格),需前端 decode 后展示
event: error → data 包含 code 和 message,例如 code: "TOOL_CALL_FAILED" 表示某个工具调用失败,此时应停止等待并检查对应 step 的 tool_name 和 input 参数
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











