Dify 1.17.0 发布：Agent 沙箱、Skills 管理与工作流治理升级
Dify 1.17.0 把 Agent 运行环境、Skills 生命周期和复杂工作流治理推进了一步，但自托管升级需同步处理数据库迁移与环境变量变化。
Updated: 2026-09-20
Type: workflow / TechArticle
这次更新的重点
Dify 1.17.0 的核心变化集中在 Agent 运行环境、可复用 Skills 和复杂工作流治理。官方 Release 说明显示，Agent 的 shell 与代码执行现在可以选择本地沙箱或 E2B 云沙箱；已发布 Agent 还可以通过构建时 Home 快照恢复安装包、准备文件和工作状态。
这不是一次只改界面的版本。它同时包含新的数据库迁移、Docker Compose 调整和环境变量变化。自托管用户应先完成备份与升级演练，再将版本推进到生产环境。
Agent 沙箱与 Home 快照
- 通过
DIFY_AGENT_RUNTIME_BACKEND选择本地或 E2B 沙箱后端。 - 新增
docker-compose.e2b.yaml，用于部署 E2B Agent 沙箱相关服务。 - 构建并发布 Agent 时，可以捕获沙箱 Home 目录；后续运行从该快照恢复准备好的文件和环境。
- 长会话加入分层历史压缩，优先清理旧工具结果，再摘要较早历史，以控制上下文占用。
对需要安装依赖、生成中间文件或保持可重复执行环境的 Agent，这些能力比单次临时执行更容易形成稳定的交付流程。
Skills 与工作流治理
工作区现在提供 Skills 管理能力，包含草稿、发布和版本生命周期，并配套列表、构建面板与文件编辑界面。Skills 可以封装代码和工具定义，供 Agent 发现和调用。
工作流侧还有三项值得关注的变化：
- 可复用的 LLM 环境变量允许集中定义模型、模式与参数，并在多个 LLM 节点中引用。
- Human Input 可以放入 Loop 和 Iteration 节点，在调试和已安装应用中暂停、刷新并继续执行。
- 可选的统一追踪通过
OPS_TRACE_UNIFIED_ENABLED开启，首批提供 Phoenix 和 LangSmith 适配器，并记录 LLM 首 token 时间、Agent ReAct 步骤与工具调用等信息。
自托管升级前要检查什么
官方升级说明列出了多个不能忽略的迁移点：
- 先备份数据库、自定义 Compose 文件和环境变量文件。
- 执行该版本包含的数据库迁移；官方建议将
flask db upgrade纳入升级过程。 - 如果实例从 1.15.0 之前的版本升级，且尚未执行旧模型类型迁移，需要先运行 dry-run、检查输出，再决定是否使用
--apply。该步骤不包含在flask db upgrade中。 - 环境变量
EDITION已改名为DEPLOYMENT_EDITION，同时 Agent、认证、KMS、检索和追踪相关变量有新增或调整。 - Docker Compose 文件发生变化，并新增 E2B Compose；有本地定制时应逐项重新合并。
升级后至少验证现有模型能否加载和调用、Agent 沙箱是否能创建、旧工作流是否能运行、循环中的人工输入是否能恢复，以及追踪后端是否收到完整 span。
AI2Work 的判断
1.17.0 更适合被视为一次 Agent 平台能力与运维边界同步扩展的版本。Skills、快照和循环人工输入提高了复杂 Agent 工作流的可复用性，但也增加了迁移与配置检查项。小团队可以先选择一个非关键 Agent 做灰度验证，保留上一版本部署包和数据库备份，再扩大升级范围。
Official source
FAQ
- Q：Dify 1.17.0 升级后必须使用 E2B 吗？
A：不必须。官方说明提供本地沙箱和 E2B 云沙箱两种后端，可以通过 DIFY_AGENT_RUNTIME_BACKEND 选择；应按部署边界、网络和安全要求决定。 - Q：从 Dify 1.15.0 之前的版本升级要额外做什么？
A：如果旧模型类型迁移尚未执行，需要先运行官方提供的 dry-run，核对结果后再使用 --apply。该迁移不包含在 flask db upgrade 中，执行前应备份数据库。