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 GroundingGemini在 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 接口现已支持AgentTeamWorkflow同一入口即可驱动复杂的多 Agent 协作流程。4. 会话控制与安全增强用户可发送/new开启全新对话新增enable_encryption参数用于加密手机号提升隐私与安全性六、Telegram Interface全新通信通道正式加入1. Telegram 接口全面支持 AgentOS本版本新增 Telegram 接口原生支持AgentTeamWorkflow并支持多模态输入输出。2. 多模态与会话管理Telegram 接口支持图片、文档、视频、音频、动画、贴纸等内容发送使用/new指令重置会话状态3. Telegram Tools 能力扩展新增 Telegram Tools使 Agent 能主动发送照片文档视频音频动画贴纸等内容极大提升了 Agent 在 Telegram 平台上的表达与交互能力。七、Workflow 能力增强版本与运行级参数1. Workflow 版本查询能力GET/workflows/{id}接口新增version查询参数支持获取指定版本的 Workflow为回溯、调试和版本管理提供基础能力2. Run 级参数支持在 Workflow 的run()和arun()方法中新增以下运行级参数metadatadependenciesadd_dependencies_to_contextadd_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/agnoagno v2.5.10 并不是一次简单的功能叠加而是一次面向生产、面向多平台、面向复杂 Agent 系统的系统级升级并行搜索与检索让 Agent 更快、更准MLflow 可观测性让 Agent 更可控、更可信Docling Reader 打开文档处理新边界WhatsApp 与 Telegram 接口让 Agent 真正走向真实用户Workflow 与模型能力增强让系统更灵活大量 Bug 修复为稳定运行保驾护航
agno v2.5.10 更新解析：并行搜索、全链路可观测性、多平台通信接口全面进化
发布时间：2026/6/19 2:26:28
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 GroundingGemini在 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 接口现已支持AgentTeamWorkflow同一入口即可驱动复杂的多 Agent 协作流程。4. 会话控制与安全增强用户可发送/new开启全新对话新增enable_encryption参数用于加密手机号提升隐私与安全性六、Telegram Interface全新通信通道正式加入1. Telegram 接口全面支持 AgentOS本版本新增 Telegram 接口原生支持AgentTeamWorkflow并支持多模态输入输出。2. 多模态与会话管理Telegram 接口支持图片、文档、视频、音频、动画、贴纸等内容发送使用/new指令重置会话状态3. Telegram Tools 能力扩展新增 Telegram Tools使 Agent 能主动发送照片文档视频音频动画贴纸等内容极大提升了 Agent 在 Telegram 平台上的表达与交互能力。七、Workflow 能力增强版本与运行级参数1. Workflow 版本查询能力GET/workflows/{id}接口新增version查询参数支持获取指定版本的 Workflow为回溯、调试和版本管理提供基础能力2. Run 级参数支持在 Workflow 的run()和arun()方法中新增以下运行级参数metadatadependenciesadd_dependencies_to_contextadd_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/agnoagno v2.5.10 并不是一次简单的功能叠加而是一次面向生产、面向多平台、面向复杂 Agent 系统的系统级升级并行搜索与检索让 Agent 更快、更准MLflow 可观测性让 Agent 更可控、更可信Docling Reader 打开文档处理新边界WhatsApp 与 Telegram 接口让 Agent 真正走向真实用户Workflow 与模型能力增强让系统更灵活大量 Bug 修复为稳定运行保驾护航
