Dify 的 workflow 观测一直有个盲区:工作流调了 Workflow Tool,进去之后那几步是看不见的。你只能看到外面那一层,里面 LLM 调了几次、每步耗时多少,全黑。
这是痛点。1.19.0 把这个补上了。我看完发布说明,又去 GitHub 核了对应的 PR。下面说它到底改了什么,值不值得升。
先说我的核对方式。我没有把整套 Dify 跑起来,因为它要起一长串 Docker 容器,我这台机器的 docker daemon 没起。所以我按发布说明和源码改动核对,哪些能证实、哪些不能,我会说清楚。
嵌套 tracing 是什么
核心功能叫 nested workflow tracing。以前 Console 的下钻是 1.18.0 引入的,这次做到外部 trace 里,展开一个 Workflow Tool 就能看到它内部每一步执行,子步骤挂在调用它的 Tool span 下面,嵌套和重复调用都保留层级。关键是 LLM 上下文也跟着执行树一起留,格式化后的 prompt、response、token 用量都能查。
这条功能背后是个大重构。我查了 PR #44673,标题是 refactor(tracing): one trace pipeline behind a minimal provider interface,改了 432 个文件,加了 28345 行删了 47847 行。这不是加个开关,是把 tracing 管线整个重写成一个统一的 provider 接口。
有一点发布说明写得很清楚,历史 trace 不回溯。新的层级只对新的执行生效,已经跑完的旧 trace 还是老样子。独立嵌套的 workflow 运行仍是分开的 trace,靠 parent 标识符连起来。
还有一点要说清。这版是把 trace 输出到外部观测工具,发布说明的截图就是 Langfuse 的 trace 树。所以它跟 Langfuse、LangSmith 不是替代关系,是 Dify 产 trace、外部工具展示。你已经接了 Langfuse,升级后直接就能看到嵌套层级,不用换观测栈。
我判断这功能最直接的好处,是排障时不用再切好几个地方。以前查一个 workflow 卡在哪,要进 Workflow Tool 里点开看,再回外层对 token 用量。现在一层 trace 树全看完了。这个很省事。
Workflow Tool 能带走了
第二个变化是 Workflow Tool 可移植。导出 app 时能把背后那几个 workflow 一起带走,.ifpkg 包包含绑定版本的 workflow 和传递依赖。导入时复用目标工作区已有的工具,缺的重新建、发布、注册,引用自动重映射。所有 app 导出都切到 package format v2。
这是给多环境协作用的。开发环境搭好的 workflow 工具,导出成包丢给生产环境,不用手动重建。我判断这个功能的价值比嵌套 tracing 更实在,因为跨环境迁移一直是 Dify 的痛点。
对比表:1.18 到 1.19 的增量
| 能力 | 1.18.0 | 1.19.0 |
|---|---|---|
| 嵌套 workflow tracing | Console 下钻 | 外部 trace 也能钻到子工具 |
| LLM 上下文 | 部分 | 格式化 prompt/response/token 一起留 |
| Workflow Tool 导出 | 不支持 | .ifpkg 打包,format v2 |
| Skill 管理 | 控制台 | difyctl 六条命令走 CLI |
| plugin daemon | 旧版 | 0.6.14-local |
还有一个升级前提得说。发布说明的升级指南里写 Docker Compose 要 v2.35.0 以上。我本机 docker compose version 输出 v5.1.2,满足这个要求。但要真跑,得先起 Docker,再拉 postgres、redis、weaviate、api、web、worker、plugin_daemon 这一串。
difyctl 那六条命令我列一下,方便你判断要不要用。
difyctl get skill # 列出 Skill,带关键词和标签过滤
difyctl describe skill # 看详情、draft hash、最新发布版本
difyctl get skill version # 列已发布版本
difyctl export skill # 导出 draft 或指定版本为 ZIP
difyctl import skill --files # 从本地文件建或替换 draft
difyctl publish skill # 把 draft 发布成新版本
这六条要一个能登录的账号和对应工作区权限,导入不自动发布,导入覆盖已有 Skill 会被当成破坏性操作。
除了 tracing 和工具导出,这版还改了两件小事。Agent 配置文件能多选批量上传,成功的一批原子绑定,并发保存保留最新文件。PDF 能在线预览,源码文件带语法高亮,截断的地方有提示。插件 daemon 从旧版升到 0.6.14-local。
这几件小事我不展开。但它们合起来说明 Dify 在往「Agent 也能当正经开发工作台用」这个方向收。
什么规模的团队才用得上
给个判断。你要是单人或者两三个人的小团队,工作流没到嵌套调用的复杂度,1.18 的 Console 下钻基本够用,不必追这个版本。等你的 workflow 开始互相调,一个工作流套三四个 Workflow Tool,出问题要一层层往下找的时候,嵌套 tracing 才真正省时间。
升级这事,我的态度是别追新。先把 Docker Compose 升到 v2.35.0 以上,备份好数据库、向量库、上传文件,组件一起升,别只升一半。历史 trace 不会回溯,这点心里有数。要是你的工作流还停在单层、不套 Workflow Tool,这次升级对你零收益,别动。
一句话。1.19 的增量不在多了一个功能,在它把 workflow 的观测从「只看外面」推到「能钻到底」。这个能力,团队越大、工作流越深,越值。