AI 研究助理

基于站内最新资料，回答 AI 前沿问题

回答带出处引用，支持多轮追问，当前页面内容会作为上下文

快速响应
AI 前沿跟踪
今日首页重点内容GitHub 趋势榜
领域
学术研究
大模型
具身智能
AI 基础设施
智能体 · Skill · MCP
机器人
多模态
自动驾驶
数据 / MLOps
AI 硬件
安全对齐
综述与报告
发布智能体 · Skill · MCPDifyAgent 工作流应用打包difyctl

dify v1.18.0 — Smarter Agent Routing, Portable Apps, Deeper Workflow Visibility

查看发布页
AI 解读已生成 · AI 生成，数字以原文为准
AI 全文总结值得深入基于版本说明 3.5 万字 · 完整阅读

Dify 1.18.0 发布：Agent 可用 Output Routes 选择工作流分支，升级需同步升级所有 Agent 组件。

Dify 1.18.0 为 Agent 新增 Output Routes 按条件选择工作流分支，普通 Agent 节点支持流式输出；应用可连同 Agent、Skill 与文件打包为 .ifpkg 迁移，导入时重建并重映射资源；Workflow Tool 调用可下钻查看子流程步骤，子图支持暂停、恢复、停止；Beta 版 Agent Knowledge Base 引入独立 KnowledgeFS 服务和知识检索节点，经典知识库保留。新增 difyctl CLI 与 OpenAPI 操作目录，支持 Workflow/Chatflow 创建、DSL 导入导出、发布和版本恢复。升级需 API、Worker、Agent Backend、运行镜像同步更新，/runs 改用协议 v2 并移除旧 AskHuman，Local 沙箱须设非空 token，源码需 Python 3.13，现有 PASSWORD_PEPPER 保持不变。从 1.17.1 升级应用 22 个数据库迁移；默认 Compose 关闭 KnowledgeFS，需单独配置数据库与迁移；difyctl 需重新登录，旧路由被按模式操作替代；嵌套用量在暂停或停止后仍可能近似。

  1. 1Agent v2 节点可启用 Output Routes 选择工作流分支，只读 switch 输出。
  2. 2.ifpkg 包内联 Agents/Skills/文件，导入时重映射引用。
  3. 3升级需同步替换 Agent 组件，/runs 已拒绝 v1 请求。

为什么重要　对 Agent 工作流与可移植性直接有用：Output Routes 让 Agent 在工作流内做分支决策，嵌套追踪可查到子工作流步骤；但自托管升级有破坏性改动，必须读升级指南。适合　自托管 Dify 的平台工程师、Agent 工作流开发者、关注 MCP 与沙箱集成的团队。

来源
github.com
发布
2026/10/23
作者
langgenius

破坏性变更3 项

  • /runs 接受 composition v2 并拒绝 v1 请求；旧 Agent 后端无法读新 v2 快照，必须同步升级。
  • Local 沙箱要求非空 DIFY_AGENT_LOCAL_SANDBOX_AUTH_TOKEN，Landlock 失败以 exit 125 中止。
  • PASSWORD_PEPPER 新增：设置、更改或移除会使现有密码哈希失效。

新增5 项

  • Agent v2 节点新增 Output Routes，可定义至少两个分支及选择条件，并输出只读 switch 所选路由。
  • 新增 .ifpkg 可移植应用包，Workflow/Chatflow 包内联 Agent、Skill 和文件，导入时重映射引用。
  • 新增 Agent Knowledge Base Beta 与 KnowledgeFS，独立服务与数据库，默认关闭。
  • 新增 OpenAPI /openapi/v1 操作目录和 difyctl CLI，支持应用创建、DSL 导入导出、发布与版本恢复。
  • 新增自托管 NVIDIA OpenShell 网关作为 Agent 执行后端，要求 gateway 0.0.106+。

改进1 项

  • Plain Agent v2 节点流式输出文本；结构化结果、路由结果和默认值错误处理保持缓冲。

弃用2 项

  • GRAPH_ENGINE_MIN_WORKERS、GRAPH_ENGINE_SCALE_UP_THRESHOLD、GRAPH_ENGINE_SCALE_DOWN_IDLE_TIME 不再使用。
  • Console feedback export 端点 GET /console/api/apps/{app_id}/feedbacks/export 移除。

修复1 项

  • MCP 发现遵循所有 tool pages，混合类型参数保留列表值，SSE 失败后先关闭再 HTTP fallback，协议支持 2025-11-25。
209715200

技能包未压缩

bytes，可选设置

5000

技能包条目

最多条目数

536870912

Agent 包

字节上限

5000

Agent 包条目

最多条目数

10MiB

普通应用 DSL

保留限制

注释 · 这些是新可选设置中的包大小上限，普通应用 DSL 仍限 10 MiB。出自 New Optional Settings

  1. 1
    安装 difyctl Agent 技能包
    $ difyctl install skills <dir>
  2. 2
    登录 difyctl
    $ difyctl login --server https://your-dify.example.com
  3. 3
    Docker Compose 升级
    $ cd dify/docker
      docker compose stop -t -1
      git fetch --tags
      git checkout 1.18.0
      docker compose pull
      docker compose up -d
  4. 4
    Source 部署刷新依赖
    $ uv sync --project api --frozen
      uv run --directory api flask db upgrade
      pnpm install --frozen-lockfile
Python
3.13
Node.js
24.22.1 或更高
pnpm
12.10.1
Weaviate
1.39.2 → 1.39.13
E2B SDK
2.55.1
NLTK
3.10.4

中文（AI 翻译）

Dify 1.18.0 带来了可路由工作流的 Agents、可移植应用包、对嵌套工作流运行的更深入可见性，以及可选启用的 Agent Knowledge Base 体验。OpenAPI 和新的 difyctl 扩展了你从命令行构建和管理应用的方式。

[!IMPORTANT] 部署前请阅读下方升级指南。 请一起升级 API、workers、Agent Backend 和 Agent runtime 镜像。

本地 Agent 沙箱需要非空认证令牌，并且 Agent Backend 使用新的运行协议。源码安装需要 Python 3.13。

请安装新的 difyctl 客户端并重新登录。请保留现有 PASSWORD_PEPPER 配置。

发布亮点

选择下一步的 Agents

让 Agent 决定采取哪个工作流分支。启用 Output Routes，为每个路由设置选择条件，并将其连接到下一步——例如直接解决请求，或移交给专家。只读的 switch 输出会暴露所选路由。（#42599）

工作流编辑器中具有两个分支的 Output Routes 配置。

普通 Agent v2 节点也会在生成时流式输出文本。结构化结果、路由结果，以及使用默认值错误处理的节点仍保持缓冲。（#43986）

单个包中的可移植应用

通过单个 .ifpkg 包移动应用及其支持的资源。Workflow 和 Chatflow 包携带内联 Agents、Skills 及它们的文件；导入会在目标工作区重新创建这些资源。

原文

Dify 1.18.0 brings Agents that route workflows, portable app packages, deeper visibility into nested workflow runs, and the opt-in Agent Knowledge Base experience. OpenAPI and the new difyctl expand how you build and manage apps from the command line.

[!IMPORTANT] Read the upgrade guide below before deploying. Upgrade the API, workers, Agent Backend, and Agent runtime images together. Local Agent sandboxes require a non-empty authentication token, and Agent Backend uses a new run protocol. Source installations require Python 3.13. Install the new difyctl client and sign in again. Preserve your existing PASSWORD_PEPPER configuration.

Release highlights

Agents that choose the next step

Let an Agent decide which workflow branch to take. Enable Output Routes, give each route a selection condition, and connect it to the next step—such as resolving a request directly or handing it to a specialist. The read-only switch output exposes the chosen route. (#42599)

Output Routes configuration with two branches in the workflow editor.

Plain Agent v2 nodes also stream text as it is generated. Structured results, routed results, and nodes using default-value error handling remain buffered. (#43986)

Portable apps in one package

Move an app with its supported resources in a single .ifpkg package. Workflow and Chatflow packages carry inline Agents, Skills, and their files; imports recreate those resources in the destination workspac…

深度总结

1 / 8
升级前必读：Agent 协议与沙箱破坏性变更· 风险提示

/runs 已拒绝 v1 请求，所有 Agent 组件必须与 1.18.0 同步升级。

风险

升级前先备份数据库、向量库与上传文件。Agent Backend 与 Local sandbox 镜像必须匹配 1.18.0。旧 AskHuman 工具与 deferred resume 路径已移除，历史 Agent 表单不再恢复执行。PASSWORD_PEPPER 需保持不变，新设会使现有密码哈希失效。

注释 · 旧快照读取时转 v2 并保存，旧 runtime 无法读新 v2 快照；Local sandbox 需非空 token。出自 Upgrade guide