§01 DeepAgents 是套在 LangChain 上的工具套件

先给结论：DeepAgents 不是新框架，是 LangChain 之上的"有主见的默认配置"。

2025 年底，我第一次读它的源码。一句话记住它：它是一个 agent harness（智能体工具套件）。

什么意思？看这三层关系。

LangChain  → 基础构件（model、tool、prompt）
LangGraph  → 运行时（持久化、流式、中断、状态图）
DeepAgents → 工具套件（规划、文件系统、子代理、记忆）

LangChain 给你积木。LangGraph 给你跑积木的跑道。 DeepAgents 直接把积木拼好，还配好了说明书。

你看，它不替代 LangGraph。它站在 LangGraph 肩膀上。 核心函数只有一个：create_deep_agent()。 它返回一个编译好的 LangGraph 状态图（CompiledStateGraph）。

标叔的经验：我踩过最大的坑，是把 DeepAgents 当普通 LangGraph wrapper 用。结果 HITL 失效、子代理不注册、Skills 用不上。后面 §19 我会细讲。先记住：用框架，就按框架的设计意图用。

为什么需要它？因为成功的"深度 Agent"都有四个共同点： 规划工具、子代理、文件系统、精细提示词。

Claude Code 有。Deep Research 有。Manus 也有。 DeepAgents 把这套模式，做成开箱即用的默认能力。

所以你写几行代码，就拥有别人要自己搭很久的东西。

标叔的结论：如果你要做多步骤、长任务、要记忆的 Agent，DeepAgents 值得一试。简单的一次性调用，它反而重了。

注意：DeepAgents 需要支持 tool calling 的模型。纯文本模型跑不了。

下一章，我带你 5 分钟跑通第一个 Agent。