讲师中心 微信公众号
AI工具推荐 视频效率加速

MiniMax Agent API获取执行结果教程

大墨同学_6229

大墨同学_6229

发布时间:2026-08-14 17:27:59

|

610人浏览过

|

来源于php中文网

原创

必须设置 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 字段非空的条目。

Agent Security Dlp
Agent Security Dlp

Agent Security DLP - 企业级数据防泄漏系统 功能: 入口防护、记忆保护、工具管控、出口过滤、审计日志 规则: 170条,覆盖金融、医疗、汽车、销售、人力资源、物流等25+行业 触发: check-output(对话出口) / check-input(对话入口) / check-tool(工具执...

下载

提取 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 参数

热门AI工具

更多
Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

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

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

3008

2026.03.16

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

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

380

2026.03.17

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

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

169

2026.03.20

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

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

205

2026.03.30

minimax大模型
minimax大模型

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

328

2026.03.31

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

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

538

2026.05.13

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

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

443

2026.05.13

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

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

594

2026.05.13

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

120

2026.09.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn