调整 MiniMax Agent 工作流后,不能只是保存配置就直接上线,还需要重新跑通一遍完整流程,确认校验逻辑已经生效、参数传递准确无误、各节点流转符合预期。如果忽略这一步,上线后很容易因为缓存未清除或状态残留而出现响应异常、跳转错误等问题。实际排查时,还应同步核对版本号是否为最新、确认已完成发布、清理本地与服务端缓存、重置会话状态,并分别通过内置调试器、API 直连以及真实多轮对话三种方式进行重新测试与验证。

修改 MiniMax Agent 工作流后,必须重新触发完整链路,验证逻辑是否真正生效、参数是否正确传递、节点是否按照预期跳转,否则正式上线后可能因缓存或状态残留导致 Agent 行为异常。
确认修改已保存并发布到正确环境
进入 MiniMax 控制台 → 左侧导航栏点击「Agent」→ 选择对应 Agent → 点击「工作流」Tab → 检查右上角显示的版本号是否为最新提交版本(如 v1.3.7),【如果未点击「发布」按钮,所有修改都仍停留在草稿态,测试或调用到的依然是旧版本】。
点击「发布」按钮 → 在弹窗中确认「发布到生产环境」或「发布到测试环境」→ 勾选「强制覆盖当前线上版本」(如需立即生效)→ 点击「确认发布」。
清理本地缓存与服务端缓存
在浏览器中打开开发者工具(F12)→ Application → Clear storage → 勾选「Cache storage」「Service workers」「Cookies」→ 点击「Clear site data」。
这一步非常关键,不能省略:MiniMax SDK 默认启用客户端缓存策略,如果不清理缓存,前端可能仍会加载旧版工作流配置,导致你明明已经修改完成,测试结果却看起来完全没有变化。
同时,在控制台「Agent」→「调试」Tab → 找到「重置会话状态」按钮并执行。该操作会清空当前用户 ID 下的历史会话上下文,避免旧路径判断或历史状态干扰新的工作流逻辑验证。
构造可复现的测试用例并重新执行验证
方法一:使用内置调试器逐节点测试
进入「调试」Tab 后,先输入一条能够明确触发你刚修改节点的初始消息,例如在调整退款意图识别分支后输入“我要退款”,随后点击「发送」。接着查看右侧「执行轨迹」面板,重点核对节点名称、输入参数、输出结果,以及跳转箭头是否已经按照你更新后的连线运行。对于条件判断节点,还要特别检查其「判定值」是否已经切换为新的表达式,例如 intent == "refund",而不是旧的 is_refund: true。
方法二:通过 API 接口直连测试
复制「调试」页底部的 curl 命令 → 在终端执行 → 检查返回 JSON 中的 "next_node_id" 字段是否指向你新配置的目标节点;如果返回 error.code 为 400 且 message 包含 "invalid transition",通常说明某处连接线未保存,或条件表达式存在语法错误。
方法三:模拟真实用户多轮对话场景
① 打开已接入该 Agent 的网页或 App,确保登录的是测试账号(不要使用管理员账号,以免因权限绕过掩盖实际问题);
② 按照预设路径发起首轮提问;
③ 如果涉及槽位填充,务必在第二轮输入完全不符合旧正则但符合新规则的内容(例如原先要求手机号填写 11 位纯数字,你已修改为支持空格或括号格式,那么可以输入“138 1234 5678”);
④ 观察 Bot 回复文案、按钮、跳转页面是否同步更新——如果界面没有变化,大概率是前端资源未刷新,而不一定是 MiniMax Agent 工作流没有生效。
