北京
一、版本信息
版本號：v2.4.0
發布時間：2026年1月18日
agno v2.4.0版本正式發布，本次更新堪稱一次全方位的系統級升級。它不僅引入了全新的知識協議（KnowledgeProtocol）和Agent持久化能力，還在事件系統、數據庫管理、文件輸入支持、接口一致性等多個層面帶來重要提升。下面我們將詳細梳理此次更新的全部變更內容。
二、新特性（New Features） 1. Knowledge Protocol引入
本次版本新增了KnowledgeProtocol。
主要變化：
? 主 Knowledge 實現現在符合這一接口標準。
? 任何其他實現都可以與 Agent 或 Team 一起使用。
? 目前，只有主 Agno Knowledge 實現支持 AgentOS 知識管理。
這意味著知識體系更加模塊化，開發者可通過協議切換不同知識實現，提升可擴展性。
2. Agent Builder：支持持久化與管理
用戶現在可以直接在數據庫中持久化并管理 Agent、Team 和 Workflow 配置。
AgentOS 提供新的端點以編程方式創建、檢索和更新組件定義，實現配置的統一管理和自動化部署。
3. 新增事件類型
新增以下系統事件：
? 模型事件：
ModelRequestStarted和ModelRequestCompleted? 壓縮事件：
CompressionStarted和CompressionCompleted? 記憶事件：
MemoryUpdateCompleted現在包含完整內存內容。
使運行時跟蹤與監控更加細致。
4. Gemini文件輸入增強
支持直接通過 GCS（Google Cloud Storage）和外部 URL輸入 Gemini 文件，顯著擴展文件來源的靈活性。
5. TavilyTools擴展
新增api_base_url參數，用于自定義托管場景，方便企業或本地部署使用。
三、性能與功能改進（Improvements） 1. AgentOS默認數據庫機制
新增默認數據庫（db）至 AgentOS 類：
? 若填充，則自動傳播至所有 agent、team 和 workflow。
? 用作追蹤數據庫（tracing db）。
簡化了配置層級，降低冗余。
棄用enable_user_memories，改用update_memory_on_run實現同樣行為，參數命名更清晰直觀。
3. Knowledge配置端點優化
在檢查可用讀取器時，無需實例化 reader 類，減少不必要警告、加快響應速度。
4. 日期格式統一
所有通過 OS API 傳遞的日期格式現已統一為 UTC datetime，提高跨系統一致性。
5. AgentOS路徑處理優化
新增TrailingSlashMiddleware：
? 自動去除請求路徑尾部斜杠。
? 所有端點返回內容完全一致，不再產生 307 重定向。
Agent 與 Team 的系統消息中指令不再使用
標簽。
新增add_instruction_tags=True參數，可恢復舊版結構化提示行為。
四、問題修復（Bug Fixes）
?LanceDB：解決異步插入或更新時可能出現的重復嵌入問題。
?Qdrant異步搜索：改進異步搜索方法，防止事件循環阻塞。
?CSV Reader：修復 BytesIO 輸入編碼參數忽略問題，現在可正確使用自定義編碼。
?PDF Reader：修復空字符串密碼被視為 None 的錯誤。
?Openrouter與Gemini：保持 Gemini 的
reasoning_details字段，修復多輪對話異常。?MongoDB異步搜索：更改使用
async_get_embedding()，消除阻塞問題。?Gemini Vertex AI文件上傳：修復上傳時 API 報 400 的問題。
?Skills系統提示：修正 Agent 調用技能名作為函數導致的“Function not found”錯誤。
這一系列修復顯著提高穩定性與異步操作效率。
五、重大變更（Breaking Changes）
?刪除所有已廢棄字段：包括
session_state、dependencies、user_id等，統一由RunContext替代。? 參數及方法變更：
?
stream_intermediate_steps→stream_events?
yield_run_response→yield_run_output
?Team類變更：移除
delegate_task_to_all_members方法。?Web搜索工具重構：
? 新增WebSearchTools，替代舊 DDG 搜索工具。
? 作為默認 web 搜索工具應用于 cookbook 與文檔中。
?Knowledge方法重命名：
?
add_content()→insert()?
add_content_many()→insert_many()
舊方法仍兼容，但未來文檔將僅支持新命名。
?AgentOS參數調整：
? 棄用
tracing_db，統一使用db參數。
代碼地址：github.com/agno-agi/agno
agno v2.4.0 是一次具有里程碑意義的版本更新。
核心亮點包括：
?知識協議標準化，讓知識系統更模塊化。
?Agent Builder數據庫化，實現配置持久化與自動管理。
?事件體系擴展與性能優化，增強系統追蹤與穩定性。
?文件輸入與搜索工具升級，適配更豐富的場景。
?全面的Bug修復與接口統一規范化，提升一致性與開發體驗。
我們相信人工智能為普通人提供了一種“增強工具”，并致力于分享全方位的AI知識。在這里，您可以找到最新的AI科普文章、工具評測、提升效率的秘籍以及行業洞察。 歡迎關注“福大大架構師每日一題”，發消息可獲得面試資料，讓AI助力您的未來發展。
特別聲明：以上內容(如有圖片或視頻亦包括在內)為自媒體平臺“網易號”用戶上傳并發布，本平臺僅提供信息存儲服務。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.
