agno v2.3.24更新：MongoDB连接更智能、工具安全性全面升级、Markdown分块更灵活！

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

2026年1月8日，Agno正式发布了 v2.3.24版本。本次更新不仅带来了多项性能与安全提升，还进一步优化了开发者在多工具、多知识库使用场景下的体验。以下是详细的更新内容与改进说明。

🚀 改进内容（Improvements）

1. MongoDB连接握手新增版本元数据 Agno v2.3.24 对 MongoDB 的连接握手过程进行了增强，现已在握手中包含 Agno 自身的版本元数据。 这一改动帮助使用多应用托管 MongoDB 集群的用户更好地区分连接来源，并便于日志分析与排查。

2. Crawl4aiTools 新增 proxy_config 参数 在本次更新中，Crawl4aiTools 工具包新增了 proxy_config 参数，开发者可通过此参数灵活配置代理，进一步强化抓取与分析场景的可控性。

3. 工具操作目录安全限制 为提升系统安全性，PythonTools 与 MLXTranscribeTools 现默认禁止在基础目录之外进行操作。 如果有跨目录操作需求，可通过 restrict_to_base_dir 参数选择“退出限制”，从而允许工具在基础目录外执行特定任务。

4. MarkdownChunker 新支持 split_on_headings 参数 Markdown 处理方面也迎来重大提升。新版 MarkdownChunker 增加了 split_on_headings 参数，开发者可精细控制分块方式，实现更精准的内容分割与组织。

5. 知识库 ContentsDB 使用提示优化 当用户在使用 Knowledge 模块时未启用 ContentsDB，系统将提供更明确的警告与日志说明。同时优化了与内容搜索相关的过滤逻辑，让代理型搜索体验更加顺畅。

🧩 Bug修复（Bug Fixes）

• • 团队会话名称问题修复 修复了从 Team 实例直接使用 get_session_name 时会出现异常的问题。
• • 多轮HITL用户输入错误修复 修正了在特定 HITL 流程中，用户连续多次输入导致的异常问题。
• • AgentOS Knowledge 路由修复 解决了 AsyncDB 在内容更新操作中未正确路由的问题。

🆕 主要变更摘要（What's Changed）

• • 修复了会话名称生成逻辑的问题。
• • 解决了 HITL 轮次中 active_requirements 未正确载入的问题。
• • 在 MongoDB 握手中加入了 Agno 的版本详情。
• • Crawl4aiTools 新增 proxy_config 参数。
• • 替换了不安全的 eval() 实现，采用安全的类型映射机制。
• • 为 PythonTools 和 MLXTranscribeTools 增加 restrict_to_base_dir 参数，强化目录限制机制。
• • 优化了 Knowledge 内容补丁支持。
• • 修复了当 run_input 为字符串时出现的 AttributeError。
• • 更新了 Knowledge 模块的日志与过滤逻辑。
• • 完成版本整合与发布流程。

✨ 总结

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

Agno v2.3.24 是一次兼顾 可靠性、安全性与灵活性 的更新。 从数据库连接的细致增强，到多工具交互的安全防护，再到 Markdown 内容分块的精细化控制，每一项改动都为开发者带来更高效、更安全的智能应用构建体验。

·

我们相信人工智能为普通人提供了一种“增强工具”，并致力于分享全方位的AI知识。在这里，您可以找到最新的AI科普文章、工具评测、提升效率的秘籍以及行业洞察。 欢迎关注“福大大架构师每日一题”，发消息可获得面试资料，让AI助力您的未来发展。

·