在 2025 年 11 月 8 日，agno 發佈了最新版本 v2.2.10。本次更新主要圍繞 Workflows 的運行上下文管理、事件流處理以及 AgentOS 的穩定性優化進行了改進，同時對一些舊的參數進行了調整與棄用規劃，並修復了多個已知問題。以下是版本更新的詳細説明。
改進內容
- Workflow運行上下文（run_context）改進
- 新增並推薦使用
run_context參數來讀取和修改 Workflows 中的狀態數據。 - 適用範圍包括：Agents、Teams、tools、steps 以及在 steps 使用的自定義 Python 函數。
- 官方文檔已提供 Workflow 狀態的詳細説明，建議開發者全面遷移至新的
run_context方式，以替代舊的處理模式。
- 自定義執行器（custom executors）事件流增強
- 對 Workflows 中自定義 executor 步驟的 Agent/Team 事件處理方式進行了多項優化。
- 事件流在執行器中傳遞的穩定性和後續處理能力得到提升，從而減少事件丟失或延遲的情況。
- 新增
yield_run_output參數
- 在 Agent/Team 的
run/arun方法中新增了yield_run_output參數，建議開發者使用該參數替代yield_run_response。 - 舊參數
yield_run_response已進入棄用計劃，後續版本中可能會移除。
修復內容
- AgentOS Resync /docs問題修復
- 修復了在 AgentOS resync 過程中
/docs接口被意外移除的問題，確保文檔接口在同步流程中保持可用。
- 路由重複問題修復
- 移除了 home 路由在初始化過程中的重複添加問題，避免了路由衝突和冗餘。
- Workflow事件流相關問題修復
- 修復了 Workflow 步驟事件流處理不穩定的問題。
- 針對自定義執行器事件的 upsert 操作進行了問題修復，提高事件監聽與處理的準確性。
- 解決了 run_context 參數在特定場景下的使用故障。
總結
agno v2.2.10 在 Workflows 系統中引入了更標準化和推薦的狀態數據處理方式，同時顯著強化了事件流在複雜執行環境下的穩定性。本次更新還帶來了更明確的參數規劃，開發者在遷移和升級項目時需要留意 yield_run_output 與被棄用的 yield_run_response 的變化。 、
