MiniMax Agent工作流节点设置方法

必须正确配置节点契约与逻辑，否则工作流第二步卡死或返回空值；HTTP请求节点需设合法URL、授权头及JSON Body；条件分支节点须用表达式如$.output.status === "success"路由。

要在MiniMax Agent中构建可编排、可复用的自动化工作流，必须正确设置每个节点的输入输出契约、执行逻辑与错误响应路径，否则工作流会在第二步就卡死或返回空值。

配置HTTP请求节点

这是最常用的数据获取节点，适用于调用外部API、查询数据库或触发第三方服务。

第一步：在工作流画布中拖入“HTTP请求”节点，双击打开配置面板。

第二步是填写URL字段，这里支持模板语法，比如https://api.example.com/v1/orders?user_id={{$.input.user_id}}。有一点一定要注意：

。

第三步：在Headers区域添加Authorization: Bearer {{$.secrets.minimax_api_key}}，其中minimax_api_key需提前在工作流“密钥管理”中录入并加密存储。

第四步：Body类型选择JSON，内容填入{"order_id": "{{$.input.order_id}}", "status": "pending"}；若留空或格式非法，节点将直接返回400错误且不重试。

设置条件分支节点

当工作流需要根据上一节点返回值决定走向时，必须用此节点做路由判断，不能靠人工写if-else逻辑硬编码。

方法一：使用表达式模式。在“判断条件”栏输入$.output.status === "success"，左侧为JS路径表达式，右侧为字面量值，支持===、!==、>、<等运算符，但

。

方法二：使用枚举匹配。点击“添加分支”，在“匹配值”中填paid，对应节点连接“支付成功”子流程；再添加一条匹配failed，连向“通知财务”节点。这种方式更安全，适合已知有限状态集。

注入MMX-CLI命令行节点

该节点专用于调用MiniMax最新命令行工具，实现语音合成、视频生成等多模态任务，是打通全链路的关键枢纽。

在节点配置中，命令行输入框填入：mmx-cli tts --text "{{$.input.script}}" --voice zh-CN-XiaoYi --output /tmp/audio.mp3 --quiet --output json。

关键参数说明：--quiet关闭进度条和颜色字符，--output json确保stdout只输出纯JSON结果（含{"file_path":"/tmp/audio.mp3"}），避免Agent解析失败。

必须勾选“启用异步执行”，否则长音频合成会阻塞整个工作流；未勾选时，超时默认为30秒，一旦TTS耗时超过该值，节点直接退出且返回状态码137。

配置Webhook回调节点

用于将工作流结果主动推送至外部系统，比如飞书群、企业微信或自建CRM，适合需要实时通知的场景。

输入目标URL，例如https://open.feishu.cn/open-apis/bot/v2/hook/xxx，注意末尾不能带斜杠，否则飞书服务器会返回404。

Body内容设为JSON格式，包含{"msg_type":"text","content":{"text":"订单{{$.input.order_id}}已发货，请查收。"}}；若使用form-data或raw text，飞书将拒绝接收。

设置“失败重试”为3次，间隔采用指数退避：第一次1秒后重试，第二次3秒，第三次9秒；超过3次仍失败则进入死信队列，由运维人员手动干预。