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

作者：袖梨 2026-07-07

在这里插入图片描述

发布时间：2026年7月4日

这次 agno v2.6.22 的更新，整体看下来非常有代表性：一方面继续扩展工具生态，新增了视频分析、多模态文本嵌入、搜索、提取、研究、以及多渠道搜索能力；另一方面也在工程可用性、安全性、会话历史完整性、数据库辅助能力等方面做了扎实补强。

如果把这次版本更新做一个总结，那么可以概括为一句话：

工具能力更强了，系统稳定性更好了，安全边界更严了，实际开发体验也更顺手了。

下面基于你提供的更新内容，做一次完整、详细、且不遗漏任何信息的梳理。

一、版本信息速览

• 版本号：v2.6.22• 发布时间：2026年7月4日

本次更新内容主要分为三大部分：

• New Features• Improvements• Bug 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，并且明确给出了它的功能定位：

• search• extract• research

也就是说，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，而且明确给出了支持的搜索类型：

• Google• News• Images• YouTube

这意味着 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. ModelResponse：created_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_file• read_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：搜索、提取、研究• SearchApiTools：Google、News、Images、YouTube 搜索

这三项放在一起，说明 agno 在“获取外部信息”和“处理多模态内容”方面持续扩展工具边界。

第二条主线：超时机制系统化

这一条主线包括：

• 基础 Toolkit 增加 timeout• HTTP 超时能力接入多个工具• 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 history• DuckDbTools 对派生表名进行清理，并修复全文搜索辅助功能

版本发布

• 发布 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 的表名清理与全文搜索辅助问题

如果用一句更简洁的话来概括这次发布：