一、版本信息

版本号： v2.4.0
发布时间： 2026年1月18日

agno v2.4.0版本正式发布，本次更新堪称一次全方位的系统级升级。它不仅引入了全新的知识协议（KnowledgeProtocol）和Agent持久化能力，还在事件系统、数据库管理、文件输入支持、接口一致性等多个层面带来重要提升。下面我们将详细梳理此次更新的全部变更内容。

---

二、新特性（New Features）

1. Knowledge Protocol引入

本次版本新增了 KnowledgeProtocol。
主要变化：

• 主 Knowledge 实现现在符合这一接口标准。
• 任何其他实现都可以与 Agent 或 Team 一起使用。
• 目前，只有主 Agno Knowledge 实现支持 AgentOS 知识管理。

这意味着知识体系更加模块化，开发者可通过协议切换不同知识实现，提升可扩展性。

2. Agent Builder：支持持久化与管理

用户现在可以 直接在数据库中持久化并管理 Agent、Team 和 Workflow 配置。
AgentOS 提供新的端点以编程方式创建、检索和更新组件定义，实现配置的统一管理和自动化部署。

3. 新增事件类型

新增以下系统事件：

• 模型事件：ModelRequestStarted 和 ModelRequestCompleted
• 压缩事件：CompressionStarted 和 CompressionCompleted
• 记忆事件：MemoryUpdateCompleted 现在包含完整内存内容。

使运行时跟踪与监控更加细致。

4. Gemini文件输入增强

支持 直接通过 GCS（Google Cloud Storage）和外部 URL 输入 Gemini 文件，显著扩展文件来源的灵活性。

5. TavilyTools扩展

新增 api_base_url 参数，用于 自定义托管场景，方便企业或本地部署使用。

---

三、性能与功能改进（Improvements）

1. AgentOS默认数据库机制

新增默认数据库（db）至 AgentOS 类：

• 若填充，则自动传播至所有 agent、team 和 workflow。
• 用作追踪数据库（tracing db）。
  简化了配置层级，降低冗余。

2. 用户记忆参数更新

弃用 enable_user_memories，改用 update_memory_on_run 实现同样行为，参数命名更清晰直观。

3. Knowledge配置端点优化

在检查可用读取器时，无需实例化 reader 类，减少不必要警告、加快响应速度。

4. 日期格式统一

所有通过 OS API 传递的日期格式现已 统一为 UTC datetime，提高跨系统一致性。

5. AgentOS路径处理优化

新增 TrailingSlashMiddleware：

• 自动去除请求路径尾部斜杠。
• 所有端点返回内容完全一致，不再产生 307 重定向。

6. 指令传递方式升级

Agent 与 Team 的系统消息中指令不再使用 <instructions> 标签。
新增 add_instruction_tags=True 参数，可恢复旧版结构化提示行为。

---

四、问题修复（Bug Fixes）

• LanceDB：解决异步插入或更新时可能出现的重复嵌入问题。
• Qdrant异步搜索：改进异步搜索方法，防止事件循环阻塞。
• CSV Reader：修复 BytesIO 输入编码参数忽略问题，现在可正确使用自定义编码。
• PDF Reader：修复空字符串密码被视为 None 的错误。
• Openrouter与Gemini：保持 Gemini 的 reasoning_details 字段，修复多轮对话异常。
• MongoDB异步搜索：更改使用 async_get_embedding()，消除阻塞问题。
• Gemini Vertex AI文件上传：修复上传时 API 报 400 的问题。
• Skills系统提示：修正 Agent 调用技能名作为函数导致的“Function not found”错误。

这一系列修复显著提高稳定性与异步操作效率。

---

五、重大变更（Breaking Changes）

• 删除所有已废弃字段：包括 session_state、dependencies、user_id 等，统一由 RunContext 替代。
• 参数及方法变更：
  • stream_intermediate_steps → stream_events
  • yield_run_response → yield_run_output
• Team类变更：移除 delegate_task_to_all_members 方法。
• Web搜索工具重构：
  • 新增 WebSearchTools，替代旧 DDG 搜索工具。
  • 作为默认 web 搜索工具应用于 cookbook 与文档中。
• Knowledge方法重命名：
  • add_content() → insert()
  • add_content_many() → insert_many()
    旧方法仍兼容，但未来文档将仅支持新命名。
• AgentOS参数调整：
  • 弃用 tracing_db，统一使用 db 参数。

---

六、总结

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

agno v2.4.0 是一次具有里程碑意义的版本更新。
核心亮点包括：

• 知识协议标准化，让知识系统更模块化。
• Agent Builder数据库化，实现配置持久化与自动管理。
• 事件体系扩展与性能优化，增强系统追踪与稳定性。
• 文件输入与搜索工具升级，适配更丰富的场景。
• 全面的Bug修复与接口统一规范化，提升一致性与开发体验。