MiniMax Agent API获取执行结果教程

大墨同学_6229

大墨同学_6229

2026-08-14

610人浏览

原创

必须设置 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获取执行结果教程

你需要在调用 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 字段非空的条目。

Agents
Agents

设计、构建并部署AI智能体,涵盖架构模式、框架选型、记忆系统及生产安全。

下载

提取 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应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

agent minimax

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
minimax入口地址汇总
minimax入口地址汇总

本专题整合了minimax相关入口合集,阅读专题下面的文章了解更多详细地址。

2026.03.16

3008

9

minimax视频生成教程汇总
minimax视频生成教程汇总

本专题整合了minimax生成视频相关教程,阅读下面的文章了解更多详细操作。

2026.03.17

380

23

Minimax生成视频提示词和小技巧
Minimax生成视频提示词和小技巧

本专题整合了Minimax生成好的视频教程合集,阅读专题下面的文章了解更多详细内容。

2026.03.20

169

13

Minimax API接口合集
Minimax API接口合集

本专题整合了Minimax API接口相关教程,阅读专题下面的文章了解更多详细步骤。

2026.03.30

205

18

minimax大模型
minimax大模型

本专题整合了minimax大模型官网入口地址、升级内容等等内容,阅读专题下面的文章了解更多详细内容。

2026.03.31

328

24

Minimax海螺AI视频生成完全攻略
Minimax海螺AI视频生成完全攻略

围绕当前最热门的 AI 视频生成需求,全面讲解 Minimax 海螺 AI 视频生成的使用方法,涵盖文本生成视频(Text-to-Video)的场景描述与镜头语言提示词编写、图片生成视频(Image-to-Video)的首帧构图与运动方向控制、视频风格(写实/动漫/电影/3D)切换技巧、生成效果的常见问题(人物变形/动作不连贯)优化策略、热门爆款视频的创作思路拆解,帮助创作者与运营人员用 AI 高效产出吸睛短视频内容。

2026.05.13

538

18

Minimax语音克隆与AI配音实战合集
Minimax语音克隆与AI配音实战合集

聚焦 Minimax 语音技术中最受关注的声音克隆与 AI 配音应用,讲解声音克隆(Voice Clone)的录制要求与上传流程、少量样本即可定制专属音色的操作步骤、克隆音色的自然度与相似度优化技巧、中英文及多语种语音合成效果调控、情感化朗读(开心/悲伤/激昂/低沉)的参数设置,以及在短视频配音、有声读物批量制作、播客节目生成、电商产品口播、企业培训课件配音等热门场景中的实操应用。

2026.05.13

443

17

Minimax 注册与快速入门指南
Minimax 注册与快速入门指南

面向 AI 工具新手,从 Minimax 的账号注册、海螺 AI(Hailuo AI)网页端与移动端使用讲起,介绍 Minimax 大模型家族(abab 系列语言模型、语音模型、视频模型)的能力定位与产品矩阵、智能对话的基本使用技巧、角色扮演与长文本处理功能体验、免费额度与订阅方案说明,帮助用户快速了解 Minimax 平台全貌并高效上手使用。

2026.05.13

594

13

Minimax API 开发与多模态集成合集
Minimax API 开发与多模态集成合集

系统讲解 Minimax 开放平台 API 的开发与集成方法,涵盖 API Key 申请与鉴权机制、Chat Completion 文本对话接口的参数配置(temperature/top_p/tokens_to_generate)与多轮对话管理、流式输出(SSE Streaming)实现、Text-to-Speech(T2A)语音合成接口与音色选择、视频生成(Video Generation)接口调用与任务状态查询、Embeddings

2026.05.13

477

18

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程