嘿，老铁，今天咱聊聊 DeepAgents 的后端存储到底怎么搞的。说实话，这玩意儿一开始听起来挺玄乎的，但其实跟你平时写代码没啥两样。咱们先别急着扔技术堆砌，先把思路梳理清楚，然后再掏出代码块给你kan。

你想想，一个 Agent Ru果只在内存里跑，那等到进程重启就全抹了。尤其是在多线程或者分布式部署时一份重要记忆Ru果丢了那可就麻烦了。于是我们就需要把文件和状态持久化，才Neng让 Agent 有“长记忆”。

说到这里hen多人会问：那百度怎么不收录这类技术文章？

原因hen简单，百度搜索偏爱内容量大、geng新频繁且Neng提供明确答案的网站。而这些技术实验性文章往往只有小范围内的人关注，geng新周期短，而且内容高度专业，不太适合大众检索。所以Ru果你想让自己的博客被搜索引擎抓取，还得Zuo点 SEO 优化——可别光靠代码。

Zui直观的后端就是把虚拟路径映射到本地磁盘上。那叫啥叫 FilesystemBackend 呢？基本思路是：

根目录指定了 Agent 的工作区。

virtual_mode 开关决定是否允许跨目录读写。

所有操作dou直接落到磁盘，就像普通文件一样。

下面给你贴个Zui简版配置示例，你Ke以直接拷贝跑一下：

from pathlib import Path
from deepagents import create_deep_agent
from deepagents.backends import FilesystemBackend
from langchain.chat_models import init_chat_model
from dotenv import load_dotenv, find_dotenv
import os
load_dotenv)
# 准备工作目录
workspace_dir = Path.resolve
if not workspace_dir.exists:
    workspace_dir.mkdir
# 文件系统后端
file_backend = FilesystemBackend
# 初始化模型
model = init_chat_model(
    model="qwen-max",
    model_provider="openai",
    api_key=os.getenv,
    base_url=os.getenv
)
# 创建 Agent 并指定 backend
main_agen = create_deep_agent(
    model=model,
    tools=,
    backend=file_backend,
    system_prompt="""
        你是一个智Neng助手，Ke以使用文件工具进行文件操作和读写！
        但是只有在用户明确要求的情况下你才Ke以创建文件！！
    """
)
print
result_1 = main_agen.invoke({
    "messages": 
})
print
print
result_2 = main_agen.invoke({
    "messages": 
})
print

执行结果通常会显示：Ru果用户没有指明要写文件，那么 Agent 就不会去创建；但当你说“写到 java.txt 文件中”时它就会自动把内容保存下来。

优点：

实现简单，几行代码搞定。

直接可见，可调试性好——对调试爱好者友好。

局限：

单机环境下只Neng用，本地磁盘容量有限。

跨节点共享困难，需要额外同步机制。

Ru果你在生产里跑多台机器或者想让记忆geng持久、geng可靠，就得用 StoreBackend。这背后的核心是 LangGraph 的 Store 抽象，它本质上就是一个 KV 存储。常见实现包括 Redis、Postgres 或者纯内存 InMemoryStore。

from deepagents.backends import StoreBackend
from langgraph.store.memory import InMemoryStore
store = InMemoryStore
model = init_chat_model(
    model="qwen-max",
    model_provider="openai",
    api_key=os.getenv,
    base_url=os.getenv
)
main_agent = create_deep_agent(
    model=model,
    store=store,
    backend=StoreBackend,
    system_prompt="""
        你要把用户的重要信息保存到 user_profile.txt 文件中！
        获取用户信息Ke以读取 user_profile.txt 文件！
    """
)

这里我们用的是 InMemoryStore——当然在真环境里你可Neng换成 Redis 或者 PostgreSQL，以保证重启后依旧有数据。

K/V 的优势主要体现在：

高并发读写Neng力，geng适合多线程场景。

天然支持分布式部署，因为大多数 KV 数据库dou有集群模式。

查询速度快，用 key 查就Neng秒级返回，而不是遍历整个文件夹。

AWS 上面经常需要区分“临时缓存”和“重要日志”。CompositeBackend 正是解决这个痛点的神器。它允许我们根据路径前缀，把不同类型的数据投递到不同的后端。比如 /store/ 路径走数据库，而其它路径则落地磁盘。

def create_composite_backend:
    # 本地文件系统后端
    workspace_dir = Path.resolve
    if not workspace_dir.exists:
        workspace_dir.mkdir
fs_backend = FilesystemBackend
# 数据库存储后端
store_backend = StoreBackend

# 路由规则：
   return CompositeBackend(
       default=fsbackend,
       routes={
           "/store/": storebackend   # 路径以 /store/ 开头走数据库
       }
   )
agent = createdeepagent(
   model=model,
   store=store,
   backend=createcompositebackend,
   tools=,
   system_prompt="""
       - 普通文件：直接写入 file 名，如 report.txt。
       - 重要记忆：写入 /store/ 目录，如 /store/profile.txt。
   """
)


实际演示一下混合存储效果吧！

print
config = {"configurable": {"threadid": "threadcomposite"}}
user_input = ". 创建本地文件 local.txt，内容'本地文件'。
\
               创建记忆文件 /store/memory.txt，内容'重要记忆'。"

print
result = agent.invoke
print
print ===")
items = store.search)
for item in items:
     print


The above snippet demonstrates that:

local.txt 存在于本地磁盘；  
/store/memory.txt 被投递到了 KV 存储，并且通过 `search` Neng检索出来。

五、生产环境推荐配置
Coding 时我们常常照顾不到“可维护性”，但上线之后就必须考虑容错和
性。所以我建议在生产里采用以下组合：


Redis + Filesystem —— Redis Zuo快速访问层，用来保存高频交互数据；Filesystem 用来Zuo持久化日志或大对象。

PostgreSQL + S3 —— 对事务型数据使用 Postgres；对大文件则转向对象存储 S3。

InMemory + DB —— 在极轻量级环境下用 InMemory Zuo缓存，再定期同步至云 DB。


每种方案douKe以通过 CompositeBackend 灵活切换，只需修改路由表即可。
小技巧 & 常见坑点 

别忘了给 Backend 设置正确权限，否则 Agent 写不了东西啊！尤其是在容器化部署时要确保挂载卷有写权限。 

注意命名规范。FileSystem 后端Zui好不要使用类似 /tmp/ 的路径，否则会造成冲突或安全隐患。 

KV 存储默认 key 是字符串。Ru果你的业务需要geng复杂的数据结构，可自行序列化为 JSON 或 protobuf 再保存进去。 

调试时Ke以先用 InMemoryStore 验证逻辑，再切换成正式 DB，这样Neng快速定位问题而不用担心破坏生产数据。 

返回顶部 ↩️︎︎︎︎︎︎︎︎︎︎️️️️️️️️️️️🕹️‍♀‍♂‍❓💡🔭⚙️🏠🚀🎉🙈😄🐛📚💬💭⏳⌛⛔🧪🔬🔑🗃⚙⚖📈📊🧩💬🤝🙌🌐🌎🌍🌏🔥✨👀🙇‍♂✈🚢🛤🛰🚀🏁🏗🎈🎊🥳🎉🍻☕🍺🍰🥐🍴🥢🍜🍲🥟🥠🐶🐱🐭🐹🐰🐸🐵🙈🙉🙊👶👦👧👨👩🧑👴👵💁💂🤴🤵🏾🏿🏼😃😁😂🤣😅😊😉👍👏🙏😇🥰😍😘😚😙🤗🤩🆒⭐⭕✔❌☑✖✳☀☁☂☃❄♨★☆☎✉📞📟📠☎☎☎☎☎☎☎ ☎ ☎ ☎ ☎ ☎ ☎ ☎ 🎤🎧📻🎼🎹🎶🥁🎺🎷🎸⚡✨🔥🌞🌜⭐☀★☆♠♥♦♣♣♠♥♦♣ ♠♥♦♣ ⚔🛡 🗡 ⚙ 🏆 🏅 🎖 💯 📍 📌 🔍 🔎 🔭 🚦 🚥 🌐 🌋 🌪 ❄ 🎂 🍰 🎈 🕊 📅 ⏰ ⏱ ⌚ 📱 💻 🖥 🖨 👓 📺 📷 🎥 💡 🔦 🔋 📞 ✉ 💬 👇➡⬅↔↕↖↗↘↙ ➜ ➤ ↗ ↘ ➝ ⤴⤵ ↪ ↫ ➜ ➢ ➣ ⧸ ✂ ✒ ✍ ✏ 📐 📏 ♿ 🚫 ⛔ ❓ ❔ ❕ ⚠ ⚡ ⚡🔮🔮 🔭 👀 👁 🤓 😑 😐 😶 😒 🙃 😉 🙃 😬 🤐 🤫 🙈 🙉 🙊 😇 👼 👽 👾 🤖 😊 😋 🥺 🤔 🤓 😴 💤 👉 👉 👉 👉 👉 👉 👉 👉 👉