必须使用“工作流入口型”agent作为起点并启用触发器,通过可视化连线或jsonpath路由规则串联多节点,配置字段映射确保数据传递合规,关键环节插入人工审核闸口,最后用api触发并监控执行状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要在MiniMax Agent平台中把多个智能体串联起来,形成可自动流转、条件触发、结果反馈的完整工作流,而不是每次手动调用单个Agent。
创建首个工作流节点:定义入口Agent
工作流必须从一个明确的入口开始,这个Agent将接收原始输入并决定后续走向。它不能是通用对话型,必须启用“工作流触发器”开关。
进入Minimax控制台→Agent模块→点击“创建Agent”→选择模板类型为“工作流入口型”。【该模板自带input_schema字段校验与output_routing能力,普通对话型模板无法作为工作流起点】
在系统提示词中写明:“你只负责解析用户输入中的任务类型、关键参数(如时间范围、目标文档路径、参与角色名单),不执行具体操作,仅输出JSON格式路由指令。”
保存并发布后,复制该Agent的ID——这是整个工作流的唯一根ID,后续所有节点都需引用它。
配置多节点串联逻辑
工作流不是线性管道,而是带分支判断的有向图。你必须在每个节点上显式声明“下一步去哪”,否则流程会在该节点终止。
方法一:使用控制台可视化连线
在Agent列表页找到刚创建的入口Agent→点击右侧“编辑工作流”→拖拽新增节点(如“PDF解析Agent”“数据清洗Agent”“报告生成Agent”)→用鼠标连线表示执行流向→在线上双击添加条件标签,例如“当input.file_type == 'pdf'时→PDF解析Agent”。
方法二:通过JSON Schema硬编码路由规则
在入口Agent的高级配置中开启“自定义路由模式”,粘贴如下结构:
{"routes":[{"condition":"$.input.task == 'audit'","target_agent_id":"agnt_xxx_audit_v2"},{"condition":"$.input.task == 'summary'","target_agent_id":"agnt_yyy_summary_v3"}]}
【condition字段必须符合JSONPath语法,且target_agent_id必须已存在并处于已发布状态,否则工作流启动即报错】
设置节点间数据传递规则
默认情况下,前一个Agent的完整输出会原样传给下一个Agent的input字段。但多数场景需要裁剪或重组。
第一步:在上游Agent的“输出后处理”区域勾选“启用字段映射”
第二步:填写映射关系,例如:
source_path: $.result.cleaned_data
target_key: data_for_analysis
第三步:点击“添加映射”,重复操作可建立多对一或一对多关系
注意:若下游Agent的input_schema定义了必填字段(如required: ["data_for_analysis"]),而上游未提供该键,则流程中断且无错误提示——只会静默失败。务必在调试阶段用Web UI逐节点验证输出结构。
启用人工干预闸口
某些高风险环节(如合同条款修改、资金审批、对外发布内容)必须插入人工确认步骤,不能全自动流转。
① 新建一个Agent,模板选“人工审核型”
② 在其系统提示词中写:“等待用户点击‘批准’或‘拒绝’按钮,不主动输出任何文本,仅返回{“status”: “pending”}”
③ 将该Agent接入工作流,在连线旁点击“+添加拦截点”→选择“强制人工介入”→设定超时时间为1440分钟(24小时)
④ 配置通知方式:勾选“飞书机器人推送”,填入群ID与消息模板:“【待审】流程ID {workflow_id} 卡在审核节点,请前往控制台处理”
这一步操作起来很简单,直接把飞书群ID粘进去就行。
部署并触发工作流
工作流本身不产生ID,它的身份由入口Agent ID + 版本号共同标识。发布即生效,无需额外部署动作。
打开终端,构造HTTP POST请求:
URL: https://api.minimax.chat/v1/workflow/trigger
Header: Authorization: Bearer sk-xxx(你的API密钥), Content-Type: application/json
Body: {"agent_id": "agnt_root_abc123", "version": "v1", "input": {"task": "audit", "file_path": "/reports/Q2_2026.pdf"}}
发送请求后,立即在控制台“工作流运行记录”页查看实时日志。绿色节点表示成功执行,红色节点表示中断,黄色节点表示等待人工操作。











