agno v2.5.10 是一次功能密度極高、覆蓋面極廣的重要版本更新，集中在并行搜索能力、Agent 可觀測(cè)性、文檔處理、多平臺(tái)通信接口、工作流能力增強(qiáng)以及穩(wěn)定性修復(fù)等多個(gè)關(guān)鍵方向。
本次更新不僅擴(kuò)展了 agno 在企業(yè)級(jí) Agent 架構(gòu)中的能力邊界，也顯著提升了系統(tǒng)的穩(wěn)定性與可運(yùn)維性。

本文將完整、詳細(xì)、不遺漏地解讀 v2.5.10 的全部更新內(nèi)容，幫助你快速理解本次升級(jí)的技術(shù)價(jià)值與實(shí)際影響。

一、核心新增功能總覽

agno v2.5.10 的新增能力主要集中在以下幾個(gè)方面：

• ? 并行 AI 搜索與檢索增強(qiáng)

• ? Agent 與 Workflow 的全鏈路可觀測(cè)性

• ? 文檔處理能力擴(kuò)展

• ? WhatsApp 與 Telegram 通信接口大幅升級(jí)

• ? Workflow 與運(yùn)行參數(shù)能力增強(qiáng)

• ? 模型與多廠商支持升級(jí)

下面逐一展開(kāi)。

二、Parallel Search Tool：并行 AI 搜索能力正式落地 1. Vertex AI 并行搜索支持

本版本新增了Parallel AI Search工具，正式支持Vertex AI的并行搜索能力，并通過(guò)ToolParallelAiSearch進(jìn)行原生集成。

這項(xiàng)能力帶來(lái)的關(guān)鍵變化包括：

• ? Agent 可以同時(shí)向多個(gè)搜索源發(fā)起請(qǐng)求

• ? 搜索結(jié)果并行返回，顯著降低整體響應(yīng)時(shí)間

• ? 提升復(fù)雜問(wèn)題下的檢索覆蓋度與準(zhǔn)確率

• ? 為后續(xù)推理與生成提供更充分的上下文支撐

在 Gemini 相關(guān)能力中，新增了并行 Web 搜索 Grounding，讓模型在生成答案時(shí)可以同時(shí)參考多個(gè)實(shí)時(shí)搜索結(jié)果，進(jìn)一步提升事實(shí)性與時(shí)效性。

三、Observability：基于 MLflow 的全鏈路可觀測(cè)性 1. 引入 MLflow 作為可觀測(cè)性核心

agno v2.5.10 擴(kuò)展了 Observability 能力，正式引入MLflow，實(shí)現(xiàn) Agent 的完整執(zhí)行鏈路追蹤。

支持的能力包括：

• ? Agent 調(diào)用軌跡完整記錄

• ? Tool 調(diào)用與返回結(jié)果追蹤

• ? Workflow 各階段執(zhí)行可視化

• ? 輸入、輸出、上下文的統(tǒng)一關(guān)聯(lián)

通過(guò) MLflow 的集成，開(kāi)發(fā)者可以：

• ? 精準(zhǔn)定位 Agent 行為異常

• ? 分析推理路徑與上下文構(gòu)建過(guò)程

• ? 評(píng)估不同模型與參數(shù)組合的表現(xiàn)

• ? 為生產(chǎn)環(huán)境中的 Agent 提供可審計(jì)能力

這使 agno 在企業(yè)級(jí)、生產(chǎn)級(jí) Agent 系統(tǒng)中具備更強(qiáng)的可維護(hù)性。

四、Docling Reader：文檔處理能力全面增強(qiáng) 1. 集成 Docling 文檔處理庫(kù)

本次版本新增Docling Reader，作為全新的文檔讀取與解析組件。

它帶來(lái)的核心價(jià)值是：

• ? 支持多種文檔格式的統(tǒng)一處理

• ? 提供更結(jié)構(gòu)化、更高質(zhì)量的文檔解析結(jié)果

• ? 適配復(fù)雜文檔、長(zhǎng)文檔、非純文本內(nèi)容

Docling Reader 的加入，使得：

• ? Agent 可以更高效地處理企業(yè)文檔

• ? 文檔類(lèi) Workflow 的可擴(kuò)展性顯著提升

• ? 為后續(xù)檢索增強(qiáng)生成與知識(shí)問(wèn)答奠定基礎(chǔ)

WhatsApp 接口迎來(lái) V2 版本，新增了對(duì)以下內(nèi)容的支持：

• ? 圖片

• ? 視頻

• ? 音頻

• ? 文檔

Agent 不再局限于文本交互，可以處理真實(shí)業(yè)務(wù)場(chǎng)景中的多模態(tài)信息。

2. 交互式消息能力

新增多種交互消息類(lèi)型，包括：

• ? 回復(fù)按鈕

• ? 列表菜單

• ? 位置信息

• ? 消息反應(yīng)

這些能力使 Agent 能構(gòu)建更接近真實(shí)應(yīng)用的對(duì)話(huà)體驗(yàn)。

3. Team 與 Workflow 支持

WhatsApp 接口現(xiàn)已支持：

• ? Agent

• ? Team

• ? Workflow

同一入口即可驅(qū)動(dòng)復(fù)雜的多 Agent 協(xié)作流程。

4. 會(huì)話(huà)控制與安全增強(qiáng)

• ? 用戶(hù)可發(fā)送/new開(kāi)啟全新對(duì)話(huà)

• ? 新增enable_encryption參數(shù)，用于加密手機(jī)號(hào)，提升隱私與安全性

本版本新增 Telegram 接口，原生支持：

• ? Agent

• ? Team

• ? Workflow

并支持多模態(tài)輸入輸出。

2. 多模態(tài)與會(huì)話(huà)管理

Telegram 接口支持：

• ? 圖片、文檔、視頻、音頻、動(dòng)畫(huà)、貼紙等內(nèi)容發(fā)送

• ? 使用/new指令重置會(huì)話(huà)狀態(tài)

新增 Telegram Tools，使 Agent 能主動(dòng)發(fā)送：

• ? 照片

• ? 文檔

• ? 視頻

• ? 音頻

• ? 動(dòng)畫(huà)

• ? 貼紙等內(nèi)容

極大提升了 Agent 在 Telegram 平臺(tái)上的表達(dá)與交互能力。

七、Workflow 能力增強(qiáng)：版本與運(yùn)行級(jí)參數(shù) 1. Workflow 版本查詢(xún)能力

GET/workflows/{id}接口新增version查詢(xún)參數(shù)：

• ? 支持獲取指定版本的 Workflow

• ? 為回溯、調(diào)試和版本管理提供基礎(chǔ)能力

在 Workflow 的run()和arun()方法中，新增以下運(yùn)行級(jí)參數(shù)：

• ? metadata

• ? dependencies

• ? add_dependencies_to_context

• ? add_session_state_to_context

這些參數(shù)與 Agent / Team 保持一致，使 Workflow 的運(yùn)行控制更加精細(xì)和統(tǒng)一。

八、模型與多廠商支持升級(jí) 1. Mistral v2 支持

新增對(duì)mistralai v2的支持，并保持對(duì) v1 的向后兼容，方便平滑遷移。

2. Gemini 模型新增超時(shí)參數(shù)

Gemini 模型類(lèi)新增timeout參數(shù)：

• ? 可精確控制模型請(qǐng)求超時(shí)

• ? 提升系統(tǒng)在高并發(fā)與不穩(wěn)定網(wǎng)絡(luò)環(huán)境下的可靠性

本版本包含大量重要 Bug 修復(fù)，顯著提升系統(tǒng)穩(wěn)定性。

1. MCPTools 并行調(diào)用死鎖修復(fù)

• ? 修復(fù)并行 MCP 工具調(diào)用中，因 header_provider 導(dǎo)致的會(huì)話(huà)重復(fù)創(chuàng)建問(wèn)題

• ? 解決 Agent 卡死風(fēng)險(xiǎn)

• ? 移除不必要的快速路徑過(guò)期會(huì)話(huà)清理邏輯

• ? 修復(fù)流式模式下工具被重復(fù)執(zhí)行的問(wèn)題

• ? 使用列表推導(dǎo)避免共享字典引用導(dǎo)致的副作用

• ? 修復(fù) MongoDB 異步模塊導(dǎo)入錯(cuò)誤

• ? 修復(fù) Mongo 校驗(yàn)問(wèn)題

• ? Postgres 異步接口在表不存在時(shí)返回 None，而非錯(cuò)誤日志

• ? 使用基于前綴的結(jié)構(gòu)化輸出檢測(cè)方式

• ? 替換脆弱的 blocklist 機(jī)制

• ? 提升結(jié)構(gòu)化輸出判斷的可靠性

• ? 區(qū)分 chat 與 responses 指標(biāo)

• ? 避免混合統(tǒng)計(jì)帶來(lái)的分析誤差

• ? 注冊(cè) Telegram 接口到系統(tǒng)測(cè)試網(wǎng)關(guān)

• ? 使用合法的 Telegram Bot Token 格式

• ? PR 分流與自動(dòng)化管理流程改進(jìn)

• ? 合并并簡(jiǎn)化 PR triage 工作流

• ? 自動(dòng)關(guān)閉噪音 PR，提升倉(cāng)庫(kù)維護(hù)效率

• ? 版本號(hào)：v2.5.10

• ? 提交數(shù)量：26

• ? 修改文件數(shù)：139

• ? 貢獻(xiàn)人數(shù)：21

• ? 發(fā)布時(shí)間：2026 年 3 月

代碼地址：bgithub.xyz/agno-agi/agno

agno v2.5.10 并不是一次簡(jiǎn)單的功能疊加，而是一次面向生產(chǎn)、面向多平臺(tái)、面向復(fù)雜 Agent 系統(tǒng)的系統(tǒng)級(jí)升級(jí)：

• ? 并行搜索與檢索讓 Agent 更快、更準(zhǔn)

• ? MLflow 可觀測(cè)性讓 Agent 更可控、更可信

• ? Docling Reader 打開(kāi)文檔處理新邊界

• ? WhatsApp 與 Telegram 接口讓 Agent 真正走向真實(shí)用戶(hù)

• ? Workflow 與模型能力增強(qiáng)讓系統(tǒng)更靈活

• ? 大量 Bug 修復(fù)為穩(wěn)定運(yùn)行保駕護(hù)航

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