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助力您的未来发展。
热门跟贴