agno v2.5.10 更新解析：并行搜索、全链路可观测性、多平台通信接口全面进化

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 修复为稳定运行保驾护航

我们相信人工智能为普通人提供了一种“增强工具”，并致力于分享全方位的AI知识。在这里，您可以找到最新的AI科普文章、工具评测、提升效率的秘籍以及行业洞察。 欢迎关注“福大大架构师每日一题”，发消息可获得面试资料，让AI助力您的未来发展。