北京
agno v2.5.10 是一次功能密度極高、覆蓋面極廣的重要版本更新，集中在并行搜索能力、Agent 可觀測性、文檔處理、多平臺通信接口、工作流能力增強以及穩定性修復等多個關鍵方向。
本次更新不僅擴展了 agno 在企業級 Agent 架構中的能力邊界，也顯著提升了系統的穩定性與可運維性。
本文將完整、詳細、不遺漏地解讀 v2.5.10 的全部更新內容，幫助你快速理解本次升級的技術價值與實際影響。
一、核心新增功能總覽
agno v2.5.10 的新增能力主要集中在以下幾個方面：
? 并行 AI 搜索與檢索增強
? Agent 與 Workflow 的全鏈路可觀測性
? 文檔處理能力擴展
? WhatsApp 與 Telegram 通信接口大幅升級
? Workflow 與運行參數能力增強
? 模型與多廠商支持升級
下面逐一展開。
二、Parallel Search Tool：并行 AI 搜索能力正式落地 1. Vertex AI 并行搜索支持
本版本新增了Parallel AI Search工具，正式支持Vertex AI的并行搜索能力，并通過ToolParallelAiSearch進行原生集成。
這項能力帶來的關鍵變化包括：
? Agent 可以同時向多個搜索源發起請求
? 搜索結果并行返回，顯著降低整體響應時間
? 提升復雜問題下的檢索覆蓋度與準確率
? 為后續推理與生成提供更充分的上下文支撐
在 Gemini 相關能力中，新增了并行 Web 搜索 Grounding，讓模型在生成答案時可以同時參考多個實時搜索結果，進一步提升事實性與時效性。
三、Observability：基于 MLflow 的全鏈路可觀測性 1. 引入 MLflow 作為可觀測性核心
agno v2.5.10 擴展了 Observability 能力，正式引入MLflow，實現 Agent 的完整執行鏈路追蹤。
支持的能力包括：
? Agent 調用軌跡完整記錄
? Tool 調用與返回結果追蹤
? Workflow 各階段執行可視化
? 輸入、輸出、上下文的統一關聯
通過 MLflow 的集成，開發者可以：
? 精準定位 Agent 行為異常
? 分析推理路徑與上下文構建過程
? 評估不同模型與參數組合的表現
? 為生產環境中的 Agent 提供可審計能力
這使 agno 在企業級、生產級 Agent 系統中具備更強的可維護性。
四、Docling Reader：文檔處理能力全面增強 1. 集成 Docling 文檔處理庫
本次版本新增Docling Reader，作為全新的文檔讀取與解析組件。
它帶來的核心價值是：
? 支持多種文檔格式的統一處理
? 提供更結構化、更高質量的文檔解析結果
? 適配復雜文檔、長文檔、非純文本內容
Docling Reader 的加入，使得：
? Agent 可以更高效地處理企業文檔
? 文檔類 Workflow 的可擴展性顯著提升
? 為后續檢索增強生成與知識問答奠定基礎
WhatsApp 接口迎來 V2 版本，新增了對以下內容的支持：
? 圖片
? 視頻
? 音頻
? 文檔
Agent 不再局限于文本交互，可以處理真實業務場景中的多模態信息。
2. 交互式消息能力
新增多種交互消息類型，包括：
? 回復按鈕
? 列表菜單
? 位置信息
? 消息反應
這些能力使 Agent 能構建更接近真實應用的對話體驗。
3. Team 與 Workflow 支持
WhatsApp 接口現已支持：
? Agent
? Team
? Workflow
同一入口即可驅動復雜的多 Agent 協作流程。
4. 會話控制與安全增強
? 用戶可發送
/new開啟全新對話? 新增
enable_encryption參數，用于加密手機號，提升隱私與安全性
本版本新增 Telegram 接口，原生支持：
? Agent
? Team
? Workflow
并支持多模態輸入輸出。
2. 多模態與會話管理
Telegram 接口支持：
? 圖片、文檔、視頻、音頻、動畫、貼紙等內容發送
? 使用
/new指令重置會話狀態
新增 Telegram Tools，使 Agent 能主動發送：
? 照片
? 文檔
? 視頻
? 音頻
? 動畫
? 貼紙等內容
極大提升了 Agent 在 Telegram 平臺上的表達與交互能力。
七、Workflow 能力增強：版本與運行級參數 1. Workflow 版本查詢能力
GET/workflows/{id}接口新增version查詢參數：
? 支持獲取指定版本的 Workflow
? 為回溯、調試和版本管理提供基礎能力
在 Workflow 的run()和arun()方法中，新增以下運行級參數：
? metadata
? dependencies
? add_dependencies_to_context
? add_session_state_to_context
這些參數與 Agent / Team 保持一致，使 Workflow 的運行控制更加精細和統一。
八、模型與多廠商支持升級 1. Mistral v2 支持
新增對mistralai v2的支持，并保持對 v1 的向后兼容，方便平滑遷移。
2. Gemini 模型新增超時參數
Gemini 模型類新增timeout參數：
? 可精確控制模型請求超時
? 提升系統在高并發與不穩定網絡環境下的可靠性
本版本包含大量重要 Bug 修復，顯著提升系統穩定性。
1. MCPTools 并行調用死鎖修復
? 修復并行 MCP 工具調用中，因 header_provider 導致的會話重復創建問題
? 解決 Agent 卡死風險
? 移除不必要的快速路徑過期會話清理邏輯
? 修復流式模式下工具被重復執行的問題
? 使用列表推導避免共享字典引用導致的副作用
? 修復 MongoDB 異步模塊導入錯誤
? 修復 Mongo 校驗問題
? Postgres 異步接口在表不存在時返回 None，而非錯誤日志
? 使用基于前綴的結構化輸出檢測方式
? 替換脆弱的 blocklist 機制
? 提升結構化輸出判斷的可靠性
? 區分 chat 與 responses 指標
? 避免混合統計帶來的分析誤差
? 注冊 Telegram 接口到系統測試網關
? 使用合法的 Telegram Bot Token 格式
? PR 分流與自動化管理流程改進
? 合并并簡化 PR triage 工作流
? 自動關閉噪音 PR，提升倉庫維護效率
? 版本號：v2.5.10
? 提交數量：26
? 修改文件數：139
? 貢獻人數：21
? 發布時間：2026 年 3 月
代碼地址：bgithub.xyz/agno-agi/agno
agno v2.5.10 并不是一次簡單的功能疊加，而是一次面向生產、面向多平臺、面向復雜 Agent 系統的系統級升級：
? 并行搜索與檢索讓 Agent 更快、更準
? MLflow 可觀測性讓 Agent 更可控、更可信
? Docling Reader 打開文檔處理新邊界
? WhatsApp 與 Telegram 接口讓 Agent 真正走向真實用戶
? Workflow 與模型能力增強讓系統更靈活
? 大量 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.
