MiniMax Agent多步骤任务模板保存做法

必须在Minimax开发者控制台创建多步骤任务模板，流程包括：登录平台→进入Agent→模板管理→新建多步骤模板→配置步骤（名称、Agent ID、输入映射、超时）→启用自动状态流转→填写元信息后保存；支持从调试会话导出或JSON批量导入。

你需要把反复使用的多步骤任务流程（比如“生成周报→提取数据→画图表→写总结→发邮件”）固化为可复用的模板，避免每次重写指令、重复配置工具链或手动跳转不同Agent。

在Agent控制台创建并保存多步骤任务模板

该操作必须在Minimax开发者控制台完成，网页对话页或App端无法创建结构化模板。模板一旦保存，可在任意新会话中直接调用，无需重新配置角色、工具或记忆规则。

1、登录 platform.minimaxi.com → 进入左侧导航栏「Agent」→ 点击顶部「模板管理」标签页。

2、点击右上角「新建模板」按钮，选择「多步骤任务型」而非「单轮对话型」。

3、在「流程定义」区域，点击「+ 添加步骤」，依次填入每一步的名称（如“数据清洗”）、执行Agent ID（需提前创建好对应Agent）、输入变量映射（例如上一步输出的raw_data作为本步input_file）、超时阈值（建议设为60秒，防止卡死）。

4、勾选「启用自动状态流转」，系统将根据前一步返回的status: "success"字段自动触发下一步；若某步返回"error"，流程立即终止并记录错误日志。

【必须填写完整所有步骤的Agent ID，否则保存时会报错且无明确提示】

5、填写模板名称（如“销售日报自动化”）、描述（限50字内，用于搜索识别）、可见范围（公开/仅团队/仅自己）→ 点击「保存」。

从已有Agent调试会话一键导出为模板

当你已在调试界面跑通一个复杂多步任务，且各环节响应稳定，可直接将其快照转为模板，省去手动重建流程的麻烦。

方法一：通过调试页右上角导出按钮

1、在Agent列表页找到已发布的Agent → 点击「调试」→ 完整执行一次多步骤任务（确保每步都成功返回）。

2、任务结束后，点击右上角「…」更多菜单 → 选择「导出为模板」。

3、系统自动提取本次会话中所有调用的Agent ID、参数传递路径与条件分支逻辑 → 弹窗要求你补全模板名称和描述 → 确认后即存入「模板管理」。

方法二：用浏览器控制台脚本提取结构

1、保持调试页面打开，按F12打开开发者工具 → 切换到Console标签页。

2、粘贴并执行以下命令：JSON.stringify(window.__DEBUG_SESSION__.flow, null, 2) → 回车。

3、控制台输出一段JSON，包含steps数组、agent_ids、input_mapping等核心字段 → 全选复制。

4、回到「模板管理」→ 「新建模板」→ 切换至「JSON导入」模式 → 粘贴刚复制的内容 → 点击「解析并预览」→ 检查步骤顺序与变量映射无误后保存。

本地编辑模板JSON后批量导入

适合需要批量创建相似模板（如为10个部门分别定制日报流程）或进行版本对比的场景。直接修改JSON比在界面上逐项填写更快，但字段缺失会导致导入失败。

第一步：获取标准模板JSON骨架

1、在「模板管理」中创建一个最简多步骤模板（仅2步），保存后点击该模板右侧「导出」→ 下载得到template_min.json。

第二步：按需求扩展steps数组

2、用VS Code打开该文件，在"steps"数组里追加对象，每个对象必须含name、agent_id、input_mapping（键为本步参数名，值为上一步输出字段名，如"data": "step_1.output"）。

3、确保所有agent_id真实存在且已发布，input_mapping中引用的字段名与上游Agent返回的JSON key完全一致（区分大小写）。

第三步：上传导入

4、回到「模板管理」→ 点击「批量导入」→ 拖入编辑好的JSON文件 → 系统校验通过后显示「共导入X个模板」→ 点击确认。