返回首頁

GitHub Repo

LangChain 提出串流錯誤事件修補,避免失敗代理步驟持續顯示執行中

LangChain 於 11 月 12 日提出修補,補上 astream_events v2 在部分執行失敗時缺少的終止事件。提案涵蓋重試與備援流程,但尚未合併,介面也須區分真正失敗與控制流程中斷。

Dirck van Baburen · Public domain · Image source
zh-Hant

LangChain 於 11 月 12 日提交 PR #41820,處理 astream_events(version="v2") 的執行生命週期缺口:鏈、模型或檢索器拋出例外後,事件流可能只有開始事件,沒有對應的錯誤事件。這是針對既有問題的新修補進展;截至查核時,提案仍開放審查,尚未合併。修補提案

原始議題在 10 月提出,附有不需模型服務的最小重現:讓 RunnableLambda 直接拋出 ValueError,再收集串流事件。呼叫端仍會收到例外,但事件清單缺少終止訊號。回報也涵蓋備援流程:第一個子任務失敗後,後續備援可以繼續,失敗子任務卻沒有事件可供收尾。原始回報

這會影響依事件追蹤進度的代理介面。官方文件說明,每次執行具有自己的 run_id,v2 另以 parent_ids 表示父子關係,讓前端重建執行樹。依此機制推論,只把開始與結束事件配對的消費端,可能留下無法關閉的步驟,即使整體流程已完成備援。API 文件

提案指出,事件處理器原先僅為工具實作錯誤處理。修補將為其他類型補送錯誤事件,並移除內部執行紀錄;例如聊天模型失敗時送出 on_chat_model_error,資料包含例外與輸入。重試流程因此可呈現「開始、錯誤、再次開始、完成」,讓每次嘗試都有明確結局。修補設計

工程團隊仍須注意事件語意:提案也會把 LangGraph 的 GraphInterrupt 等控制流程例外送入錯誤事件,不能看到 _error 就一律標成故障。接下來應追蹤審查與正式版本,並以重試、備援及人工中斷案例驗證介面狀態;目前公開證據尚未界定完整受影響版本範圍。審查注意事項

來源

  1. fix(core): end failed runs with an error event in astream_events v2 — PR #41820
  2. astream_events v2 does not emit terminal error events for failed runs — Issue #41141
  3. Runnable.astream_events API reference