MiniMax Agent多步骤任务必须在控制台创建并启用任务链模式,依次配置Web Scraper、Data Processor、Email Sender三步,通过可视化连线串联,支持重试策略与异常分支,本地测试需用真实API密钥调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想让MiniMax Agent一次性完成多个关联操作,比如先从网页抓取数据、再整理成表格、最后发邮件通知,而不是每次只做一件事来回切换。
创建多步骤任务的Agent实例
这一步必须在控制台完成,不能跳过或用CLI替代,否则后续步骤无法绑定任务流。
进入Minimax开发者控制台 → 左侧导航栏点击「Agent」→ 点击「创建Agent」→ 模板类型选择「多步骤流程型」。
在基础配置页填写名称(如“日报生成器”)和描述(如“自动抓取→清洗→邮件发送”),【务必勾选“启用任务链模式”】,否则所有步骤将被当作独立单次调用处理。
点击「保存并进入编辑页」,此时页面顶部会显示「任务链编辑器」入口,这是唯一能定义步骤顺序的地方。
在任务链编辑器中添加并连接步骤
任务链编辑器采用可视化拖拽+参数填充方式,不支持纯代码导入。每个步骤代表一个可执行动作单元,最多支持12个步骤串联。
第一步:点击「+ 添加步骤」→ 选择工具类型为「Web Scraper」→ 在URL输入框填入目标网页地址(如https://example.com/data)→ 勾选「等待页面加载完成」→ 点击「保存步骤」。
第二步:再次点击「+ 添加步骤」→ 选择工具类型为「Data Processor」→ 在「输入源」下拉菜单中选择上一步的输出(自动显示为“Step_1_Result”)→ 设置格式为“CSV”,字段分隔符选逗号 → 点击「保存步骤」。
第三步:点击「+ 添加步骤」→ 选择工具类型为「Email Sender」→ 在「收件人」字段手动输入邮箱地址(暂不支持变量引用)→ 主题栏填“每日数据简报”→ 正文模板中插入变量{{Step_2_Output}} → 点击「保存步骤」。
完成三步后,将三个步骤节点用鼠标拖拽连线:Step_1 → Step_2 → Step_3。连线方向不可逆,断开重连需先删除原线再新建。
设置失败重试与异常分支
默认情况下任一环节失败整条链终止,但实际业务中你可能希望某些步骤失败后跳过、或重试、或走备用路径。
方法一:在Step_1节点右键 → 选择「编辑重试策略」→ 将「最大重试次数」设为3 → 「重试间隔」设为30秒 → 勾选「仅在网络超时或HTTP 5xx时重试」。
方法二:在Step_2节点右侧点击「+ 添加异常分支」→ 类型选「ParseError」→ 目标步骤选「Email Sender」→ 在正文中填“原始数据格式异常,请人工核查” → 这样当CSV解析失败时,仍会发错警邮件而非静默中断。
【注意:异常分支只能指向已存在的步骤,不能新建】,所以务必先建好备用步骤再配分支。
本地测试多步骤任务
测试必须使用真实API密钥发起HTTP请求,不能依赖控制台内置的模拟按钮——它只验证语法,不触发实际工具调用。
打开终端,执行以下命令(替换your_api_key和agent_id):
curl -X POST https://api.minimax.chat/v1/agent/run \
-H "Authorization: Bearer your_api_key" \
-H "Content-Type: application/json" \
-d '{"agent_id":"your_agent_id","input":{}}'
观察返回JSON中的“execution_log”字段,每步状态会按顺序列出,成功为“completed”,失败为“failed”并附带错误码。
若某步显示“timeout”,说明该步骤未在60秒内完成,需检查工具配置或降低数据量;若返回“missing_input”,说明上一步输出为空,要回溯确认前序步骤是否真的执行了。


















