MiniMax Agent工作流搭建方法

在MiniMax Agent中搭建工作流需选“工作流型”模板、启用编辑器，依次添加Input、Tool（如PDF解析器）、Model（H3）节点并正确映射字段，显式或隐式连接数据流，配置终止条件与异常分支后发布。

在MiniMax Agent中搭建可执行、可调试、可复用的工作流，需明确角色分工、工具绑定与执行路径，避免因权限错配或上下文截断导致任务中断。

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

进入MiniMax控制台「Agent」模块→点击「创建Agent」→选择模板类型为「工作流型（Workflow）」而非「对话型」或「多角色剧本型」。

填写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（字符串数组）”。

连接节点并设定执行逻辑

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

方法二：PDF解析器节点输出端默认生成parsed_text字段→将该字段拖入H3模型节点的「user_input」区域，完成数据传递。此时无需手动连线，系统自动建立隐式绑定。

注意：若H3节点后还需接「邮件发送」工具，则必须显式连线——将H3输出的risk_level字段拖入邮件工具的「subject_template」，否则邮件标题将为空。

设置终止条件与异常分支

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

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

最后点击右上角「发布」按钮，工作流即刻生效。发布后不可直接编辑节点连接关系，需先「下线」再修改。