发布、协作与运行

工作流草稿只供编辑和调试；智能体、应用、子流程、任务和 API 通常使用已发布版本。发布是一次对外契约变更，应在试运行、版本说明、引用检查和真实调用方验证完成后进行。

自动保存、提交与发布

状态	保存内容	是否更新调用方	主要用途
自动保存	当前编辑者的草稿	否	防止画布编辑丢失
提交	可被历史或协作流程引用的提交记录	否	多人协作、评审、形成候选版本
发布	可供调用方使用的稳定版本	是	正式上线和版本追踪

顶部显示“已自动保存”时，只能确认草稿已经写入。页面显示“有尚未发布的修改”时，调用方仍可能执行旧的已发布版本。

发布前校验

点击 发布 后填写发布版本和版本描述。系统发现当前草稿尚未试运行时会提示风险，可以返回试运行，也可以继续发布；正式流程不建议跳过验证。

图 1：当前发布前校验窗口。截图仅用于说明，演示流程未执行发布。

版本填写建议

• 使用团队统一的版本规则，例如 v1.2.0，不要长期沿用无含义的默认值。
• 版本描述写清开始/结束契约、节点、模型、提示词和依赖资源的变化。
• 破坏兼容的必填字段、字段删除或类型变化应单独标明，并通知所有调用方。
• 修复问题时说明触发条件和验证输入，便于以后回溯。

发布检查清单

1. 自动保存完成，当前草稿就是本次准备发布的内容。
2. 问题面板没有未处理错误。
3. 成功路径、异常路径和边界输入均已试运行。
4. 开始和结束节点契约稳定，外部依赖状态正常。
5. 查看引用关系，确认调用方能够兼容本次变化。
6. 填写可追溯的版本号和版本描述。
7. 发布后从一个真实调用方执行端到端验证。

历史版本与恢复

点击顶部 历史，可以筛选提交或发布记录，查看当前草稿与历史版本之间的关系。

图 2：历史版本面板。不同历史类型支持的操作不同，界面禁用的“导出”不应被当作可用能力。

常用操作包括：

• 查看版本：只读检查节点和配置，不改变当前草稿。
• 加载到草稿：将历史定义作为当前编辑基础；不会立即覆盖线上发布版本。
• 导出：只在该历史类型和当前权限支持时可用。

加载历史版本后仍要重新检查当前环境中的模型、插件、数据库、授权和调用方契约，完成试运行并再次发布。历史回退不能恢复已经变化的外部数据、服务配置或凭据。

流程级操作

资源列表的操作菜单集中提供编辑、类型切换、复制、跨空间复制、导出和删除。

图 3：普通工作流的资源操作。操作是否可用取决于资源归属、发布状态、当前空间和账号权限。

类型切换

普通工作流可以切换为对话流；对话流在支持的状态下也可以切换回普通工作流。切换只改变流程形态，不会自动完成以下工作：

• 补齐或移除角色、会话历史和消息节点。
• 修改开始节点、结束节点和调用方契约。
• 将一次性试运行自动转换为多轮对话调试。
• 修复已发布调用方对旧类型的依赖。

切换前先复制备份，切换后重新检查所有节点、执行完整调试并发布新版本。

复制与跨空间迁移

复制主要迁移流程定义。目标空间还需要重新确认：

1. 模型、插件工具和子工作流是否存在且已发布。
2. 知识库、数据库、记忆库和卡片是否可用。
3. OAuth、Token、用户授权和私网连接是否需要重配。
4. 测试数据、线上数据、会话和记忆是否符合目标空间隔离规则。
5. 定时、批量或异步任务是否仍指向正确流程版本。

导出

导出包适合备份、审查和迁移，不应作为唯一版本管理方式。导出后妥善保存，不要将包含敏感配置的文件发送到不受控渠道。导入目标空间后必须重新绑定依赖并试运行。

删除

删除前先查看引用关系，确认以下调用方均已迁移或停用：

• 智能体与低代码应用。
• 父工作流和对话流。
• 定时触发器、批量任务和异步任务。
• 外部 API 调用方。

页面没有明确恢复入口时，应把删除视为不可直接撤销的操作。必要时先导出可用版本并记录依赖清单。

引用关系

顶部 查看引用关系 用于识别哪些资源或项目正在使用当前流程。修改以下内容前必须检查引用：

• 开始节点新增必填字段或修改字段类型。
• 结束节点删除、改名或改变返回结构。
• 普通工作流与对话流互相切换。
• 删除或替换插件、模型、数据库和子流程。
• 删除流程或停用已发布版本。

引用关系只能说明平台内已记录的依赖；外部系统通过 API 调用时，还需要结合接口登记和运行日志确认。

多人协作

• 协作前明确负责人、编辑范围和发布人。
• 将修改按节点或能力拆分，避免多人同时覆盖同一区域。
• 提交候选版本后由另一位维护者复核输入输出契约和高风险节点。
• 拉取或加载他人版本后重新试运行，不要仅凭提交说明判断可发布。
• 关闭协作前处理未提交草稿，避免协作者修改丢失。

只读成员可以查看流程和历史，但不能修改节点。需要编辑时由资源负责人授予协作或空间权限，不应通过复制敏感配置绕过权限。

运行方式与任务中心

已发布流程可以通过以下入口运行：

入口	适用场景	需要关注
智能体	根据用户意图调用工具流程	描述、输入映射、用户授权、返回文本
低代码应用	页面操作或业务事件触发	应用状态、错误提示、重复提交
子工作流	在其他流程中复用能力	发布版本、契约兼容、超时传播
定时触发	按计划执行	时区、重复执行、失败告警
批量任务	对多组数据执行相同流程	数据格式、并发、部分失败、结果汇总
异步任务	运行长耗时流程	任务标识、状态查询、取消和最终结果
外部 API	由获得授权的系统调用	鉴权、限流、幂等、版本与审计

任务中心负责查看任务状态和结果，不负责修改流程定义。发现节点问题时返回资源库编辑器修复草稿、试运行并发布新版本。

• 详细创建步骤参见批量执行工作流。
• 详细配置与结果查看参见异步执行工作流。

上线后观察

• 检查成功率、耗时、失败节点和外部依赖错误。
• 区分流程触发成功、异步任务完成和最终业务成功。
• 对超时与限流设置有上限的重试，不进行无限重试。
• 日志中不记录密钥、完整鉴权头或未脱敏用户数据。
• 发现回归时先保存证据，再决定加载历史版本还是修复当前草稿。

常见问题

自动保存后调用方为什么仍是旧结果

自动保存的是草稿，调用方通常仍绑定已发布版本。完成试运行和发布后，再检查调用方引用的流程与版本。

加载历史版本后线上为什么没有变化

“加载到草稿”只改变编辑基础，不会立即覆盖线上版本。重新校验、试运行并发布后才会更新调用方。

复制到其他空间后为什么失败

流程定义已复制，但依赖资源、凭据和数据隔离配置没有全部迁移。按节点逐项重新选择，并从最小输入开始验证。

更多问题参见工作流资源总览。