Dify v1.20.0 釋出!強化代理工作流路由、通訊軟體人機審核、OpenTelemetry 追蹤與惡意檔案掃描
GitHub 破 16 萬星的開源代理工作流平台 Dify 於 2026 年底接連推出 v1.18 至 v1.20.0,整合 Output Routes 代理分流、跨通訊工具 HITL 審核、OpenTelemetry 追蹤與知識庫掃毒。
企業把大型語言模型從概念驗證(PoC)推向正式生產環境時,最常卡關的往往不是模型聰不聰明,而是三個現實問題:當代理(Agent)決策出錯時誰來攔截、多層巢狀工作流黑盒子怎麼除錯,以及使用者上傳到 RAG 知識庫的檔案安不安全。
在 GitHub 上累積超過 16 萬 1 千顆星的開源 AI 應用與代理工作流平台 Dify(langgenius/dify),於 2026 年 10 月至 11 月間接連釋出 v1.18.0、v1.19.0 與最新的 v1.20.0(2026 年 11 月 18 日發布)。
這波連續更新清楚勾勒出開源代理編排平台的演進方向:不再只是把對話框與提示詞串起來,而是讓代理具備自主選擇分支路由的能力、將「人機協作審核(Human-in-the-Loop, HITL)」直接嵌入團隊日常使用的郵件與通訊軟體,並把全鏈路可觀測性交給標準化的 OpenTelemetry 收集器。
無論你的團隊正在雲端、VPC 專有雲還是透過 Docker 自架 Dify,以下完整拆解 v1.18 至 v1.20.0 的核心技術升級,以及升級前必須留意的環境變更。
為什麼代理工作流需要從「靜態畫布」走向「可治理系統」?
早期的視覺化 LLM 工作流工具,大多採用預先寫死的條件判斷節點(If/Else),決定下一段流程該往哪走。然而在實際的客服派單、自動化維運或跨部門審批場景裡,使用者的意圖往往模糊且多變,硬編碼條件很快就會變得難以維護。
相對地,若完全放手讓自主代理自由呼叫外部工具,企業又會面臨失控風險:代理呼叫了巢狀子工作流卻無法追蹤內部 LLM 消耗、敏感操作沒經過主管核准就自動送出,或是外部知識庫不小心索引了夾帶惡意程式的檔案。Dify 在 2026 年底這三個大版本的改進,正是為了在「代理自主彈性」與「企業級治理」之間建立可落地的平衡。
延伸閱讀:Slack 工作流程接上 AI 代理:背景任務、人員接手與審核步驟怎麼分?

代理自主路由與可攜式打包:v1.18.0 到 v1.19.0 鋪陳的基礎
在分析最新的 v1.20.0 之前,必須先看懂 v1.18.0 與 v1.19.0 為代理工作流打下的兩個底層能力。
1. Output Routes:讓代理決定工作流分支
自 v1.18.0(2026 年 10 月 23 日釋出)起,Dify 的代理節點正式支援 Output Routes。開發者可以為代理設定多個帶有選擇條件的輸出路徑,並連接到截然不同的後續步驟——例如簡易問題由代理直接結案回覆,複雜異常則轉交給專門的領域代理、高階推論模型或人工處理節點。為了讓下游流程能精準判讀分流結果,系統同時提供唯讀的 switch 輸出欄位,記錄代理最終選擇了哪一條分支,讓視覺化畫布具備「動態決策、靜態可控」的彈性。
2. 巢狀工作流追蹤(Nested Workflow Tracing)
過去當主工作流呼叫一個「Workflow Tool(把另一個工作流封裝成工具)」時,外部監控往往只看得到這顆工具黑盒子的整體耗時與最終結果,一旦內部出錯便極難定位。v1.18.0 先在控制台加入了下鑽檢視,而 v1.19.0(2026 年 11 月 4 日釋出)更進一步把巢狀執行步驟持久化並輸出到外部追蹤系統。子工作流內部的每一步節點執行與每次 LLM 呼叫,都會保留完整上下文並以階層樹狀結構掛載在呼叫它的 Tool Span 底下,讓效能瓶頸分析、除錯與跨部門成本歸因徹底透明化。
3. 可攜式應用封裝、difyctl 與技能自動化
針對跨環境搬遷與 CI/CD 自動化部署需求,v1.18.0 導入了新版 difyctl 命令列工具與增強版 OpenAPI,讓團隊能直接從終端機建立並管理應用,同時開啟選配的「Agent Knowledge Base」體驗;v1.19.0 則讓 Workflow Tools 能隨同應用程式套件一併匯出與攜帶,大幅減少在測試環境與正式環境之間反覆重建子流程的工時。此外,v1.19.0 也加入了 Skill Hub 自動化能力、更流暢的代理檔案上傳與預覽體驗,並將內建外掛常駐程式升級至 0.6.14-local。
Dify v1.20.0 四大關鍵升級:把人機審核與資安放進生產線
2026 年 11 月 18 日登場的 v1.20.0,則把焦點放在「讓資料與追蹤持續流動,同時讓知識庫與人機決策更安全」,內建的外掛常駐程式(Plugin Daemon)也同步升級至 0.6.15-local。
1. 全新 HITL:直接把審核送進團隊的郵件與通訊軟體
在舊有架構中,如果工作流需要人工確認才能繼續,審核者往往得登入特定的工作台介面,造成審批延遲。v1.20.0 推出的新版 Human-in-the-Loop(HITL) 機制,允許工作流直接透過電子郵件與團隊既有的即時通訊工具發起審批,並導入共用頻道(Shared Channels)、集中式聯絡人管理、自訂通知範本與經過驗證的核准回傳機制。這讓代理在執行高風險動作(如發送對外信件、退款或修改資料庫)前,能在團隊日常溝通管道就地完成人工把關,同時留下可稽核的核准紀錄。
2. 全面支援 OpenTelemetry 匯出與 Langfuse 銜接
可觀測性(Observability)是代理上線後的命脈。v1.20.0 開放將執行追蹤(Traces)直接匯出至任何相容 OpenTelemetry(OTel) 的收集器,讓企業能將 AI 代理的延遲、錯誤率與 Token 消耗無縫併入既有的 Grafana、Datadog 或內部監控大盤,搭配 v1.19.0 的巢狀工作流階層資訊,能完整還原每次代理呼叫的成本結構。此外,因應 Langfuse 舊版擷取端點(Legacy Ingestion Endpoint)退役,新版也同步完成相容性更新,確保既有用戶的追蹤資料不會中斷。
3. 知識庫上傳前惡意軟體掃描
在企業內部 RAG(檢索增強生成)架構裡,知識庫經常開放員工或外部系統批次上傳 PDF、Word 或試算表。v1.20.0 新增了上傳知識檔案前的惡意程式掃描機制,在檔案進入分塊(Chunking)與向量索引之前先行檢查,降低惡意文件污染知識庫、夾帶腳本或攻擊文件解析器的資安風險,替對外開放的客服與內部知識平台多加一道防線。
4. Chatflow 即時顯示代理工具動態與個人存取權杖
在使用者體驗與自動化串接上,v1.20.0 讓 Chatflow 對話介面可以即時顯示代理正在呼叫哪個工具與執行狀態,避免使用者面對漫長的空白等待或誤以為系統當機;同時新增個人存取權杖(Personal Access Tokens, PAT),讓外部自動化腳本與其他 AI 代理能以標準身分驗證呼叫 Dify OpenAPI,大幅簡化程式化觸發工作流與批次管理應用的授權流程。
下表整理 v1.18.0 至 v1.20.0 的重點能力演進:
| 版本 | 釋出日期 | 核心升級重點 |
|---|---|---|
v1.18.0 |
2026-10-23 | Output Routes 代理分流、Agent 知識庫體驗、difyctl CLI |
v1.19.0 |
2026-11-04 | 巢狀工作流外部追蹤、Workflow Tools 可攜打包、Skill Hub 自動化 |
v1.20.0 |
2026-11-18 | 通訊軟體 HITL 審核、OTel 追蹤匯出、知識庫掃毒、PAT 權杖 |
自架與原始碼部署注意:升級前的相容性檢查清單
雖然 v1.18 到 v1.20.0 的功能極具吸引力,但 Dify 官方也在發行說明中多次標註重要警告(Important),提醒自架維運團隊切勿直接無腦覆蓋容器映像檔。
首先,在元件同步方面,團隊必須將 API、Workers、Agent Backend 與 Agent Runtime 四組映像檔一併升級,不能只更新單一服務,因為 Agent Backend 採用了全新的執行協議,且本機代理沙盒現在強制要求配置非空值的驗證權杖(Authentication Token),以防止未授權程式碼執行。同時,內建外掛常駐程式(Plugin Daemon)在 v1.19.0 升級至 0.6.14-local,並於 v1.20.0 進一步更新至 0.6.15-local,自架環境務必確認外掛服務與主程式版本對應一致。
其次,如果是採用原始碼直接部署(Source Installation)的團隊,自 v1.18.0 起已強制要求 Python 3.13 執行環境,並且必須保留原本設定中的 PASSWORD_PEPPER 參數、重新安裝新版 difyctl 命令列工具並再次登入驗證。做好資料庫遷移(Database Migrations)備份、確認 Redis 與向量資料庫連線設定,以及逐項核對環境變數,是確保平滑跨版升級的必要前置作業。
誰最適合現在導入或升級 Dify?
綜合這三個版本的演進,Dify 已經非常明確地定位在「協作式生產級代理平台」。如果你是一人開發者且只想在終端機快速改幾行程式碼,Claude Code、Codex CLI 或 OpenCode 這類終端機代理會更輕巧直接;但若你的需求是建立跨部門共用的客服、資料分析、自動化審批或企業知識庫應用,Dify 提供的視覺化路由、通訊軟體 HITL 審核、OpenTelemetry 監控與 VPC 自架能力,正是純終端機工具難以取代的企業級基礎設施。
具體來說,以下三類團隊特別適合優先評估 v1.20.0:第一類是已經導入 Grafana、Datadog 或既有 OpenTelemetry 監控架構的平台工程團隊,可直接納管代理與巢狀工作流的全鏈路追蹤,同時免去 Langfuse 舊端點退役帶來的整合斷層;第二類是內部有合規審查需求的營運或法務流程團隊,可透過新版 HITL 把核准節點直接推進郵件與日常通訊群組,並透過集中式聯絡人與通知範本統一管理審批體驗;第三類則是對資安敏感、需要開放員工自主上傳文件建立 RAG 知識庫的企業,上傳前惡意軟體掃描能有效降低內部知識庫遭污染的風險。
此外,對於需要頻繁將測試環境工作流搬遷到正式環境的顧問與系統整合商而言,v1.19.0 把 Workflow Tools 納入可攜式應用套件並支援 Skill Hub 自動化,大幅降低了跨環境手動重建節點的出錯率;搭配 v1.20.0 在 Chatflow 中即時顯示代理工具執行狀態,也能讓終端使用者更信任自動化流程的每一步運作。
延伸閱讀:LiteLLM agent_eval API 預覽:自己的任務怎麼比較代理,為何不能只看通過率?
常見問題(FAQ)
Q1:Dify v1.20.0 一定要搭配雲端版才能用 OpenTelemetry 與 HITL 嗎?
不需要。Dify 支援雲端、VPC 與完全自架(Self-hosted)部署,透過 Docker Compose 升級至 v1.20.0 並依官方指南同步更新相關映像檔後,即可在自架環境使用這些功能。
Q2:什麼是 Dify 的 Output Routes?和傳統條件分支有什麼不同?
傳統條件分支依賴明確的規則或關鍵字比對;Output Routes 則是讓代理節點根據語意理解與任務上下文,自主決定要走哪一條預先定義好的輸出分支,兼顧彈性與流程可控性。
Q3:為什麼巢狀工作流追蹤(Nested Workflow Tracing)很重要?
當企業把複雜流程模組化為多個「Workflow Tool」相互呼叫時,如果追蹤只停留在最外層,一旦發生延遲暴增或邏輯錯誤就無從查起;巢狀追蹤能展開底層每一階工具與 LLM 呼叫,是大規模工作流除錯的關鍵。
Q4:從舊版 Dify 升級到 v1.18–v1.20.0 需要注意什麼?
務必依照官方升級指南執行資料庫遷移,保留 PASSWORD_PEPPER 設定,確認本機代理沙盒已配置非空驗證權杖,並將 API、Workers、Agent Backend 與 Runtime 映像檔同步升級;若為原始碼部署則需升級至 Python 3.13。
Q5:Dify v1.20.0 新增的個人存取權杖(PAT)適合用在哪些情境?
個人存取權杖主要用來讓外部腳本、CI/CD 管線或其他 AI 代理安全地呼叫 Dify OpenAPI。過去團隊常需額外處理應用層金鑰管理,現在透過 PAT 就能更細緻地以個人或自動化服務身分存取工作流與管理介面,同時配合企業內部的權限稽核機制。
Q6:Dify v1.20.0 的知識庫惡意檔案掃描會影響上傳速度嗎?
惡意程式掃描是在檔案進入文字切分(Chunking)與向量化索引之前執行的前置檢查,屬於企業知識庫上線前的安全把關機制。雖然會增加極短暫的檢查時間,但能有效避免夾帶惡意腳本或異常結構的文件破壞解析器與污染向量資料庫;對於開放多人協作或外部系統自動匯入的企業知識庫來說,這道前置防護非常值得開啟。
總結
從 v1.18.0 的代理智慧分流、v1.19.0 的巢狀工作流全鏈路追蹤,到 v1.20.0 結合通訊軟體的人機審核(HITL)、OpenTelemetry 匯出與知識庫惡意檔案掃描,Dify 在 2026 年底交出了一份極具說服力的企業級演進成績單。
這波更新的核心價值在於「讓代理能力與企業治理同步成熟」:當工作流開始具備自主分支路由能力,團隊就更需要巢狀追蹤來釐清每一步的成本與耗時;當知識庫開放多人協作上傳,上傳前的惡意程式掃描就成了不可或缺的安全閘門;而把人機審核直接放進團隊日常使用的郵件與通訊軟體中,則徹底打通了 AI 自動化流程與人工決策之間的最後一哩路。對於想把 AI 代理真正放進日常營運流程的團隊而言,這套開源平台已具備從原型快速走向安全生產的完整拼圖。