如何管理 sim 工作流的已发布版本并用 Promote to live 回滚到旧版本【免费下载链接】simSim is the collaborative workspace to build, deploy, and monitor AI agents and workflows. Used by 100,000 builders.项目地址: https://gitcode.com/GitHub_Trending/sim16/sim在 Sim 中工作流在画布上编辑时只是草稿只有点击Deploy发布后外部调用者才能通过 REST 端点、聊天页或 MCP 工具运行它。发布后你会遇到两个典型问题一是需要知道当前线上跑的是哪个版本、历次发布分别改了什么二是新版发布后出了问题需要立刻恢复上一个已知正常的版本。这篇文章基于 Sim 项目文档说明如何用 Deploy 弹窗的 Versions 表管理这些已发布版本并用Promote to live以及对应的 API 端点完成回滚。适用对象是已部署或即将部署 API 的工作流操作在 Sim 工作区中完成。先理解版本模型快照、版本、Live 版本管理版本之前需要知道三个概念它们决定了后续操作的判断依据来源deployment 概述Snapshot快照部署那一刻对当前草稿的不可变副本。此后在画布上编辑只改草稿不改快照所有调用都针对快照运行。Version版本每次 Deploy 或 Update 都会产生一个带编号的版本v1、v2……记录在 Versions 表中标注了部署人和时间。同一时间只有一个版本是 live用绿色圆点标记其余版本保留着可以重命名、加描述、加载回画布或提升为 live。Live version当前线上版本General 标签页以Live Workflow只读小地图展示它精确对应调用者正在运行的快照。两条关键规则后文的验证都依赖它们编辑画布永远不会改变线上内容。线上快照只在Update发布新版本或Promote to live恢复旧版本时被切换。Promote to live复用的是已有快照不会创建新版本。在 Deploy 弹窗中发布并管理版本打开你的工作流点击Deploy弹窗首先打开General标签来源API deployment。General 标签包含三部分Live Workflow— 当前已部署快照的只读小地图Versions— 所有已发布版本的表格显示版本号、部署人、时间Deploy / Update / Undeploy— 右下角的操作按钮。首次发布点Deploy之后在画布上改完内容工具栏会出现Update deployment徽标提示线上版本落后于草稿。此时点Update会打一个新快照、记录为下一个版本并使其 live不需要重新打开 Deploy 弹窗——也可以直接从画布工具栏点Update完成。发布完成后对任一历史版本的管理入口是版本行右侧的上下文菜单⋮共四个选项操作作用Rename给版本起一个可读名称例如 Added memoryAdd description附上说明该版本改了什么Promote to live不重新部署直接把这个旧版本设为当前激活版本Load deployment把该版本的工作流快照加载回你的画布养成给每个版本加 Rename 或 Add description 的习惯回滚时才能一眼认出哪个是已知正常版本。用 Promote to live 回滚到旧版本回滚操作只有一步在 General 标签的 Versions 表中找到要恢复的那个版本绿色圆点当前标记的是 live 版本点击该行 ⋮ 菜单中的Promote to live来源API deployment、quick reference 中 Revert deployment 条目。这个操作的效果文档定义得很明确被提升的旧版本立即成为 live 版本后续 API 调用立即针对该快照运行文档 FAQ 原文Subsequent API calls immediately run against the promoted snapshot. This is the fastest way to roll back to a previous state.不创建新版本版本表总行数不变画布上的草稿不受影响你可以之后修复草稿再Update发布。推荐的完整工作路径是把线上版本当生产环境、画布当 staging在画布上跑通后再Deploy或Update调用者在新版上线前一直打到旧快照不存在半部署状态新版出问题就Promote to live旧版本之后再修草稿、重新 Update。可选路径通过 API 或 Deployments block 做版本管理如果你需要把部署和回滚放进 CI/CD、事故脚本或另一个工作流里Sim 提供两条编程路径。v1 管理端点来源API deployment 的 Managing Deployments via the API。三个端点都要求 API key 具有该工作流工作区的 admin 权限{workflow-id}替换为你的工作流 ID$SIM_API_KEY替换为你的 API key在Settings → Sim Keys中生成# 把当前草稿发布为新版本body 可选 curl -X POST https://sim.ai/api/v1/workflows/{workflow-id}/deploy \ -H Content-Type: application/json \ -H x-api-key: $SIM_API_KEY \ -d { name: Release 4, description: Fixes the agent prompt } # 下线工作流 curl -X DELETE https://sim.ai/api/v1/workflows/{workflow-id}/deploy \ -H x-api-key: $SIM_API_KEY # 回滚到上一个版本或传 { version: N } 指定某个版本 curl -X POST https://sim.ai/api/v1/workflows/{workflow-id}/rollback \ -H x-api-key: $SIM_API_KEYrollback 端点重新激活一个已有的部署版本——与 Promote to live 是同一操作同样不动画布草稿。Deployments block来源Deployments 集成文档让你在另一个工作流中由 agent 以 block 形式执行版本管理同样要求工作区 admin 权限Promote Version to Live输入workflowId和version要提升的版本号输出包含version当前 live 的版本和isDeployed。它和弹窗里的 Promote to live 是同一操作对已下线undeployed的工作流也有效——会按该版本重新上线。List Deployment Versions输入workflowId输出按新到旧排列的版本数组每项含version、name、description、isActive、createdAt、deployedByName用isActive判断哪个版本 live。Get Deployment Version输入workflowId和version返回该版本元数据含isActive和deployedState——完整的工作流状态快照blocks、edges、loops、parallels、variables。如何验证回滚生效文档给出三种确认方式按使用成本从低到高Versions 表Promote 后回到 General 标签绿色圆点应该移到被你提升的那个版本上Live Workflow小地图也变为该版本的只读快照。实际调用一次 API部署后工作流在 execute 端点响应请求x-api-key头传 API key请求体对象匹配工作流的 Input Format响应包含各 block 的输出和执行元数据curl -X POST https://sim.ai/api/v2/workflows/{workflow-id}/execute \ -H Content-Type: application/json \ -H x-api-key: $SIM_API_KEY \ -d { input: { message: Hello } }注意两处细节文档各页对该路径写法不一致——专门的 API deployment 文档 使用带/v2的路径https://sim.ai/api/v2/workflows/{workflow-id}/execute而 deployment 概述 的示例写的是不带/v2的https://sim.ai/api/workflows/{workflow-id}/execute请以 API 文档中的 v2 形式为准。请求 body 里的{ input: ... }需要替换为你的工作流实际定义的输入格式。查日志确认某次运行用的是哪个快照Logs debugging 文档 说明日志记录每次运行点击View Snapshot会打开该次运行发生时工作流的冻结副本。如果你上周的失败运行与现在画布上的版本不同快照展示的正是当时实际运行的版本而不是今天的版本。边界与限制Promote to live 不创建版本它只是切换哪个已有快照处于 live 状态所以回滚本身不会污染版本历史反过来你也不能用 Promote 发布一个从未部署过的内容。画布编辑与线上解耦只要不点 Update 或 Promote线上快照就不变草稿改坏了也不会影响调用者。权限v1 管理端点和 Deployments block 的所有动作都要求工作区 admin 权限没有 admin 权限的 key 无法执行部署、回滚或查询版本。Undeploy 的副作用下线工作流会同时移除其 triggers、webhooks 和 schedulesAPI 执行停止之后用 Promote 可以按某个已知版本重新上线。异步模式async: true始终针对已部署版本运行不支持草稿状态——这也是回滚对异步调用方立即生效的原因。完成一次 Promote 后以 Versions 表绿点位置和一次真实 API 调用的结果作为最终确认如果需要继续排查某个具体版本的运行细节从对应日志条目的View Snapshot进入即可。【免费下载链接】simSim is the collaborative workspace to build, deploy, and monitor AI agents and workflows. Used by 100,000 builders.项目地址: https://gitcode.com/GitHub_Trending/sim16/sim创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/12 4:06:03 · 阅读 1.2k 如何管理 sim 工作流的已发布版本并用 Promote to live 回滚到旧版本
如何管理 sim 工作流的已发布版本并用 Promote to live 回滚到旧版本【免费下载链接】simSim is the collaborative workspace to build, deploy, and monitor AI agents and workflows. Used by 100,000 builders.项目地址: https://gitcode.com/GitHub_Trending/sim16/sim在 Sim 中工作流在画布上编辑时只是草稿只有点击Deploy发布后外部调用者才能通过 REST 端点、聊天页或 MCP 工具运行它。发布后你会遇到两个典型问题一是需要知道当前线上跑的是哪个版本、历次发布分别改了什么二是新版发布后出了问题需要立刻恢复上一个已知正常的版本。这篇文章基于 Sim 项目文档说明如何用 Deploy 弹窗的 Versions 表管理这些已发布版本并用Promote to live以及对应的 API 端点完成回滚。适用对象是已部署或即将部署 API 的工作流操作在 Sim 工作区中完成。先理解版本模型快照、版本、Live 版本管理版本之前需要知道三个概念它们决定了后续操作的判断依据来源deployment 概述Snapshot快照部署那一刻对当前草稿的不可变副本。此后在画布上编辑只改草稿不改快照所有调用都针对快照运行。Version版本每次 Deploy 或 Update 都会产生一个带编号的版本v1、v2……记录在 Versions 表中标注了部署人和时间。同一时间只有一个版本是 live用绿色圆点标记其余版本保留着可以重命名、加描述、加载回画布或提升为 live。Live version当前线上版本General 标签页以Live Workflow只读小地图展示它精确对应调用者正在运行的快照。两条关键规则后文的验证都依赖它们编辑画布永远不会改变线上内容。线上快照只在Update发布新版本或Promote to live恢复旧版本时被切换。Promote to live复用的是已有快照不会创建新版本。在 Deploy 弹窗中发布并管理版本打开你的工作流点击Deploy弹窗首先打开General标签来源API deployment。General 标签包含三部分Live Workflow— 当前已部署快照的只读小地图Versions— 所有已发布版本的表格显示版本号、部署人、时间Deploy / Update / Undeploy— 右下角的操作按钮。首次发布点Deploy之后在画布上改完内容工具栏会出现Update deployment徽标提示线上版本落后于草稿。此时点Update会打一个新快照、记录为下一个版本并使其 live不需要重新打开 Deploy 弹窗——也可以直接从画布工具栏点Update完成。发布完成后对任一历史版本的管理入口是版本行右侧的上下文菜单⋮共四个选项操作作用Rename给版本起一个可读名称例如 Added memoryAdd description附上说明该版本改了什么Promote to live不重新部署直接把这个旧版本设为当前激活版本Load deployment把该版本的工作流快照加载回你的画布养成给每个版本加 Rename 或 Add description 的习惯回滚时才能一眼认出哪个是已知正常版本。用 Promote to live 回滚到旧版本回滚操作只有一步在 General 标签的 Versions 表中找到要恢复的那个版本绿色圆点当前标记的是 live 版本点击该行 ⋮ 菜单中的Promote to live来源API deployment、quick reference 中 Revert deployment 条目。这个操作的效果文档定义得很明确被提升的旧版本立即成为 live 版本后续 API 调用立即针对该快照运行文档 FAQ 原文Subsequent API calls immediately run against the promoted snapshot. This is the fastest way to roll back to a previous state.不创建新版本版本表总行数不变画布上的草稿不受影响你可以之后修复草稿再Update发布。推荐的完整工作路径是把线上版本当生产环境、画布当 staging在画布上跑通后再Deploy或Update调用者在新版上线前一直打到旧快照不存在半部署状态新版出问题就Promote to live旧版本之后再修草稿、重新 Update。可选路径通过 API 或 Deployments block 做版本管理如果你需要把部署和回滚放进 CI/CD、事故脚本或另一个工作流里Sim 提供两条编程路径。v1 管理端点来源API deployment 的 Managing Deployments via the API。三个端点都要求 API key 具有该工作流工作区的 admin 权限{workflow-id}替换为你的工作流 ID$SIM_API_KEY替换为你的 API key在Settings → Sim Keys中生成# 把当前草稿发布为新版本body 可选 curl -X POST https://sim.ai/api/v1/workflows/{workflow-id}/deploy \ -H Content-Type: application/json \ -H x-api-key: $SIM_API_KEY \ -d { name: Release 4, description: Fixes the agent prompt } # 下线工作流 curl -X DELETE https://sim.ai/api/v1/workflows/{workflow-id}/deploy \ -H x-api-key: $SIM_API_KEY # 回滚到上一个版本或传 { version: N } 指定某个版本 curl -X POST https://sim.ai/api/v1/workflows/{workflow-id}/rollback \ -H x-api-key: $SIM_API_KEYrollback 端点重新激活一个已有的部署版本——与 Promote to live 是同一操作同样不动画布草稿。Deployments block来源Deployments 集成文档让你在另一个工作流中由 agent 以 block 形式执行版本管理同样要求工作区 admin 权限Promote Version to Live输入workflowId和version要提升的版本号输出包含version当前 live 的版本和isDeployed。它和弹窗里的 Promote to live 是同一操作对已下线undeployed的工作流也有效——会按该版本重新上线。List Deployment Versions输入workflowId输出按新到旧排列的版本数组每项含version、name、description、isActive、createdAt、deployedByName用isActive判断哪个版本 live。Get Deployment Version输入workflowId和version返回该版本元数据含isActive和deployedState——完整的工作流状态快照blocks、edges、loops、parallels、variables。如何验证回滚生效文档给出三种确认方式按使用成本从低到高Versions 表Promote 后回到 General 标签绿色圆点应该移到被你提升的那个版本上Live Workflow小地图也变为该版本的只读快照。实际调用一次 API部署后工作流在 execute 端点响应请求x-api-key头传 API key请求体对象匹配工作流的 Input Format响应包含各 block 的输出和执行元数据curl -X POST https://sim.ai/api/v2/workflows/{workflow-id}/execute \ -H Content-Type: application/json \ -H x-api-key: $SIM_API_KEY \ -d { input: { message: Hello } }注意两处细节文档各页对该路径写法不一致——专门的 API deployment 文档 使用带/v2的路径https://sim.ai/api/v2/workflows/{workflow-id}/execute而 deployment 概述 的示例写的是不带/v2的https://sim.ai/api/workflows/{workflow-id}/execute请以 API 文档中的 v2 形式为准。请求 body 里的{ input: ... }需要替换为你的工作流实际定义的输入格式。查日志确认某次运行用的是哪个快照Logs debugging 文档 说明日志记录每次运行点击View Snapshot会打开该次运行发生时工作流的冻结副本。如果你上周的失败运行与现在画布上的版本不同快照展示的正是当时实际运行的版本而不是今天的版本。边界与限制Promote to live 不创建版本它只是切换哪个已有快照处于 live 状态所以回滚本身不会污染版本历史反过来你也不能用 Promote 发布一个从未部署过的内容。画布编辑与线上解耦只要不点 Update 或 Promote线上快照就不变草稿改坏了也不会影响调用者。权限v1 管理端点和 Deployments block 的所有动作都要求工作区 admin 权限没有 admin 权限的 key 无法执行部署、回滚或查询版本。Undeploy 的副作用下线工作流会同时移除其 triggers、webhooks 和 schedulesAPI 执行停止之后用 Promote 可以按某个已知版本重新上线。异步模式async: true始终针对已部署版本运行不支持草稿状态——这也是回滚对异步调用方立即生效的原因。完成一次 Promote 后以 Versions 表绿点位置和一次真实 API 调用的结果作为最终确认如果需要继续排查某个具体版本的运行细节从对应日志条目的View Snapshot进入即可。【免费下载链接】simSim is the collaborative workspace to build, deploy, and monitor AI agents and workflows. Used by 100,000 builders.项目地址: https://gitcode.com/GitHub_Trending/sim16/sim创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考