目录

• 二、主要架构与技术定位
• 三、环境准备与安装
• 四、快速了解：分钟建立第一个 Deep Agent
• 五、主要能力详解
  • 任务规划与拆解
  • 上下文管理
  • 子智能体派发
  • 长期记忆
  • Shell 执行与沙箱
• 六、自定义配置进阶
  • 自定义模型
  • 自定义程序提示词
  • 自定义工具
  • 中间件架构
  • 可插拔文件程序后端
• 七、Deep Agents CLI
• 八、与 LangChain、LangGraph 的深度对比
  • 三者关系全景图
  • 主要差异对比表
  • 同一任务的三种实现对比

  

  User Pain Point： 在实际项目中。开发者常抱怨「自己拼装 Agent 太繁琐」，「缺少统一的规划和上下文管理」导致项目进度拖慢。怎么说呢，Deep Agents 正是为了解决这些痛点而生。

  Deep Agents 是一款开箱即用的 LLM 智能体开发库由 LangChain 团队于2024 年初开源。

  灵感

  主要定位：

  本质区别： 普通框架给你积木让你自己搭，Deep Agents 直接给你一辆配置齐全的越野车——只需告诉它去哪，它自己会规划路线、加油、绕路。

  二、主要架构与技术定位

  LangChain环境金字塔

  
  ┌─────────────────────────────────┐
  │ Deep Agents │ ← Agent Harness
  │ 规划 / 文件程序 / 子智能体 │
  ├─────────────────────────────────┤
  │ LangChain │ ← 应用框架
  │ PromptTemplate / Tools / RAG │
  ├─────────────────────────────────┤
  │ LangGraph │ ← 运行时引擎
  │ State / Graph / Checkpointer │
  └─────────────────────────────────┘
  

  • LangGraph：发动机——负责真正执行流程。
  • LangChain：方向盘和仪表盘——提供丰富组件。
  • Deep Agents：整车——开箱即用，自动规划路线。

    User Pain Point： 很多团队在「多模型、多工具」场景下难以统一调度。上述金字塔把职责层层划分，让你只聚焦业务逻辑。

    Deep Agents 内置能力一览

  维度	说明
  性质	Agent Harness底层依赖LangGraph+ LangChain 主要理念保留工具调用循环。内置规划/文件/子智能体/记忆 目标使用者需要处理复杂、长运行任务的开发者 许可证 MIT

  * 任 务处理 能 力 *<\/ b><\/t dd>\內嵌規劃＋檔案系統＋子代理，使複雜任務如調研報告自動流水線化。<\/t dd><\/tr>
  * 上 下 文 管 理 *<\/ b><\/t dd>\自動壓縮+檔案卸載突破 Token 限制。<\/t dd><\/tr>
  * 生產 就緒 *<\/ b><\/t dd>\繼承 LangGraph 持久化與可觀測特性。<\/t dd><\/tr>
  * 模 型 無 關 *<\/ b><\/t dd>\兼容任意支援 Tool Call 的 LLM。<\/tdd ><\/ tr >
  ' * 完 全 開 源 * <\/ b >\ <\/ tdd >\ ' MIT 協議無供應商鎖定。< \/ tdd \ \ \ \ \ \ \ \ \ \ \ \ \ \

  ---

  推荐学习路线

  第 1–2 周：LangChain 基础 🚀

  • PromptTemplate 与 Model 调用
  • Tool 定义 与链式调用
  • 快速创建基础 Agent

  第 3–4 周：LangGraph 深入 🛠️

  • State 与 Node 概念
  • Checkpointer 持久化机制
  • 条件分支 & 循环控制

  第 5–6 周：Deep Agents 实战 🎯

  • 一行代码创建完整 Agent
  • 中间件组合
  • 说到实战项目，领域研究助手 + CLI 集成

  第 7 周以后：生产化 & 调整 📦

  • 部署到 LangSmith 或自建容器服务
  • 成本监控 & Token 调整技巧
  • 多-Agent 协作模式 & 自研 Middleware

  常用资源链接

  能力	对应工具	说明
  任务规划	write_todos	自动拆解任务为 Todo List，
  文件程序	ls,read_file,write_file,edit_file	虚拟文件程序，管理上下文
  子智能体	task	派发子任务。上下文隔离
  Shell 执行	execute	>执行命令
  >跨线程持久化 三、环境准备与安装 程序要求 = 3.10 安装 bash 再看#方式一，pip pip install deepagents 至于#方式二，uv uv add deepagents 说到#可选，安装搜索工具 pip install tavily-python API Key 配置