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 可以同时向多个搜索源发起请求
• 搜索结果并行返回，显著降低整体响应时间
• 提升复杂问题下的检索覆盖度与准确率
• 为后续推理与生成提供更充分的上下文支撑

2. 并行 Web Search Grounding（Gemini）

在 Gemini 相关能力中，新增了 并行 Web 搜索 Grounding，让模型在生成答案时可以同时参考多个实时搜索结果，进一步提升事实性与时效性。

---

三、Observability：基于 MLflow 的全链路可观测性

1. 引入 MLflow 作为可观测性核心

agno v2.5.10 扩展了 Observability 能力，正式引入 MLflow，实现 Agent 的完整执行链路追踪。

支持的能力包括：

• Agent 调用轨迹完整记录
• Tool 调用与返回结果追踪
• Workflow 各阶段执行可视化
• 输入、输出、上下文的统一关联

2. 全 Trace 级别的 Agent 可观测性

通过 MLflow 的集成，开发者可以：

• 精准定位 Agent 行为异常
• 分析推理路径与上下文构建过程
• 评估不同模型与参数组合的表现
• 为生产环境中的 Agent 提供可审计能力

这使 agno 在 企业级、生产级 Agent 系统 中具备更强的可维护性。

---

四、Docling Reader：文档处理能力全面增强

1. 集成 Docling 文档处理库

本次版本新增 Docling Reader，作为全新的文档读取与解析组件。

它带来的核心价值是：

• 支持多种文档格式的统一处理
• 提供更结构化、更高质量的文档解析结果
• 适配复杂文档、长文档、非纯文本内容

2. 对 Agent 与 Workflow 的意义

Docling Reader 的加入，使得：

• Agent 可以更高效地处理企业文档
• 文档类 Workflow 的可扩展性显著提升
• 为后续检索增强生成与知识问答奠定基础

---

五、WhatsApp Interface V2：通信能力质变升级

1. 媒体与多模态支持

WhatsApp 接口迎来 V2 版本，新增了对以下内容的支持：

• 图片
• 视频
• 音频
• 文档

Agent 不再局限于文本交互，可以处理真实业务场景中的多模态信息。

2. 交互式消息能力

新增多种交互消息类型，包括：

• 回复按钮
• 列表菜单
• 位置信息
• 消息反应

这些能力使 Agent 能构建更接近真实应用的对话体验。

3. Team 与 Workflow 支持

WhatsApp 接口现已支持：

• Agent
• Team
• Workflow

同一入口即可驱动复杂的多 Agent 协作流程。

4. 会话控制与安全增强

• 用户可发送 /new 开启全新对话
• 新增 enable_encryption 参数，用于加密手机号，提升隐私与安全性

---

六、Telegram Interface：全新通信通道正式加入

1. Telegram 接口全面支持 AgentOS

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

• Agent
• Team
• Workflow

并支持多模态输入输出。

2. 多模态与会话管理

Telegram 接口支持：

• 图片、文档、视频、音频、动画、贴纸等内容发送
• 使用 /new 指令重置会话状态

3. Telegram Tools 能力扩展

新增 Telegram Tools，使 Agent 能主动发送：

• 照片
• 文档
• 视频
• 音频
• 动画
• 贴纸等内容

极大提升了 Agent 在 Telegram 平台上的表达与交互能力。

---

七、Workflow 能力增强：版本与运行级参数

1. Workflow 版本查询能力

GET /workflows/{id} 接口新增 version 查询参数：

• 支持获取指定版本的 Workflow
• 为回溯、调试和版本管理提供基础能力

2. Run 级参数支持

在 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 卡死风险
• 移除不必要的快速路径过期会话清理逻辑

2. Streaming Tool Calls 修复

• 修复流式模式下工具被重复执行的问题
• 使用列表推导避免共享字典引用导致的副作用

3. 数据库相关修复

• 修复 MongoDB 异步模块导入错误
• 修复 Mongo 校验问题
• Postgres 异步接口在表不存在时返回 None，而非错误日志

4. Claude 结构化输出检测修复

• 使用基于前缀的结构化输出检测方式
• 替换脆弱的 blocklist 机制
• 提升结构化输出判断的可靠性

5. 指标与监控改进

• 区分 chat 与 responses 指标
• 避免混合统计带来的分析误差

---

十、系统与工程层面改进

1. Telegram 系统测试修复

• 注册 Telegram 接口到系统测试网关
• 使用合法的 Telegram Bot Token 格式

2. 自动化与流程优化

• PR 分流与自动化管理流程改进
• 合并并简化 PR triage 工作流
• 自动关闭噪音 PR，提升仓库维护效率

---

十一、版本发布信息汇总

• 版本号：v2.5.10
• 提交数量：26
• 修改文件数：139
• 贡献人数：21
• 发布时间：2026 年 3 月

---

十二、总结：agno v2.5.10 的整体价值

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

agno v2.5.10 并不是一次简单的功能叠加，而是一次 面向生产、面向多平台、面向复杂 Agent 系统 的系统级升级：

• 并行搜索与检索让 Agent 更快、更准
• MLflow 可观测性让 Agent 更可控、更可信
• Docling Reader 打开文档处理新边界
• WhatsApp 与 Telegram 接口让 Agent 真正走向真实用户
• Workflow 与模型能力增强让系统更灵活
• 大量 Bug 修复为稳定运行保驾护航