agno v2.3.3 发布：引入上下文压缩与内存优化，增强文件搜索和异步支持

2025 年 11 月 27 日，agno 发布了 v2.3.3 版本，本次更新带来了多项新功能、性能改进以及 Bug 修复，尤其是在上下文管理、内存优化、文件搜索和异步支持方面有了显著增强。以下为详细更新内容。

一、新功能（New Feature）

1. 1. 上下文压缩（Context Compression）
   • • 新增运行时压缩工具调用结果的功能，有助于在智能体运行过程中对上下文进行管理。
   • • 该功能可以帮助智能体保持在上下文窗口范围内，避免触发速率限制或响应质量下降。
   • • 功能为 Beta 版，可参考官方文档获取更多信息。
2. 2. 内存优化（Memory Optimisation）
   • • 新增总结用户记忆的能力，允许在智能体运行之外进行记忆摘要。
   • • 在 MemoryManager 中新增 optimize_memories 和 aoptimize_memories 方法。
   • • 当前仅支持一种策略，未来会扩展更多。
   • • 功能为 Beta 版。
3. 3. Gemini 文件搜索支持（Gemini File Search Support）
   • • 引入了对 Google Gemini File Search 的支持。
4. 4. 文件搜索存储管理（File Search Store Management）
   • • 可创建、列出、获取和删除文档存储。
5. 5. 文件上传与导入（File Upload & Import）
   • • 支持直接上传文件，可自定义分块配置及元数据。
6. 6. 文档管理（Document Management）
   • • 支持基于元数据过滤列出、获取、删除和更新文档。
7. 7. 引用提取（Citation Extraction）
   • • 提供辅助方法，从响应中提取并格式化引用来源。
8. 8. 异步支持（Async Support）
   • • 全面支持 async/await 以满足生产环境负载需求。
9. 9. 示例 Cookbooks（暂未发布完整文档）
   • • 基础文件搜索示例：cookbook/models/google/gemini/file_search_basic.py
   • • 高级文件搜索示例：cookbook/models/google/gemini/file_search_advanced.py
   • • RAG 文件搜索流水线示例：cookbook/models/google/gemini/file_search_rag_pipeline.py

二、功能改进（Improvements）

1. 1. 运行时输出模式定义（output_schema on run/arun）
   • • 可在 run() 和 arun() 方法（包括 Agent、Team 以及 AgentOS API）中动态覆盖 output_schema。
2. 2. AWS Bedrock API Key 支持
   • • 新增对 AWS Bedrock API 密钥的支持。
3. 3. AWS Claude 兼容性增强
   • • 增加对思考模型与缓存功能的支持。
4. 4. VertexAI Claude 兼容性增强
   • • 增加对思考模型与缓存的支持。
5. 5. Gemini 3 思考等级（thinking_level）支持
   • • 可为 Gemini 设置 thinking_level 参数。

三、Bug 修复（Bug Fixes）

1. 1. 异步知识检索
   • • 修复因缺少异步版本的 get_user_message，导致异步知识检索失败的问题。
2. 2. 团队成员事件流
   • • 即使配置 stream_member_events=True 且 stream_events=False，仍确保成员事件能正确流式传输。
3. 3. 迁移管理器（MigrationManager）改进
   • • 修复无法对 2.3.0 以下版本进行迁移的问题。
   • • 新增强制迁移标志（force migration flag）。
4. 4. StopAgentRun 异常处理
   • • 修复 StopAgentRun 无法正确终止智能体运行的问题。
5. 5. PDF 图像读取器
   • • 修复生成 ID 基于文件名而不是 UUID 的问题。
6. 6. MCP 工具名前缀（tool_name_prefix）
   • • 将默认值改为 None，避免默认添加“_”前缀。
7. 7. AGUI 界面修复
   • • 修复工具调用 ID 出现重复值的问题。
   • • 修复工具调用缺少助手消息的问题。

四、本次版本主要变更总结（What's Changed）

• • 修正文档链接失效问题。
• • 修复异步知识检索逻辑。
• • 改进团队类的 JSON 输出逻辑。
• • 新增运行时可配置输出模式功能。
• • StopAgentRun 与 RetryAgentRun 正式实现。
• • 增加对 MongoDB 异步 SDK 的支持。
• • 引入记忆优化与工具调用压缩功能。
• • 优化 AWS Claude 兼容性及 API 密钥支持。
• • 增加 Gemini 文件搜索支持。
• • 修复测试用例中异步知识访问的稳定性问题。

五、总结

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

agno v2.3.3 版本是一次 功能与性能的双重提升 更新，尤其在 上下文压缩、内存优化、文件搜索能力 方面有重大改进，同时增强了 AWS Claude、VertexAI Claude 的兼容性，并全面支持 异步任务。

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