在 MiniMax Agent 中搭建工作流时，需要先选择“工作流型”模板并启用工作流编辑器，然后依次添加 Input、Tool（如 PDF 解析器）、Model（H3）等节点，并完成字段映射配置。随后通过显式或隐式方式连接数据流，设置终止条件与异常处理分支，最后发布即可完成 MiniMax Agent 工作流搭建。

想要在 MiniMax Agent 中搭建一个可执行、可调试、可复用的自动化工作流，必须提前理清角色分工、工具绑定关系与整体执行路径，尽量避免因权限配置错误或上下文中断而导致任务执行失败。

创建基础Agent并启用工作流模式

进入 MiniMax 控制台的「Agent」模块→点击「创建Agent」→将模板类型选择为「工作流型（Workflow）」，不要误选「对话型」或「多角色剧本型」。【这一步必须选择正确，否则后续无法添加工作流节点和连接线】

填写 Agent 名称（例如“合同审核流水线”）和功能描述，并勾选「启用工作流编辑器」开关。开启后，页面会从普通对话界面切换为可视化工作流编辑画布，更适合进行流程编排。

点击「保存并进入编辑器」，这时你就获得了一个空白工作流画布，后续所有 MiniMax Agent 工作流配置操作都将在这个画布中完成。

添加并配置核心节点

在画布左侧工具栏中，将以下三类关键节点拖拽到画布中：

① 输入节点（Input）：用于接收用户提交的原始请求，例如上传 PDF 合同文件，或直接输入合同条款文本。双击该节点，在「字段定义」中设置必填字段：file（类型为 file）、clause_text（类型为 string）。

② 工具节点（Tool）：点击「+ 添加工具」→在工具列表中选择「PDF解析器」→点击「配置」→在「参数映射」中，将 Input 节点的 file 字段拖入「input_file」输入框。完成这一步后，PDF 文档内容才能被后续模型节点正确读取和处理。

③ 模型节点（Model）：先将 H3 模型节点拖入流程，再双击进入配置页面，在「系统提示词」中明确写入：“你是一名资深法务，仅输出JSON格式结果，包含字段：risk_level（枚举值：high/medium/low）、red_flag_clauses（字符串数组）、suggested_revisions（字符串数组）”。【这条规则不能省略，否则 H3 很可能直接输出自然语言内容，导致结构化结果被打乱】

连接节点并设定执行逻辑

方法一：将鼠标悬停在 Input 节点右侧圆点→按住左键拖拽连线→松开到 PDF 解析器节点左侧圆点。这条连接线表示“原始文件数据流入解析器”。

方法二：PDF 解析器节点输出端通常会自动生成 parsed_text 字段→将该字段拖入 H3 模型节点的「user_input」区域，完成文本数据传递。此时即使不手动连线，系统也会自动建立隐式绑定关系。

注意：如果 H3 节点后续还需要连接「邮件发送」工具，就必须使用显式连线——将 H3 输出的 risk_level 字段拖入邮件工具的「subject_template」，否则邮件主题会为空，影响后续通知效果。

设置终止条件与异常分支

在 H3 模型节点右侧，点击「+ 添加终止条件」→选择「响应字段存在」→字段名填写 risk_level→匹配值留空（表示只要该字段非空，就视为执行成功）。这样设置后，工作流会在模型返回有效 JSON 结果后自动结束。

点击「+ 添加异常分支」→将错误类型选择为「tool_timeout」→目标节点选择「告警通知」→在通知内容中填写：“PDF解析超时，请检查文件是否损坏或过大”。该异常分支会在解析工具卡住 60 秒后自动触发，避免整个流程长期挂起。

最后点击右上角「发布」按钮，MiniMax Agent 工作流就会立即生效。需要注意的是，发布后不能直接编辑节点之间的连接关系，如需修改，必须先「下线」再重新调整。