agno v2.6.22 版本更新概览

版本功能亮点示意

核心改进与修复图

发布时间：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 中 sa ve_dag_file 和 read_dag_file 的路径遍历问题
• 修复 fallback 模型响应未持久化到会话历史的问题
• 修复 DuckDbTools 中派生表名的清理问题，并修复全文搜索相关辅助功能

如果从价值层面来归纳，这次更新主要围绕四个关键词：能力扩展、稳定性提升、安全性增强、数据与会话一致性改善。

三、新功能详解：工具生态的持续扩展

1. TwelveLabs Tools：视频分析与多模态文本嵌入

这是本次更新里非常值得关注的一项新增能力。agno 在工具层面新增了 TwelveLabsTools，其核心能力包含两部分：分析视频和生成多模态文本嵌入。

从功能定义上看，这一更新直接将视频内容处理能力纳入了 agno 的工具体系。这意味着处理对象不再局限于纯文本或静态信息，而是扩展到了视频这种更复杂的多模态内容。

同时，“生成多模态文本嵌入”这一点也尤为关键。它代表的不只是简单的视频读取，而是围绕视频内容形成了可用于语义处理、检索或理解的文本表示能力。换句话说，这次更新不只是增加了一个“能看视频”的工具，而是把视频理解与后续的语义处理链路结合在一起。

对于构建更复杂智能体工作流的场景，这项能力的意义主要体现在：

• 视频内容可以被纳入分析范围
• 多模态场景下的信息处理能力进一步增强
• 工具生态从文本搜索、数据库、任务编排，延伸到了视频理解领域

可以说，这是一次非常明确的能力边界扩张。

2. Sofya Tools：搜索、提取与研究

v2.6.22 同时新增了 SofyaTools，并明确给出了它的功能定位：搜索、提取和研究。

SofyaTools 覆盖的是一条非常实用的信息处理链：先搜索，再提取，最后研究。这并不是单一能力的小补充，而是更偏向于围绕信息获取与信息整理的一组组合能力。对于很多基于智能体的应用来说，搜索只是第一步，真正难的是后续如何把搜到的内容进行提取、归纳和研究。SofyaTools 的加入，使这条链路有了更明确的工具承载。

这项更新的价值，在于它把“信息发现”和“信息加工”进行了更自然的衔接。对于需要做资料收集、内容提取、研究辅助等任务的场景，这将是非常直接的能力增强。

3. SearchAPI Tool：多渠道搜索能力

这是本次版本另一个非常实用的新功能。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 timeout 能力接入到多个工具中
• 把 timeout 支持扩展到更多 toolkits

先看第一层：基础 Toolkit 增加 timeout。这意味着超时控制不再是某些工具的个别配置，而是被下沉到了更基础的框架层。只要构建在这个基础 Toolkit 之上的能力，就更容易统一处理执行超时问题。

再看第二层：HTTP 超时接入多个工具。很多工具底层都依赖 HTTP 请求。如果没有合理的超时控制，就会出现长时间等待、请求阻塞、工具调用卡住，甚至整个工作流延迟被放大。这次更新把 HTTP timeout 更系统地接入到多个工具里，本质上是在提升整个平台的响应可控性。

第三层：扩展 timeout 支持到更多 toolkits。这说明本次更新不是只在某一个点上打补丁，而是进行了更大范围的超时能力覆盖。对开发者来说，这会带来更一致的运行体验。

从整体价值上说，这项改进主要解决的是“工具调用是否可控”的问题。一个工具再强，如果在实际调用中因为等待时间不受控而影响整体链路，那开发体验就会大打折扣。而 timeout 机制的统一增强，会直接改善这一点。

五、缺陷修复详解：稳定性、安全性、历史记录完整性全面补强

1. ModelResponse：created_at 按实例生成

这是一个非常典型、也极为关键的细节修复。问题的本质在于：ModelResponse.created_at 的时间戳此前是在模块导入时打上的，而不是在每个实例创建时打上的。这会导致一个明显的问题：如果 created_at 在模块导入时就被确定，那么之后创建的多个响应实例，其时间信息就可能失真或不准确，时间戳也就失去了“按实例真实反映创建时间”的意义。

v2.6.22 对此进行了修复，改为每个 ModelResponse 实例单独打时间戳。这看似是一个小修复，但它影响的是时间信息的真实性和可追踪性。对于响应日志分析、调用链排查、多轮会话响应时间对比、时间顺序敏感的系统记录等场景，这一点至关重要。它让响应对象的时间元数据更加准确，也更符合直觉和工程预期。

2. AirflowTools：防止路径遍历

这是本次更新中非常明确的一项安全修复。涉及 AirflowTools 中的 sa ve_dag_file 和 read_dag_file 两个方法，修复目标是防止路径遍历。

路径遍历问题在文件读写相关能力中一直属于高风险点。一旦缺乏足够的路径限制和校验，就可能让文件操作超出预期目录范围，带来安全隐患。v2.6.22 针对这两个文件相关方法进行了修复，重点在于限制非法路径访问。对于使用 AirflowTools 的开发者来说，这次更新非常值得重视，它直接关系到文件读写安全边界的问题。

3. Fallback：响应持久化到会话历史

这项修复关注的是会话历史完整性。问题在于：fallback 模型的响应此前没有被持久化到 session history 中。在实际使用中，如果系统启用了 fallback 机制，当主模型因为某些原因没有成功完成任务时，系统可能会切换到 fallback 模型返回结果。此时如果 fallback 的响应没有进入会话历史，就会导致会话记录不完整、历史上下文与实际输出不一致、调试时难以还原真实对话过程等问题。

v2.6.22 修复后，fallback 模型的响应会被持久化保存到 session history 中。这项变化的价值很直接：让会话历史更完整，让真实输出与历史记录一致，让排查问题、回看流程、复现行为更容易。从稳定性和可维护性角度看，这是一次很必要的修复。

4. DuckDbTools：清理派生表名，修复全文搜索

这里涉及的是 DuckDbTools，修复内容有两项：清理派生表名和修复全文搜索相关辅助功能。

第一项，清理派生表名。这意味着派生表名的生成或使用过程中，之前可能存在命名不够规范、潜在不安全、或容易引发问题的情况。v2.6.22 对这部分进行了清理和规范化处理。

第二项，修复全文搜索功能。这说明 DuckDbTools 里和全文搜索相关的辅助能力存在问题，现在已被修复。

这类修复非常重要，因为数据库工具的稳定性往往决定了整条数据处理链是否可靠。尤其是当功能涉及动态表名、查询构造和全文搜索辅助逻辑时，任何一个细节处理不到位，都可能影响查询可用性和结果正确性。这次修复本质上是在提升表名处理的规范性和全文搜索辅助能力的可用性。

六、What's Changed 逐项对照整理

下面将 What's Changed 逐项做中文梳理，确保信息完整无遗漏：

• 修复 ModelResponse.created_at：不再在导入时打时间戳，而是按每个实例分别生成
• 新增 SearchAPI 工具：支持 Google、News、Images、YouTube 搜索
• 新增 Sofya 工具：提供搜索、提取、研究能力
• 为基础 Toolkit 增加 timeout，并将 HTTP 超时能力接入多个工具
• 为更多工具包增加 timeout 支持
• 修复 fallback 模型响应：将其持久化到会话历史中
• 修复 AirflowTools：防止 sa ve_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 中 sa ve_dag_file 和 read_dag_file 防止路径遍历
• fallback 模型的响应持久化到 session history
• DuckDbTools 对派生表名进行清理，并修复全文搜索辅助功能

版本发布

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

十、总结：能力扩张与工程补强的并行迭代

综合来看，agno v2.6.22 的更新并非单点突破，而是一次比较全面的版本迭代。

在能力层面，带来了视频分析、多模态文本嵌入、搜索、提取、研究，以及多源搜索。在工程层面，补上了基础 Toolkit 的 timeout、多工具 HTTP 超时接入，以及更广泛的 timeout 支持。在稳定性与安全层面，修复了时间戳生成方式、路径遍历风险、历史记录缺失，以及数据库表名和搜索辅助功能的问题。

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

agno v2.6.22 一边把工具能力继续做大，一边把底层可靠性、安全性和历史一致性做细。

代码地址：github.com/agno-agi/agno