内容提要
MongoDB 发布开源 Python 包 strands-mongodb,为 AWS Strands 智能体框架提供集成,使 MongoDB 成为智能体的统一数据平台:会话持久化支持智能体重启或更换实例后恢复对话,长期记忆可跨会话保存事实,向量搜索可按语义检索历史交互。MemoryManager 负责决定记忆内容与时机,MongoDB 负责存储与检索,无需自建记忆代码。该集成还支持去重、租户隔离、多种搜索方式及 OpenTelemetry 追踪,并借助 Atlas 自动嵌入,无需自建嵌入管道。
延伸解读
无状态部署下的会话持久化
文章以 AWS Lambda 为例说明:每次调用可能运行在一次性环境中,没有本地磁盘,也不保证下次落在同一实例。通过 MongoDBStorage 将每个会话按 ID 存入 MongoDB,后续调用无论由哪个实例处理,都能加载并继续对话。这解决了无状态部署中状态不可见的问题,适合多团队跨机器运行 Strands 智能体的企业场景。
记忆去重与租户隔离的工程细节
MongoDBMemoryStore 用内容哈希将重复提取的事实转为无操作,保留原始时间戳和过期时间,开发者无需自写去重逻辑。租户隔离由包在每次搜索和删除时强制限定 scope,调用方无法通过过滤器覆盖。但文章提醒:若租户边界也是合规边界,应为每个租户单独建库或集合并限制凭据,由 MongoDB 服务端强制隔离。
搜索方式自适应与嵌入管道简化
集成支持 Vector Search、Atlas Search 文本搜索或结合 $rankFusion 的混合搜索,存储会自动选择部署中可用的最优方法,并在结果中标注所用搜索类型。借助 Atlas Automated Embedding,写入纯文本后由 Atlas 在后台生成并更新嵌入,查询时同样自动嵌入,无需安装嵌入库或管理模型 API 密钥,省去维护向量与文本同步的批处理任务。
接入成本与部署前提
使用该包需 Python 3.10 及以上、strands-agents 1.54.0 及以上。MongoDBStorage 可在任何 MongoDB 部署上运行,但基于自动嵌入的记忆搜索需要 MongoDB Atlas 集群并注册嵌入模型。若已有自产嵌入,也可改为索引和查询自有向量,但需额外代码。OpenTelemetry 追踪会为每个操作记录 span,且不捕获记忆内容。
Q&A
strands-mongodb 是什么?它主要解决什么问题?
strands-mongodb 是一个开源 Python 包,为 AWS Strands 智能体框架提供与 MongoDB 的集成。它使 MongoDB 成为智能体的统一数据平台,提供会话持久化、长期记忆和向量搜索功能,让智能体在重启或更换实例后能恢复对话,并跨会话记住事实,无需自建记忆代码。
为什么 Strands 智能体的会话需要数据库来存储?
因为智能体可能部署在无状态环境(如 AWS Lambda)中,每次调用都在临时环境运行,没有本地磁盘,且下一次调用可能落到不同实例。将会话保存在 MongoDB 中,每次调用通过会话 ID 加载并继续,就能实现跨实例的连续性,避免依赖本地状态。
MongoDB 集成如何帮助智能体实现长期记忆和语义检索?
通过 MongoDBMemoryStore 存储长期记忆,MemoryManager 决定记住什么和何时回忆,MongoDB 负责存储与检索。借助 Atlas Vector Search 和自动嵌入,记忆以纯文本写入和搜索,无需自建嵌入管道,即可按语义检索历史交互。
这个集成在记忆管理方面提供了哪些生产级特性?
它提供去重(通过内容哈希避免重复记忆)、租户隔离(每条记忆带作用域,搜索和删除限制在该作用域内)、自适应搜索(根据部署自动选择向量搜索、文本搜索或混合搜索),以及 OpenTelemetry 追踪(记录操作但不捕获记忆内容)。
如何将 MongoDB 集成到 Strands 智能体中?需要编写很多代码吗?
只需三个参数即可完成接线:storage= 指向 MongoDBStorage,session_manager= 使用 SnapshotSessionManager 按会话 ID 保存和恢复对话,memory_manager= 使用 MemoryManager 提供搜索和保存工具。无需学习 MongoDB 特定的会话类,也无需编写自定义记忆代码。
使用 strands-mongodb 有哪些环境要求?
需要 Python 3.10 或更高版本,以及 strands-agents 1.54.0 或更高版本。MongoDBStorage 可在任何 MongoDB 部署上运行;而使用自动嵌入的记忆搜索则需要 MongoDB Atlas。可通过 pip 安装,例如 pip install 'strands-mongodb[all]' 安装全部功能。