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

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

一、新功能（New Feature）
1. 上下文压缩（Context Compression）
• 新增运行时压缩工具调用结果的功能，有助于在智能体运行过程中对上下文进行管理。
• 该功能可以帮助智能体保持在上下文窗口范围内，避免触发速率限制或响应质量下降。
• 功能为 Beta 版，可参考官方文档获取更多信息。
2. 内存优化（Memory Optimisation）
• 新增总结用户记忆的能力，允许在智能体运行之外进行记忆摘要。
• 在 MemoryManager 中新增 optimize_memories 和 aoptimize_memories 方法。
• 当前仅支持一种策略，未来会扩展更多。
• 功能为 Beta 版。
3. Gemini 文件搜索支持（Gemini File Search Support）
• 引入了对 Google Gemini File Search 的支持。
4. 文件搜索存储管理（File Search Store Management）
• 可创建、列出、获取和删除文档存储。
5. 文件上传与导入（File Upload & Import）
• 支持直接上传文件，可自定义分块配置及元数据。
6. 文档管理（Document Management）
• 支持基于元数据过滤列出、获取、删除和更新文档。
7. 引用提取（Citation Extraction）
• 提供辅助方法，从响应中提取并格式化引用来源。
8. 异步支持（Async Support）
• 全面支持 async/await 以满足生产环境负载需求。
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. 运行时输出模式定义（output_schema on run/arun）
• 可在 run() 和 arun() 方法（包括 Agent、Team 以及 AgentOS API）中动态覆盖 output_schema。
2. AWS Bedrock API Key 支持
• 新增对 AWS Bedrock API 密钥的支持。
3. AWS Claude 兼容性增强
• 增加对思考模型与缓存功能的支持。
4. VertexAI Claude 兼容性增强
• 增加对思考模型与缓存的支持。
5. Gemini 3 思考等级（thinking_level）支持
• 可为 Gemini 设置 thinking_level 参数。
三、Bug 修复（Bug Fixes）
1. 异步知识检索
• 修复因缺少异步版本的 get_user_message，导致异步知识检索失败的问题。
2. 团队成员事件流
• 即使配置 stream_member_events=True 且 stream_events=False，仍确保成员事件能正确流式传输。
3. 迁移管理器（MigrationManager）改进
• 修复无法对 2.3.0 以下版本进行迁移的问题。
• 新增强制迁移标志（force migration flag）。
4. StopAgentRun 异常处理
• 修复 StopAgentRun 无法正确终止智能体运行的问题。
5. PDF 图像读取器
• 修复生成 ID 基于文件名而不是 UUID 的问题。
6. MCP 工具名前缀（tool_name_prefix）
• 将默认值改为 None，避免默认添加“_”前缀。
7. AGUI 界面修复
• 修复工具调用 ID 出现重复值的问题。
• 修复工具调用缺少助手消息的问题。
四、本次版本主要变更总结（What's Changed）
• 修正文档链接失效问题。
• 修复异步知识检索逻辑。
• 改进团队类的 JSON 输出逻辑。
• 新增运行时可配置输出模式功能。
• StopAgentRun 与 RetryAgentRun 正式实现。
• 增加对 MongoDB 异步 SDK 的支持。
• 引入记忆优化与工具调用压缩功能。
• 优化 AWS Claude 兼容性及 API 密钥支持。
• 增加 Gemini 文件搜索支持。
• 修复测试用例中异步知识访问的稳定性问题。
五、总结

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