要顺利在 MiniMax Agent 平台搭建工作流,必须先创建项目并进入对应的项目空间,再启用 Agent 模块;随后创建并发布对话型 Agent 获取专属 ID;接着使用该 ID 搭建多节点串联工作流;最后配置 HTTP Webhook 触发方式并完成测试。

如果你想在 MiniMax Agent 平台快速搭建一个可以自动执行多步骤任务的智能工作流,却总卡在初始配置阶段,比如找不到功能入口、分不清各个模块、或者第一个节点始终调试不通——通常说明你还没有理清 MiniMax Agent 工作流的创建流程,以及几个必须开启的关键设置。
创建工作流项目并启用Agent模块
进入 MiniMax 开发者控制台后,第一步必须先创建项目,只有这样才能看到 Agent 相关功能;否则页面中的配置按钮通常会处于灰色不可点击状态。
访问 https://platform.minimax.io → 登录账号 → 点击右上角“新建项目” → 填写项目名称(如“售后工单处理流”)→ 描述可留空 → 点击确认。
项目创建完成后,左侧导航栏才会显示“Agent”选项。如果你没有看到该入口,说明当前还停留在未选中项目的全局视图中,【必须点击刚创建的项目名称进入其专属空间】,否则后续的 Agent 配置与工作流设置都无法正常保存。
添加首个工作流节点:从对话型Agent起步
MiniMax Agent 工作流并不是直接在画布上随意拖拽生成的,它必须先有一个可运行的 Agent 实例作为起点。也就是说,不能跳过“创建基础 Agent”这一步直接搭建流程节点。
在 Agent 模块中 → 点击“创建Agent” → 模板类型选择“通用对话型” → 命名(如“初筛客服”)→ 系统提示词填写:“你负责识别用户问题是否属于退换货范畴,只回答是或否,不解释原因。” → 点击“保存并发布”。
发布完成后,页面顶部会显示一串以“ag-”开头的 Agent ID。这个 ID 就是后续工作流中第一个节点的唯一标识,【务必复制保存,刷新页面后无法再查看】。
构建三节点串联工作流
真正的自动化工作流,核心在于多个 Agent 按照既定顺序协同执行。下面以最基础的路径为例,完成“用户提问→分类→转人工”的三级处理流程。
- 返回 Agent 列表页 → 找到刚刚发布的“初筛客服” → 点击右侧“编辑工作流”按钮(图标为流程图)。
- 在画布空白区域双击 → 弹出节点选择框 → 选择“Agent调用” → 在“Agent ID”栏粘贴上一步复制的 ID → 点击确定。
- 在该节点右侧空白位置再次双击 → 同样选择“Agent调用” → 这次填入另一个已发布的 Agent ID(如“人工坐席分配器”,需提前创建)→ 点击确定。
- 将鼠标悬停在第一个节点右下角的蓝色小圆点上 → 按住并拖动到第二个节点左上角的接收点 → 松开完成连线。
- 同样的方法,再添加第三个节点(如“满意度回访机器人”),并连接好第二→第三条流程线。
完成节点连线后,点击右上角“部署工作流”。系统会自动校验所有节点 ID 是否有效;如果某个 ID 不存在或对应 Agent 尚未发布,部署按钮就会置灰,并提示“节点引用无效”。
配置触发条件与测试入口
工作流不会自动运行,必须先明确设置它在什么条件下被触发执行。
在工作流编辑页 → 点击顶部“触发设置”标签 → 触发方式选择“HTTP Webhook” → 点击“生成Webhook地址” → 复制弹出的 URL(包含密钥参数)。
打开 Postman 或使用 curl,向这个 URL 发起一个 POST 请求,请求体采用 JSON 格式:{"user_id":"U123456","message":"我要退货"}。只要在返回结果中看到 status: "success",就说明该 MiniMax Agent 工作流已经成功接收请求,并开始执行第一个节点。
需要注意的是,Webhook 地址中的密钥参数有效期为 24 小时,过期后需要重新生成。如果你希望长期稳定调用,建议在“安全设置”中启用固定 Token 模式。
