这里有一个关键前提不能搞错：必须以开发者文档中的「Workflow Definition Format」为唯一依据，先准确提取 name、description、steps、version 这 4 个必填字段，再按照 JSON 格式组装为一个最小可运行的工作流模板。尤其是 steps 这个数组，必须严格遵循执行顺序依次填写，并针对 tool_call、http_request 等不同 type 补齐对应合法的 step 对象配置。

你需要将 MiniMax Agent 文档内容自动整理成结构清晰、便于复用的工作流配置说明，而不是靠手动逐条抄录或截图保存。这样更适合后续进行 workflow 配置、模板复用和批量生成。

确认文档来源与格式类型

打开 MiniMax Agent 最新官方文档页面（https://docs.minimaxi.com），在左侧导航栏中找到「Agent 工作流」或「Workflow Configuration」模块。要特别注意区分「开发者文档」与「用户指南」——前者包含 JSON Schema、API 字段说明和工作流配置格式，后者通常只有界面截图与按钮位置说明，【必须选择开发者文档】，否则后续无法正确提取可执行字段和合法配置结构。

继续向下滚动页面，定位到「Workflow Definition Format」这一小节即可。这里通常会清楚列出必填项，例如 name、description、steps；也会标注可选项，例如 timeout、retry_policy；同时还会说明每个字段的类型限制，比如 string / object / array，便于你后续准确构建 MiniMax Agent 工作流 JSON 配置。

提取核心字段并映射为配置模板

方法一：直接复制最新 JSON 示例并精简冗余内容

找到文档中带有「Example」标签的完整 workflow 定义代码块，直接全选并复制。粘贴到本地编辑器后，删除所有注释行（如以 // 或 /* 开头的内容）以及示例值（例如 "your_app_id_here"），只保留字段名和空值占位符，例如 "name": ""、"steps": []。这种方式适合快速生成 MiniMax Agent 工作流模板。

方法二：按字段分类手动生成最小可用模板

新建一个空白 JSON 文件，依次填入以下 4 个强制字段：

"name": "必填，字符串，长度 ≤64，不能包含空格或特殊符号"

"description": "必填，字符串，建议使用中文清晰说明工作流用途"

"steps": [] —— 这是工作流的核心主体，使用数组形式，每一项都是一个 step 对象

"version": "1.0" —— 当前稳定版号，开发者文档明确要求必须显式声明

填充 steps 数组：三类典型 step 配置写法

第一步：确定 step 类型

查阅文档中的「Step Types」章节，识别你实际需要使用的 type。常见类型包括：tool_call（调用内置工具）、http_request（发送 HTTP 请求）、conditional（条件分支判断）。每种 type 都对应不同的 required 字段，如果缺少必填项，通常会直接导致 workflow 创建失败或配置校验不通过。

第二步：构造单个 step 对象

以 tool_call 为例：{ "type": "tool_call", "tool_name": "file_read", "input": { "path": "/downloads/report.pdf" } }。需要注意，input 必须是合法的 JSON 对象，路径必须使用双引号包裹，且 【路径必须为绝对路径，相对路径通常会被忽略】。

第三步：按执行顺序排列 steps

将多个 step 按业务逻辑顺序依次放入 steps 数组中，顺序不能打乱。例如先 file_read → 再 text_extract → 最后通过 http_request 发送处理结果。数组索引本身就是执行序号，因此无需额外添加序号字段。这也是编写 MiniMax Agent 工作流配置时最容易被忽略但非常关键的一点。