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 可以同时向多个搜索源发起请求

• • 搜索结果并行返回，显著降低整体响应时间

• • 提升复杂问题下的检索覆盖度与准确率

• • 为后续推理与生成提供更充分的上下文支撑

在 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助力您的未来发展。