Deep Agents 社区文件系统后端

结论

这里的 backend 是 Deep Agents 的文件系统抽象，不是模型 provider、向量库、LangGraph checkpointer 或通用键值存储。当前两个有效路由正文完全相同：一个是目录入口，一个是显式 index 别名。

官方当前只列出一个社区实现：MongoDB VFS Adapter。它把 agent 文件、memory、artifact 和 conversation history 持久化到 MongoDB Atlas collection。页面明确说明社区 backend 由社区贡献，LangChain 不管理也不维护；进入生产前必须自行审计源码、版本、故障语义和数据治理能力。

接口与安装边界

本页是生态索引，不提供统一安装命令、认证方法、同步/异步保证或完整 API。自定义实现需要遵循 Deep Agents backend 协议；实际编码应回到 backend 指南和所选包的版本化 API，而不能把索引表当成兼容契约。

生产检查

• 文件路径必须经过规范化并限制在租户根目录，防止越权读取、路径穿越和跨租户覆盖。
• 明确 write、edit、delete、list、glob、grep 等操作的原子性、幂等性和并发冲突策略。
• MongoDB collection 需要 tenant/session namespace、最小权限凭证、索引、容量上限、备份与恢复演练。
• 不把数据库持久化等同于一致性已经解决；需验证重复请求、进程崩溃、网络重试和部分写入后的可恢复性。
• memory 与 artifact 的保留周期、删除请求、加密、审计和敏感内容分类应由应用层明确控制。

验证边界

本笔记验证了官方索引当前可见的能力与维护归属，没有验证 MongoDB 社区适配器的运行时行为，也没有把社区实现认定为官方支持组件。