---
type: study
status: verified
created: 2026-08-11
updated: 2026-08-11
sensitivity: standard
tags:
  - study
  - langchain
  - python
  - integrations
  - deep-agents
  - backends
topic: Deep Agents 社区文件系统后端
sources:
  - https://docs.langchain.com/oss/python/integrations/backends
  - https://docs.langchain.com/oss/python/integrations/backends/index
last_verified: 2026-08-11
---
# 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 社区适配器的运行时行为，也没有把社区实现认定为官方支持组件。