返回首頁

GitHub Repo

Dify 1.18.0 加入代理分支路由,Agent 執行協定升級須同步部署

Dify 於 10 月 23 日發布 1.18.0,讓 Agent 在完成任務時直接選擇工作流程分支,並擴充巢狀流程追蹤。新版也更換 Agent 執行協定,後端與執行環境必須同步升級,舊版無法讀取新版儲存的工作階段快照。

The original uploader was Ggia at Greek Wikipedia. · CC BY-SA 2.5 · Image source
zh-Hant

Dify 於 10 月 23 日發布 1.18.0,將代理決策接入工作流程的分支控制。開發者可在 Agent v2 節點啟用 Output Routes,為不同出口設定選擇條件,讓代理完成任務後決定下一步,例如直接回覆或交給其他專業代理。版本公告

這項功能把任務處理與分支選擇放在同一次代理呼叫。依已合併的實作說明,啟用路由須設定至少兩條分支;系統會建立必要的 switch 字串輸出,以固定路由 ID 作為允許值,再將選定出口交給工作流程引擎。switch 是唯讀系統輸出,路由條件也會隨發布、複製與 DSL 序列化保存。工程上的意義是,後續節點能依明確出口執行,減少另外解析自然語言回答的需求。路由實作說明

路由有相容性限制:啟用後可在錯誤時停止或走失敗分支,但不能搭配節點層級的預設值錯誤處理。一般 Agent v2 文字輸出新增串流,結構化結果、路由結果及使用預設值處理錯誤的節點仍採緩衝輸出。官方文件另說明,新 Agent 節點仍屬 Beta,各節點擁有獨立沙箱;檔案與工具安裝狀態不會在節點間自動傳遞,結果須透過宣告輸出交接。Agent 文件

部署端更需要留意執行協定切換。新版 /runs 接受 composition v2 並拒絕 v1;既有工作階段快照會在讀取時轉換,重新保存後舊 runtime 無法讀取。因此 API、worker、Agent Backend 與 runtime 映像須同步更新,直接串接後端的程式也須調整請求格式。本機沙箱則要求非空驗證 token。升級指南

對維運團隊而言,驗證重點應包含分支選擇、失敗出口與既有工作階段恢復。新版雖能在介面深入查看巢狀工作流程,但官方仍提示,暫停或停止後的巢狀用量及步數可能只是近似值;評估成本與追蹤完整性時,仍須以實際工作負載核對。

來源

  1. Dify 1.18.0 release notes and upgrade guide
  2. Add output routes to Agent v2 — PR #42599
  3. Agent node documentation