dify：可视化构建智能体与AI应用工作流

1.19.0 将嵌套工作流追踪引入可观测工具，可查看 Workflow Tool 内部步骤并保留模型上下文；应用包开始携带相关工作流，Agent 文件支持并行上传与原位预览。使用这些能力的团队需要关注：新版层次追踪仅适用于新执行，历史追踪不会回填，滚动部署应按升级指南处理。

• 外部追踪可展开 Workflow Tool 的子步骤，并保留重复调用和失败位置
• 可检查格式化提示词、响应、令牌用量以及项目与追踪链接
• 应用包可携带工作流及其传递依赖，导入时重建并注册缺失资源
• Agent 配置文件支持并行上传、原子绑定、源码高亮和 PDF 原位预览

1.18.0 新增由 Agent 选择工作流分支、可移植应用包、嵌套工作流下钻和可选的 Agent Knowledge Base，并扩展 OpenAPI 与 difyctl 的应用管理能力。升级前应同步 API、Worker、Agent Backend 和运行时镜像，源码安装需 Python 3.13；使用新 Agent 协议和本地沙箱的部署尤其需要关注。

• Output Routes 可按条件让 Agent 选择后续工作流分支，并只读暴露所选路由
• `.ifpkg` 包可携带工作流、Chatflow、Agent、技能及其文件，并在导入时重映射引用
• 运行历史支持查看 Workflow Tool 子工作流的独立步骤与嵌套执行
• Agent Knowledge Base 提供文件接入、处理记录、检索追踪和质量评估，暂处于可选测试阶段

1.17.1 增加数据集范围的知识库 API 密钥、工作流画布键盘操作和 Marketplace 创作者页面，同时修复多种文档提取问题。使用内置 Weaviate 的自托管部署必须手动分阶段升级，跨过中间版本可能导致向量搜索损坏；已受影响的文档还需在升级后重新导入。

• 知识库密钥可绑定到单个知识库，越权访问其他数据集时返回 403
• 工作流节点、多选、注释标记和草稿注释支持方向键移动
• 修复 CSV 类型推断导致前导零丢失、空值变为文本等提取问题
• Markdown 表单字段名长度上限可配置，默认值仍为 128

1.17.0 为 Agent 增加 E2B 云沙箱、构建时 Home 快照和工作区级技能管理，并引入上下文感知历史压缩、可复用 LLM 环境变量及循环内人工输入。需要代理执行隔离环境、技能版本治理或长对话压缩的团队可重点评估；E2B、统一追踪和人工输入等能力涉及额外配置。

• Agent shell 与代码执行可选择 E2B 云沙箱，并随发布同步模板
• 已发布 Agent 可从构建时快照恢复软件包、文件和工作状态
• 工作区技能管理器提供草稿、发布和版本生命周期及配套界面
• 长对话可先清理旧工具结果，再摘要较早历史，以适应模型上下文窗口

1.16.1 增加工具多选输入、工作流节点定位、Agent DSL 导出和知识处理追踪，并集中修复协作、RAG、Agent 与 Web 应用问题。涉及这些模块的团队可按需升级验证；发布标题提及安全增强，但官方说明未提供更多安全细节。

• 工作流工具节点支持从预定义列表选择多个参数值
• 日志或错误消息中的 node_id 可直接定位并高亮工作流节点
• Agent 应用可从侧边栏直接导出 DSL YAML，便于备份与版本管理
• 知识库文档处理新增可观测追踪，并修复文本切分与字符清洗问题

该版本开放 Dify Agent 测试版，提供 Linux 沙箱、Skills、Agent 管理器、Web 应用及工作流集成，并允许通过对话配置环境、安装软件和创建技能。使用者需注意官方仅建议向可信、非恶意用户开放相关服务；使用 OpenAI 自定义密钥的团队还应检查 API 类型，必要时从已弃用的 Chat Completions 切换至 Responses。

• Dify Agent 默认开放测试，提供代码与 Shell 执行沙箱及技能系统
• Agent 可连接工具和知识，也可作为独立 Web 应用发布
• 工作流既可调用已有 Dify Agent，也可临时创建内嵌 Agent
• OpenAI 新配置默认改用 Responses API，旧自定义密钥不会自动切换

1.16.0-rc1 为试验性预发布版本，首次引入 Dify Agent 体验，包含 Agent 构建器、Skill 与文件上传、与工作流集成及新 Web 应用形式。该版本所有 Agent 共用同一沙箱，存在横向读取或干扰风险，仅建议提供给受信用户。升级需运行新的数据库迁移、调整环境变量并复核 docker-compose 变更。

• 试验性首发 Dify Agent 与 Skill 体系
• 当前所有 Agent 共用同一沙箱，隔离未就绪
• 升级涉及数据库迁移、环境变量与 docker-compose 变更
• 含 Dify Agent 的工作流暂时无法导出 DSL

1.15.0 新增命令行工具 difyctl，可在终端和 CI 中直接调用工作流；Chat Flow / Workflow 支持流式思维链面板；人机协作表单扩展为下拉与文件上传；支持慢响应长耗时生成模型与 Excel 内嵌图片抽取。同时包含首登页改版与多项可观测性增强，影响所有自托管与云端用户。

• 发布跨平台命令行工具 difyctl，可在 CI 与脚本中调用工作流
• Chat Flow / Workflow 支持流式思维链面板并保留到 CLI 与预览
• 人机协作表单新增下拉选择与文件/多文件上传字段
• 支持慢响应长耗时生成模型与 Excel 内嵌图片抽取

1.14.2 是 1.14.1 之后的补丁版本，侧重安全加固、工作流与知识库可靠性、可观测性修复，以及为后续 Agent 能力做铺垫。主要改进包括强化租户级敏感端点隔离、收紧内置工具凭据更新权限、修复 HITL 工作流恢复后的追踪问题、完善 RAG 文档处理与 UI 控件细节，以及改进 Langfuse v3 追踪器隔离。官方说明未提供更多细节。

• 收紧租户级敏感端点与内置工具凭据权限
• 修复 HITL 工作流恢复后追踪与回调丢失问题
• 完善 Langfuse v3 追踪器隔离等可观测性细节

v1.14.1 是面向自托管部署的安全补丁版本：Docker 部署不再依赖公开默认 SECRET_KEY，改由运行时生成并持久化；/threads 与 /db-pool-stat 等内部指标端点加固；修复 /account/avatar 的 IDOR 问题；LiteLLM 等依赖升级修补 CVE。同时修复工作流加载、变量引用、人机协同与知识库稳定性问题。强烈建议所有自托管实例升级。

• Docker 自托管 SECRET_KEY 改为运行时生成并持久化
• 内部指标端点加固，并修复账户头像 IDOR 问题
• LiteLLM 等依赖升级修补 CVE-2026-42208 等漏洞
• 修复工作流加载、变量选择器与人机协同稳定性问题