返回首頁

GitHub Repo

Dify 1.19.0 加入巢狀工作流程追蹤,滾動升級須分流新舊佇列

Dify 於 11 月 4 日發布 1.19.0,讓外部觀測工具看見 Workflow Tool 內部的執行步驟與模型呼叫。更新同時重整追蹤管線,採滾動部署的團隊須處理新舊任務佇列交接。

karahavet · CC BY-SA 4.0 · Image source
zh-Hant

Dify 於 11 月 4 日發布 1.19.0,將巢狀工作流程的內部步驟納入外部追蹤。當主流程呼叫 Workflow Tool,工具內已持久化的子步驟會掛在該次工具呼叫的 span 下,保留重複呼叫、失敗及更深層呼叫的關係,並呈現格式化提示、回應與 token 用量。官方版本說明

這項變更補強了可重用流程的除錯能力。例如,同一工具被呼叫數次後只有一次失敗,工程師可沿執行樹定位該次呼叫,再檢查模型收到的上下文。這是依新增追蹤結構可推導的用途,官方未提供除錯時間縮短的量測。Langfuse 原有整合仍透過 Dify 的 Monitoring 設定啟用,建立專案憑證後,由應用的介面或 API 呼叫產生追蹤資料。Langfuse 整合文件

底層也有實質重整:相關修補將原先重疊的追蹤路徑收斂成共用管線,供應商透過一致介面接收中立的 span 樹。識別碼採確定性設計,重送時更新同一筆紀錄;傳送失敗則區分可重試、遭拒及結果不明,讓重試處理有明確依據。追蹤重構提案

部署端須留意,新任務預設送往 ops_trace_v2,API、worker 與 Beat 的設定必須一致,自訂佇列訂閱也要納入它。滾動升級期間,舊 worker 應繼續處理 ops_trace,待舊生產端停止、排隊與延遲重試工作清空後再退場,避免新舊負載交錯。升級與佇列交接說明

此次較完整的階層只適用於新執行,歷史追蹤不會回補;獨立的巢狀流程仍以父識別碼連結不同 trace。工程團隊升級後應用重複呼叫、失敗與重試案例核對實際匯出結果,並確認既有儀表板能處理新的 span 結構。版本限制

來源

  1. Dify 1.19.0:Trace Your Workflows, Layer by Layer
  2. 追蹤重構:共用管線與最小供應商介面
  3. Observability and tracing for Dify