agno v2.6.22发布:视频理解、搜索研究、超时机制、安全修复全面升级,一文看懂全部更新

agno v2.6.22发布:视频理解、搜索研究、超时机制、安全修复全面升级,一文看懂全部更新 发布时间2026年7月4日这次 agno v2.6.22 的更新整体看下来非常有代表性一方面继续扩展工具生态新增了视频分析、多模态文本嵌入、搜索、提取、研究、以及多渠道搜索能力另一方面也在工程可用性、安全性、会话历史完整性、数据库辅助能力等方面做了扎实补强。如果把这次版本更新做一个总结那么可以概括为一句话工具能力更强了系统稳定性更好了安全边界更严了实际开发体验也更顺手了。下面基于你提供的更新内容做一次完整、详细、且不遗漏任何信息的梳理。一、版本信息速览版本号v2.6.22发布时间2026年7月4日本次更新内容主要分为三大部分New FeaturesImprovementsBug Fixes此外还附带了 What’s Changed 作为变更清单明细。二、本次更新总览v2.6.22 到底更新了什么从提供的 Changelog 来看agno v2.6.22 主要带来了以下几个方向的变化新增 TwelveLabsTools用于分析视频和生成多模态文本嵌入新增 SofyaTools用于搜索、提取和研究新增 SearchApiTools支持 Google、News、Images、YouTube 搜索为基础 Toolkit 增加 timeout并将 HTTP 超时能力接入多个工具为更多工具包扩展 timeout 支持修复 ModelResponse.created_at 时间戳在导入时就被固定的问题改为按实例打时间修复 AirflowTools 中 save_dag_file 和 read_dag_file 的路径遍历问题修复 fallback 模型响应未持久化到会话历史的问题修复 DuckDbTools 中派生表名的清理问题并修复全文搜索相关辅助功能如果从价值层面来看这次更新主要体现在四个关键词能力扩展稳定性提升安全性增强数据与会话一致性改善三、新功能详解工具生态继续扩展1. TwelveLabs Tools新增 TwelveLabsTools用于分析视频和生成多模态文本嵌入这是这次版本里非常值得关注的一项新增能力。更新原文提到Added TwelveLabsTools to analyze videos and generate multimodal text embeddings.See docs.这意味着 agno 在工具层面新增了TwelveLabsTools其核心能力包括两部分分析视频生成多模态文本嵌入从功能定义上看这一更新直接把视频内容处理能力带入到了 agno 的工具体系中。视频分析能力的加入意味着处理对象不再局限于纯文本或静态信息而是进一步扩展到了视频这种更复杂的多模态内容。同时“生成多模态文本嵌入”这一点也非常关键。它代表的不只是简单的视频读取而是围绕视频内容形成可用于语义处理、检索或理解的文本表示能力。换句话说这次更新并不只是增加了一个“能看视频”的工具而是把视频理解与后续的语义处理链路结合了起来。对于使用 agno 构建更复杂智能体工作流的人来说这项新增能力的意义主要体现在视频内容可以被纳入分析范围多模态场景下的信息处理能力进一步增强工具生态从文本搜索、数据库、任务编排进一步延伸到视频理解领域从版本层面看这是一项非常明确的能力边界扩张。2. Sofya Tools新增 SofyaTools用于搜索、提取和研究更新原文提到Added SofyaTools for search, extract, and research.agno v2.6.22 同时新增了SofyaTools并且明确给出了它的功能定位searchextractresearch也就是说SofyaTools 覆盖的是一条很实用的信息处理链先搜索再提取最后研究从工具命名和功能描述来看这并不是单一能力的小补充而是更偏向于围绕信息获取与信息整理的一组组合能力。对于很多基于智能体的应用来说搜索只是第一步真正难的是后续如何把搜到的内容继续提取、归纳、研究。SofyaTools 的加入使这条链路有了更明确的工具承载。这项更新的价值在于它把“信息发现”和“信息加工”进行了更自然的衔接。对于需要做资料收集、内容提取、研究辅助等任务的场景来说这会是非常直接的能力增强。需要注意的是这里我们只能依据给定内容描述其能力边界也就是搜索提取研究这三项就是目前 changelog 中明确给出的范围。3. SearchAPI Tool新增 SearchApiTools支持 Google、News、Images、YouTube 搜索更新原文提到Added SearchApiTools with Google, News, Images, and YouTube search.这是本次版本里另一个非常实用的新功能。agno v2.6.22 新增了SearchApiTools而且明确给出了支持的搜索类型GoogleNewsImagesYouTube这意味着 agno 在搜索工具层面的覆盖范围进一步扩大不再只是泛搜索概念而是已经细分到了多个具体信息入口通用网页搜索新闻搜索图片搜索视频平台搜索从使用角度看这种细分支持非常重要。因为不同任务对搜索结果类型的要求完全不同需要获取综合网页信息时Google 搜索更合适需要时效性内容时News 搜索更适合需要视觉素材或图像相关结果时Images 搜索更有针对性需要视频内容时YouTube 搜索就更加直接因此这次新增 SearchApiTools 的意义不只是“多了一个搜索工具”而是 agno 的搜索能力开始呈现出更完整、更面向实际任务的结构化形态。它和 SofyaTools 一起看会发现 v2.6.22 在“外部信息获取”这个方向上明显下了功夫一个是偏搜索、提取、研究的综合能力一个是偏多搜索源、多类型检索的能力两者放在一起使 agno 的工具生态在信息获取层面更加丰富。四、改进项详解超时机制补齐工具可用性提升1. Toolkit Timeouts为基础 Toolkit 增加 timeout并将 HTTP 超时能力接入多个工具更新原文提到Added timeout to the base Toolkit and wired HTTP timeouts across tools; extended timeout support to more toolkits.这项改进虽然看起来不像新功能那样“显眼”但从工程实践角度来说它的重要性非常高。这里包含两层信息为基础 Toolkit 增加了 timeout将 HTTP timeout 能力接入到多个工具中并把 timeout 支持扩展到更多 toolkits先看第一层基础 Toolkit 增加 timeout这意味着超时控制不再只是个别工具自己的能力而是被下沉到了更基础的框架层。只要是构建在这个基础 Toolkit 之上的能力就更容易统一处理执行超时问题。再看第二层HTTP 超时接入多个工具很多工具底层都依赖 HTTP 请求。如果没有合理的超时控制就会出现长时间等待请求阻塞工具调用卡住工作流整体延迟被放大这次更新把 HTTP timeout 更系统地接入到多个工具里本质上是在提升整个平台的响应可控性。第三层扩展 timeout 支持到更多 toolkits这说明本次更新不是只在某一个点上打补丁而是进行了更大范围的超时能力覆盖。对开发者来说这会带来更一致的运行体验。从整体价值上说这项改进主要解决的是“工具调用是否可控”的问题。一个工具再强如果在实际调用中因为等待时间不受控而影响整体链路那开发体验就会明显打折扣。而 timeout 机制的统一增强会直接改善这一点。五、缺陷修复详解稳定性、安全性、历史记录完整性全面补强1. ModelResponsecreated_at 不再在导入时固定而是按实例生成更新原文提到Stamp ModelResponse.created_at per instance instead of at import time.这是一个非常典型、也非常关键的细节修复。问题的本质在于ModelResponse.created_at 的时间戳之前是在 import time 打上的而不是在每个实例创建时打上的。这会导致一个明显的问题如果 created_at 在模块导入时就被确定那么之后创建的多个响应实例时间信息可能失真或不准确时间戳失去“按实例真实反映创建时间”的意义v2.6.22 对这个问题进行了修复改成每个 ModelResponse 实例单独打 created_at 时间戳这看似是一个小修复但它影响的是时间信息的真实性和可追踪性。对于以下场景尤其重要响应日志分析调用链排查多轮会话响应时间对比时间顺序敏感的系统记录所以这项修复虽然体量不大但意义很实在。它让响应对象的时间元数据更加准确也更符合直觉和工程预期。2. AirflowTools防止 save_dag_file 和 read_dag_file 出现路径遍历更新原文提到Prevent path traversal in save_dag_file and read_dag_file.这是本次更新中非常明确的一项安全修复。涉及的组件是AirflowTools涉及的方法是save_dag_fileread_dag_file修复目标是防止 path traversal也就是路径遍历路径遍历问题在文件读写相关能力中一直都属于高风险点。一旦缺乏足够的路径限制和校验就可能让文件操作超出预期目录范围从而带来安全隐患。v2.6.22 针对 AirflowTools 中的这两个文件相关方法进行了修复重点就在于限制非法路径访问防止路径遍历带来的风险对使用 AirflowTools 的开发者来说这次更新非常值得重视。因为它不是体验优化而是直接关系到文件读写安全边界的问题。把这个问题修掉意味着相关工具在处理 DAG 文件时的安全性更高了。3. Fallback将 fallback 模型的响应持久化到会话历史更新原文提到Persist the fallback model’s response in session history.这项修复关注的是会话历史完整性。问题点在于fallback 模型的响应此前没有被持久化到 session history 中在实际使用中如果系统启用了 fallback 机制那么当主模型因为某些原因没有成功完成任务时系统可能会切换到 fallback 模型返回结果。此时如果 fallback 的响应没有进入会话历史就会带来几个明显问题会话记录不完整历史上下文与实际输出不一致调试时难以还原真实对话过程后续依赖 session history 的逻辑可能出现偏差v2.6.22 修复后fallback 模型的响应会被持久化保存到 session history 中。这项变化的价值很直接让会话历史更完整让真实输出与历史记录一致让排查问题、回看流程、复现行为更容易从稳定性和可维护性角度看这是一次很必要的修复。4. DuckDbTools清理派生表名并修复全文搜索辅助功能更新原文提到Sanitize derived table names and fix full-text search.这里涉及的是DuckDbTools修复内容有两项清理派生表名修复全文搜索相关辅助功能先看第一项sanitize derived table names这表示派生表名的生成或使用过程中之前可能存在命名不够规范、潜在不安全、或者容易引发问题的情况。v2.6.22 对这部分进行了清理和规范化处理。再看第二项fix full-text search这说明 DuckDbTools 里和全文搜索相关的辅助能力存在问题现在已被修复。这类修复非常重要因为数据库工具的稳定性往往决定了整条数据处理链是否可靠。尤其是当功能涉及动态表名查询构造全文搜索辅助逻辑任何一个细节处理不到位都可能影响查询可用性和结果正确性。因此DuckDbTools 这次的修复本质上是在提升两方面质量表名处理的规范性全文搜索辅助能力的可用性对于依赖 DuckDbTools 做数据处理和检索工作的场景这会带来更稳妥的使用体验。六、What’s Changed 逐项对照整理下面把你给出的 What’s Changed 逐项做中文梳理确保信息完整且不遗漏修复 ModelResponse.created_at不再在导入时打时间戳而是按每个实例分别生成新增 SearchAPI 工具支持 Google、News、Images、YouTube 搜索新增 Sofya 工具提供搜索、提取、研究能力为基础 Toolkit 增加 timeout并将 HTTP 超时能力接入多个工具为更多工具包增加 timeout 支持修复 fallback 模型响应将其持久化到会话历史中修复 AirflowTools防止 save_dag_file 和 read_dag_file 发生路径遍历修复 DuckDbTools清理派生表名并修复全文搜索辅助功能新增 TwelveLabs 视频工具支持视频分析和多模态文本嵌入发布 v2.6.22可以看到What’s Changed 与前面的 Changelog 是一一对应的只是换成了更接近变更记录的表达方式。七、从版本结构看v2.6.22 的更新逻辑非常清晰如果把这次更新重新按“技术方向”归类而不是按 changelog 原始分类来看agno v2.6.22 的变化其实可以归纳成四条主线。第一条主线多模态与外部信息能力增强这一条主线包括TwelveLabsTools视频分析、多模态文本嵌入SofyaTools搜索、提取、研究SearchApiToolsGoogle、News、Images、YouTube 搜索这三项放在一起说明 agno 在“获取外部信息”和“处理多模态内容”方面持续扩展工具边界。第二条主线超时机制系统化这一条主线包括基础 Toolkit 增加 timeoutHTTP 超时能力接入多个工具timeout 支持扩展到更多 toolkits这说明 agno 不再把超时控制当成某些工具的个别配置而是开始把它做成更通用、更基础的工程能力。第三条主线安全性加强这一条主线最典型的是AirflowTools 防止路径遍历同时DuckDbTools 中对派生表名的清理也可以看作是规范化与稳健性增强的一部分。虽然 changelog 里没有直接把它归为安全修复但“sanitize”本身就体现出对输入或生成结果的规范处理意识。第四条主线数据与历史记录准确性提升这一条主线包括ModelResponse.created_at 按实例打时间戳fallback 模型响应写入 session history这两项修复都指向一个核心目标让系统中的记录更真实让状态更完整让后续排查、回溯、分析更可靠八、为什么说这次更新很“实用”很多版本更新会偏重某一方面比如单纯新增几个工具或者单纯修几个 bug。但 agno v2.6.22 的特点在于它的更新组合很均衡有面向能力增长的新功能有面向工程稳定性的基础改进有面向安全性的关键修复有面向会话与响应记录一致性的补强这使得 v2.6.22 并不是“看起来热闹但落地感一般”的更新而是比较实用、比较有开发价值的一次版本推进。尤其是下面几项如果放到真实项目里价值会很明显搜索能力扩展意味着更多信息接入方式视频分析能力加入意味着多模态应用空间变大timeout 统一化意味着工具执行更可控AirflowTools 安全修复意味着文件处理边界更稳fallback 历史持久化意味着会话记录更完整ModelResponse 时间戳修复意味着日志时间更可信DuckDbTools 修复意味着数据库辅助功能更可靠九、v2.6.22 全部更新清单汇总为了方便做文章结尾收藏这里把所有更新内容再完整汇总一次新功能新增 TwelveLabsTools用于分析视频和生成多模态文本嵌入新增 SofyaTools用于搜索、提取和研究新增 SearchApiTools支持 Google、News、Images、YouTube 搜索改进为基础 Toolkit 增加 timeout将 HTTP 超时能力接入多个工具将 timeout 支持扩展到更多 toolkits缺陷修复ModelResponse.created_at 从“导入时打时间戳”改为“按实例打时间戳”AirflowTools 中 save_dag_file 和 read_dag_file 防止路径遍历fallback 模型的响应持久化到 session historyDuckDbTools 对派生表名进行清理并修复全文搜索辅助功能版本发布发布 v2.6.22发布时间2026年7月4日十、总结agno v2.6.22 是一次能力扩张与工程补强并行的更新代码地址github.com/agno-agi/agno综合来看agno v2.6.22 的更新并不是单点突破而是一次比较全面的版本迭代。在能力层面它带来了视频分析多模态文本嵌入搜索、提取、研究Google、News、Images、YouTube 搜索在工程层面它补上了基础 Toolkit 的 timeout多工具 HTTP timeout 接入更多 toolkit 的 timeout 支持在稳定性与安全层面它修复了ModelResponse.created_at 时间戳生成方式AirflowTools 路径遍历风险fallback 响应历史缺失问题DuckDbTools 的表名清理与全文搜索辅助问题如果用一句更简洁的话来概括这次发布agno v2.6.22 一边把工具能力继续做大一边把底层可靠性、安全性和历史一致性做细。