一、版本信息

版本號(hào)：v2.4.0
發(fā)布時(shí)間：2026年1月18日

agno v2.4.0版本正式發(fā)布，本次更新堪稱一次全方位的系統(tǒng)級(jí)升級(jí)。它不僅引入了全新的知識(shí)協(xié)議（KnowledgeProtocol）和Agent持久化能力，還在事件系統(tǒng)、數(shù)據(jù)庫管理、文件輸入支持、接口一致性等多個(gè)層面帶來重要提升。下面我們將詳細(xì)梳理此次更新的全部變更內(nèi)容。

二、新特性（New Features） 1. Knowledge Protocol引入

本次版本新增了KnowledgeProtocol。
主要變化：

• ? 主 Knowledge 實(shí)現(xiàn)現(xiàn)在符合這一接口標(biāo)準(zhǔn)。

• ? 任何其他實(shí)現(xiàn)都可以與 Agent 或 Team 一起使用。

• ? 目前，只有主 Agno Knowledge 實(shí)現(xiàn)支持 AgentOS 知識(shí)管理。

這意味著知識(shí)體系更加模塊化，開發(fā)者可通過協(xié)議切換不同知識(shí)實(shí)現(xiàn)，提升可擴(kuò)展性。

2. Agent Builder：支持持久化與管理

用戶現(xiàn)在可以直接在數(shù)據(jù)庫中持久化并管理 Agent、Team 和 Workflow 配置。
AgentOS 提供新的端點(diǎn)以編程方式創(chuàng)建、檢索和更新組件定義，實(shí)現(xiàn)配置的統(tǒng)一管理和自動(dòng)化部署。

3. 新增事件類型

新增以下系統(tǒng)事件：

• ? 模型事件：ModelRequestStarted和ModelRequestCompleted

• ? 壓縮事件：CompressionStarted和CompressionCompleted

• ? 記憶事件：MemoryUpdateCompleted現(xiàn)在包含完整內(nèi)存內(nèi)容。

使運(yùn)行時(shí)跟蹤與監(jiān)控更加細(xì)致。

4. Gemini文件輸入增強(qiáng)

支持直接通過 GCS（Google Cloud Storage）和外部 URL輸入 Gemini 文件，顯著擴(kuò)展文件來源的靈活性。

5. TavilyTools擴(kuò)展

新增api_base_url參數(shù)，用于自定義托管場景，方便企業(yè)或本地部署使用。

三、性能與功能改進(jìn)（Improvements） 1. AgentOS默認(rèn)數(shù)據(jù)庫機(jī)制

新增默認(rèn)數(shù)據(jù)庫（db）至 AgentOS 類：

• ? 若填充，則自動(dòng)傳播至所有 agent、team 和 workflow。

• ? 用作追蹤數(shù)據(jù)庫（tracing db）。
  簡化了配置層級(jí)，降低冗余。

棄用enable_user_memories，改用update_memory_on_run實(shí)現(xiàn)同樣行為，參數(shù)命名更清晰直觀。

3. Knowledge配置端點(diǎn)優(yōu)化

在檢查可用讀取器時(shí)，無需實(shí)例化 reader 類，減少不必要警告、加快響應(yīng)速度。

4. 日期格式統(tǒng)一

所有通過 OS API 傳遞的日期格式現(xiàn)已統(tǒng)一為 UTC datetime，提高跨系統(tǒng)一致性。

5. AgentOS路徑處理優(yōu)化

新增TrailingSlashMiddleware：

• ? 自動(dòng)去除請(qǐng)求路徑尾部斜杠。

• ? 所有端點(diǎn)返回內(nèi)容完全一致，不再產(chǎn)生 307 重定向。

Agent 與 Team 的系統(tǒng)消息中指令不再使用 標(biāo)簽。
新增add_instruction_tags=True參數(shù)，可恢復(fù)舊版結(jié)構(gòu)化提示行為。

四、問題修復(fù)（Bug Fixes）

• ?LanceDB：解決異步插入或更新時(shí)可能出現(xiàn)的重復(fù)嵌入問題。

• ?Qdrant異步搜索：改進(jìn)異步搜索方法，防止事件循環(huán)阻塞。

• ?CSV Reader：修復(fù) BytesIO 輸入編碼參數(shù)忽略問題，現(xiàn)在可正確使用自定義編碼。

• ?PDF Reader：修復(fù)空字符串密碼被視為 None 的錯(cuò)誤。

• ?Openrouter與Gemini：保持 Gemini 的reasoning_details字段，修復(fù)多輪對(duì)話異常。

• ?MongoDB異步搜索：更改使用async_get_embedding()，消除阻塞問題。

• ?Gemini Vertex AI文件上傳：修復(fù)上傳時(shí) API 報(bào) 400 的問題。

• ?Skills系統(tǒng)提示：修正 Agent 調(diào)用技能名作為函數(shù)導(dǎo)致的“Function not found”錯(cuò)誤。

這一系列修復(fù)顯著提高穩(wěn)定性與異步操作效率。

五、重大變更（Breaking Changes）

• ?刪除所有已廢棄字段：包括session_state、dependencies、user_id等，統(tǒng)一由RunContext替代。

• ? 參數(shù)及方法變更：

• • ?stream_intermediate_steps→stream_events

  • ?yield_run_response→yield_run_output

• ?Team類變更：移除delegate_task_to_all_members方法。

• ?Web搜索工具重構(gòu)：

• • ? 新增WebSearchTools，替代舊 DDG 搜索工具。

  • ? 作為默認(rèn) web 搜索工具應(yīng)用于 cookbook 與文檔中。

• ?Knowledge方法重命名：

• • ?add_content()→insert()

  • ?add_content_many()→insert_many()
    舊方法仍兼容，但未來文檔將僅支持新命名。

• ?AgentOS參數(shù)調(diào)整：

• • ? 棄用tracing_db，統(tǒng)一使用db參數(shù)。

代碼地址：github.com/agno-agi/agno

agno v2.4.0 是一次具有里程碑意義的版本更新。
核心亮點(diǎn)包括：

• ?知識(shí)協(xié)議標(biāo)準(zhǔn)化，讓知識(shí)系統(tǒng)更模塊化。

• ?Agent Builder數(shù)據(jù)庫化，實(shí)現(xiàn)配置持久化與自動(dòng)管理。

• ?事件體系擴(kuò)展與性能優(yōu)化，增強(qiáng)系統(tǒng)追蹤與穩(wěn)定性。

• ?文件輸入與搜索工具升級(jí)，適配更豐富的場景。

• ?全面的Bug修復(fù)與接口統(tǒng)一規(guī)范化，提升一致性與開發(fā)體驗(yàn)。

我們相信人工智能為普通人提供了一種“增強(qiáng)工具”，并致力于分享全方位的AI知識(shí)。在這里，您可以找到最新的AI科普文章、工具評(píng)測、提升效率的秘籍以及行業(yè)洞察。 歡迎關(guān)注“福大大架構(gòu)師每日一題”，發(fā)消息可獲得面試資料，讓AI助力您的未來發(fā)展。