Dify v1.16.0 版本正式发布，带来了全新的 Dify Agent功能（Beta），这是一个运行在 Linux 沙箱环境 中的代理体验。本次更新包含 Agent 构建器、AI 辅助构建、Workflow 集成等重大功能，同时优化了 OpenAI GPT-5.6 兼容性，增强了安全防护，修复了大量 Bug。升级需要运行 9 个数据库迁移，新增 28 个环境变量，Docker Compose 配置也有重大更新。
🎉 重大更新：Dify Agent (Beta)
Dify Agent 是一个全新的代理体验，运行在 Linux 沙箱环境 中。
主要特性：
Agent 构建器通过 UI 构建 Dify Agents，设置基础提示词，上传技能和文件，连接工具和知识库
AI 辅助构建提供一个帮助构建 Dify Agents 的代理，可以通过对话配置 Linux 沙箱环境、安装所需包、创建新的技能和文件
Workflow 集成可在 Dify Workflow 中使用现有的 Dify Agent 或临时创建内联 Agent
新的 Web 应用体验构建的 Dify Agent 可以发布并用作 Web 应用
⚠️重要提示：应仅向可信的、非恶意用户提供 Dify Agent 服务
📖 文档：docs.dify.ai/en/self-host/use-dify/build/new-agent/overview
⚠️ 需要注意的操作
OpenAI GPT-5.6 兼容性通知
OpenAI 插件之前默认使用 Chat Completions API，该 API 已被 OpenAI 弃用
新发布的 GPT-5.6 系列在使用 Chat Completions 时有许多参数组合限制
新配置的默认 API 类型已从 Chat Completions 更改为Responses
如果您之前配置了自定义 OpenAI API 密钥，请检查 API 类型设置，特别是在使用 GPT-5.6 或更高版本模型时，建议切换到 Responses
🆕 新功能
Agent App (公开测试版)
Agent App 进入公开测试，默认为所有用户启用
内置沙箱用于代码执行和 shell 命令
技能系统让代理可以调用工具和 API
代理名册用于管理和在工作空间中重用代理
支持从工作流代理节点引用新代理
更智能的 AI Workflow 生成
⌘K → /create 和 /refine AI 工作流生成器得到端到端增强
移除了低价值的"理想输出"字段
静态示例芯片替换为基于工作空间上下文的 AI 生成建议
节点配置生成现在并行化以获得更快的结果
可配置超时（WORKFLOWGENERATIONTIMEOUT_MS，默认 180 秒）
MCP 协议升级
workflow-as-MCP 服务器现在支持 MCP 协议 2025-06-18，包括版本协商和结构化工具输出
保持与旧客户端的向后兼容
MCPClient 连接现在可以使用占位符在运行时注入动态 HTTP 请求头（例如{{request.headers.X-Custom-Auth}}）
Web 应用自定义
应用所有者现在可以为 Chatbot、Agent 和 Chatflow Web 应用自定义聊天输入占位符文本（最多 64 个字符）
自定义 UI 改进，命名更清晰（"自定义前端" / "品牌"）
应用描述现在显示在聊天和文本生成应用屏幕上，带有可折叠视图
Workflow 可靠性和操作
Workflow 运行归档现在可以导出
Celery 温和关闭期间正确中止活动运行以防止孤立任务
Redis 连接更具弹性，支持 TCP keepalive 和扩展的重试覆盖
模型提供商现在接收app_id用于提供商端成本归因
OAuth 和 SSO 登录流程更可靠地保留重定向 URL
🐛 Bug 修复
Workflow 和 Agent
修复工作流草稿导入丢失引用、失败后节点结算、重试详细信息可见性、HITL 恢复状态恢复的多个问题
修复 Unicode 分隔符的 SSE 流损坏、代理最终答案在流完成后清除、对话标题被空值覆盖
修复工作流归档重试加固、多工作者协作支持、聊天树乱序父节点
修复知识检索失败未向用户显示、内置模板中的 End 输出变量名称冲突
身份验证和访问控制
修复登录后和身份验证重定向流程中的开放重定向漏洞
修复登录重定向不停留在当前部署、身份验证前缀重复、更改电子邮件不工作
修复编辑器权限问题：编辑器现在可以查看日志，不再查询计费订阅，不能再管理成员
修复跟踪配置更改不需要编辑访问权限、推荐应用的试用应用访问加固
模型和插件
修复删除时未清除自定义模型缓存、模型插件调试失败、Xinference 凭证上下文处理
修复后续模型参数中无法禁用最大令牌参数
修复插件提供商缓存风暴、市场安装回调、插件权限设置
Web 和 UI
修复从 Learn Dify 创建应用、节点搜索字段输入、工作空间头像一致性、导航配置文件显示
修复 Streamdown 全屏表格操作、市场页面标题抖动、安装对话框可访问性
修复聊天附件滚动出视图、HITL 输入保存按钮可见性、应用卡元数据溢出
修复监控图表零值显示、成员邀请状态处理、深色模式背景、表单字段名称中的 Unicode 字符
修复 markdown 文件预览链接下载、Notion 同步空状态、CSP 下的博客 UTM 归因
其他
修复批量文档删除中的无限循环、无效的 UTF-8 缓存有效负载、被吞没的文档索引错误
修复 PostgreSQL 18 原生 uuidv7() 支持和 ADB-PG 7.0 兼容性
修复CANREPLACELOGO默认为 true、execute_code 中不支持的语言错误、CLI–insecure标志不跳过 TLS 验证
🚀 改进
性能
消除高级聊天工作流运行列表和 TokenBufferMemory 消息文件加载中的 N+1 查询
通过延迟加载的 Vite 插件和控制台合约分片加快前端启动
通过缓存设置状态、使用 zstd 压缩 Redis 中的大型插件模型对象、通过直接外键检索已发布的工作流来降低数据库负载
架构和代码质量
将所有控制台 API 端点迁移到使用 BaseModel 生成的 OpenAPI 合约
在后端路径中传播显式数据库会话以保持一致性和可测试性
用 Jotai atoms 替换前端的旧应用上下文提供者
升级到 TypeScript 7 和 Vite+ 工具链，强制执行严格的 ESLint 规则，禁止在控制器中使用新的直接 SQLAlchemy
🔒 安全增强
SQL 注入：关闭 SQL 注入漏洞，通过元数据键验证增强 SQL 查询安全性
SSRF：修复通过 API 工具模式获取中的原始httpx.get绕过 SSRF
开放重定向：防止登录后和身份验证重定向流程中的开放重定向
沙箱强制：Chatflow API 现在检查 workflow_id 和沙箱计划
Landlock 保护：使用 Landlock 保护 Agent HOME 目录；降级到 v1 以获得更广泛的内核兼容性
CVE 依赖升级：httplib2、setuptools、wandb；python-engineio、python-socketio；fickling、pillow、click
🔧 环境变量更改
新增变量（28 个）
主要包括：
AGENTBACKENDBASE_URL：Agent 后端服务基础 URL
DIFYAGENT*系列：Dify Agent 相关配置
DIFYAGENTSERVERSECRETKEY：JWE 加密密钥（⚠️ 生产环境必须替换）
SHELLCTL_*系列：shellctl 相关配置
NEWUSERDEFAULTPLUGINIDS：新用户默认插件
WORKFLOWGENERATIONTIMEOUT_MS：AI 工作流生成超时
REDIS_KEEPALIVE*系列：Redis TCP keepalive 配置
NEXTPUBLICENABLEAGENTV2：启用 Agent App v2（默认 true）
删除变量（1 个）
ENABLEAGENTV2：被NEXTPUBLICENABLEAGENTV2替代
修改变量（1 个）
NEXTPUBLICENABLEFEATUREPREVIEW：从false改为true
Docker Compose 更改
新增服务：agentbackend和localsandbox
api和worker服务现在依赖agent_backend
💾 数据库迁移
此版本包含9 个新数据库迁移，升级后需要运行flask db upgrade
📋 升级指南
重要提示
包含 9 个新数据库迁移- 升级时必须运行数据库迁移
28 个新环境变量，1 个删除，1 个修改- 需要更新.env文件
Docker Compose 配置重大更改- 添加了两个新服务（agentbackend、localsandbox）
DIFYAGENTSERVERSECRETKEY附带开发默认值，生产环境必须替换：python -c 'import secrets; print(secrets.token_urlsafe(32))'
ENABLEAGENTV2已重命名为NEXTPUBLICENABLEAGENTV2，默认值为true
OpenAI GPT-5.6 用户：验证 API 类型设置为Responses
Docker Compose 部署步骤
备份cd dockercp docker-compose.yaml docker-compose.yaml.$(date +%s).bakcp .env .env.$(date +%s).bak 2>/dev/null || true# 2. 获取最新代码git fetch –tagsgit checkout 1.16.0# 3. 停止服务docker compose down# 4. 备份数据tar -cvf volumes-$(date +%s).tgz volumes# 5. 更新 .env 文件（特别是 DIFYAGENTSERVERSECRETKEY）# 6. 升级服务docker compose up -d
源码部署步骤
停止服务# 2. 获取最新代码git fetch –tagsgit checkout 1.16.0# 3. 更新依赖cd apiuv sync# 4. 运行迁移uv run flask db upgrade# 5. 配置 Agent 后端服务# 6. 重启服务
