Dify 智能体配置会持续变化，安全做法是把“正在编辑的草稿”和“用户正在使用的版本”分开。每次发布前先命名并记录测试结果；需要恢复时，先把旧版本载入草稿，核对后再发布，不能把“恢复到草稿”误认为已经回滚线上。
先理解三个状态
Current Draft 是正在编辑的配置，用户不会直接看到；Latest Version 是当前线上版本；Previous Versions 是以前发布过的版本。Dify 新版 Agent 的编辑会自动保存为草稿，发布后成为线上版本，并可在版本历史中查看或恢复。
通用 Version Control 文档目前明确只覆盖 Chatflow 和 Workflow；新版 Agent 有自己的版本历史。两类入口不同，操作前先确认你打开的是 Agent 还是工作流，避免照错界面。
发布前给版本留下可读记录
- 在草稿中完成提示词、工具、Skills、Files 和环境变量修改。
- 用固定回归集测试：正常任务、缺字段、工具失败、越权请求和提示词攻击。
- 记录本次变更，例如“v1.3：订单查询只读；增加超时兜底”。
- 打开 Preview，确认工具调用与输出，再点击 Publish。
- 发布后用 Web App 或 API 再跑一个烟雾测试，确认用户访问的是新版本。
发布通过的标准是：草稿回归集全部通过，线上烟雾测试显示新版本行为，历史列表中能找到带说明的上一版本。不要只根据“Publish 成功”提示判断业务已经正常。
恢复旧版本的正确顺序
发现新版本异常时，先保存运行 ID 和错误样例。然后在版本历史中选定已知正常版本，执行 Restore，把它载入当前草稿；恢复操作会替换当前草稿，因此未保存的草稿改动可能丢失。先在 Preview 重跑导致故障的输入，再发布恢复后的草稿。
恢复检查必须同时看三处：Preview 行为正确；发布后的访问点行为正确；工具凭证和外部 API 仍可用。版本记录能恢复 Dify 配置，但外部服务、知识库内容和插件版本可能已经变化，不能假定一起回到过去。
配置和文件的边界
官方新版 Agent 文档说明，恢复版本时会恢复 Agent 沙箱中的持久文件；而导出 DSL 时 Skills 和 Files 不包含在内，需要单独分享。团队交接时因此要同时保存版本说明、依赖插件版本和外部资源清单。
适用边界
部分恢复、指定版本 DSL 和按指定已发布版本调用 Service API 的能力受套餐限制；Sandbox 通常运行最新发布版本。本文没有替你执行恢复，生产回滚前应先确认工作区套餐和未保存草稿。Agent 行为见 Build an Agent，Chatflow/Workflow 版本规则见 Version Control，核验日期为 2026-10-01。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/32301.html
