扣子工作流发布上线与版本管理实用指南

在扣子（Coze）内真正用活工作流，核心只有一件事：完成发布动作，并建立一套可追溯、可切换的版本管理体系。否则，所有调试成果始终停留在画布层面，既无法被智能体调度，也无法对外提供API服务。

发布工作流：从画布到可调用服务

操作极为直接：点击画布右上角的【发布】按钮，系统会自动执行校验。它会逐一检查每个节点的连接完整性，以及必填参数是否已配置。校验通过后弹出确认框。若勾选“立即生效”，当前版本会被直接标记为active。发布成功后，右上角出现绿色徽章，附带版本号（例如v1.3）。同时系统生成唯一的workflow_id，这就是后续API调用或在工作流节点中嵌套引用的通行凭证。

该步骤不可逆——【发布后原草稿状态消失，未保存的修改将永久丢失】。一个常见陷阱：画布右上角显示“已发布”，但右侧配置面板提示“未保存”，这通常意味着你正在编辑一个尚未提交的新版本。此时必须再次点击发布，才能覆盖线上正在运行的版本。

发布完成后，返回资源库的工作流列表页，该卡片右上角出现“已发布”标签。点击卡片进入详情页，可查看更细粒度的信息，包括调用方式、历史版本、使用统计等。

查看与对比历史版本

在工作流详情页顶部导航栏，点击「历史版本」即可展开一份完整的版本快照列表。每条记录清晰标注版本号、发布时间、操作人及变更摘要。例如会显示“新增知识库节点”或“修改LLM温度值”，一目了然。

如需比对两个版本的具体差异，只需点击任意历史版本右侧的「对比」按钮。系统会高亮显示与当前active版本的差异——节点是新增还是删除？连线是否变动？参数值有没有改动？比如prompt字段从“请简洁回答”改为“请用三句话分点作答”，这些变化都会以红色和绿色色块直观呈现。

需特别注意：只有状态为archived的版本才支持回滚。状态为failed或draft的版本，无法作为目标版本触发回滚流程。

回滚到指定历史版本

若确实需要回滚，操作分三步：

第一步：进入目标工作流详情页，点击「历史版本」，找到你希望恢复的archived版本（例如v1.1），点击其右侧的「回滚」按钮。

第二步：系统弹出确认弹窗，显示变更预览。此时务必仔细核对，重点确认是否包含了你预期恢复的配置项——比如旧版插件参数、原始的条件分支逻辑等。确认无误后，点击「确定回滚」。系统将基于该版本快照生成一个新版本（例如v1.4），并自动将其设为active。

第三步：回滚完成后，页面自动跳转至新版本详情页。右上角版本号已更新为v1.4，在「历史版本」列表中也能看到该新条目，旁边标注“由 v1.1 回滚生成”。原v1.3版本不会被删除，它依然保留在历史记录中供后续参考。关键一点：该回滚操作不会影响正在运行中的任务实例。已触发但尚未结束的流程，仍按原版本继续执行。只有新触发的请求才会走回滚后的新逻辑。