deepagents 是什么?

Deep Agents 是 LangChain 推出的「开箱即用的智能体 harness(运行框架)」。它是一个有明确预设、装好就能跑的智能体——但每一部分都可被扩展、覆盖或替换。它构建在 LangGraph 之上,把规划、文件系统、子智能体、上下文管理、技能等长程多步任务所需的能力打包成默认配置(batteries-included),同时保持模型无关(任何支持工具调用的 LLM 都可用)。许可为 MIT,约 23,245 stars;另有 JavaScript/TypeScript 版本 deepagents.js。项目自述灵感来自 Claude Code——试图提炼出让它「通用」的要素并进一步推进。

⭐ 21,475 Stars 🍴 3,004 Forks Python 作者: langchain-ai
来源:README.md(首段、Principles、Acknowledgements);GitHub 仓库元数据(stars=23245、license=MIT、homepage docs.langchain.com/deepagents) 查看 GitHub 仓库 →

为什么值得关注

2025–2026 年「智能体 harness」(在模型循环之上提供规划、记忆、工具、子智能体等通用脚手架)成为构建可用 AI 代理的关键层。Deep Agents 来自 LangChain 生态、构建在成熟的 LangGraph 之上,主打「开箱即用 + 可逐件替换 + 模型无关 + 生产就绪」,并明确定位在 LangChain 的 create_agent 之上、提供更完整的预设中间件。它还附带一个类似 Claude Code/Cursor 的预构建终端编码智能体(Deep Agents Code)。背靠 LangChain 生态与 LangSmith 的可观测/评估/部署能力,使其在想快速搭建长程智能体的开发者中关注度高。截至数据采集约 23,245 stars。

来源:README.md(Principles、FAQ 的分层说明、Deep Agents Code 注记);GitHub 仓库元数据(stars=23245)

核心功能

子智能体(隔离上下文)

把任务委派给拥有独立上下文窗口的子智能体,避免主线程上下文被污染;任意 LangGraph 编排图都可作为子智能体接入。

来源:README.md(Features → Sub-agents;FAQ 的 CompiledStateGraph 子智能体说明)
文件系统与 Shell

对可插拔的本地/沙箱/远程后端读写、编辑、搜索文件,并能在所选沙箱中运行 shell 命令。

来源:README.md(Features → Filesystem、Shell access)
上下文管理与持久记忆

对长线程做摘要、把工具输出卸载到磁盘以控制上下文;通过可插拔的 state/store 后端实现跨会话记忆。

来源:README.md(Features → Context management、Persistent memory)
人在环路与技能

工具调用执行前可由人审批、编辑或拒绝;技能(Skills)是可按需加载的可复用行为,工具可自带函数或接入任意 MCP server。

来源:README.md(Features → Human-in-the-loop、Skills、Tools)
模型无关、生产就绪

支持任何具备工具调用的 LLM(前沿 API、开放权重、本地 Ollama/vLLM/llama.cpp);构建在 LangGraph 上,具备流式、持久化、检查点,配 LangSmith 做追踪/评估/部署。

来源:README.md(Principles、FAQ 的开放权重/生产问题)

技术架构

Deep Agents 是分层栈中的最上层 harness:LangGraph 是图运行时,LangChain 的 create_agent 是其上的最小 harness,Deep Agents 则是 create_agent 之上更有预设的 harness——同样的构件,但内置了文件系统、子智能体、上下文管理和技能等中间件。核心入口是 Python 的 create_deep_agent(传入 model、tools、system_prompt 即可),返回的智能体能规划、读写文件、自管上下文。各能力都做成可插拔后端:文件系统可选本地/沙箱/远程,记忆/状态可选不同 store 后端,shell 在所选沙箱中执行。由于它本质是 LangGraph 上的智能体,天然获得流式、持久化、检查点能力,并能与 LangSmith 的追踪/评估/部署对接;任何 LangGraph 的 CompiledStateGraph 都能作为子智能体传入,便于把自定义编排与默认 harness 组合。仓库的 examples/ 提供了大量可运行模式(异步子智能体服务、深度研究、内容生产等)。

来源:README.md(FAQ 的三层关系、Features、Quickstart);git tree(examples/ 各目录)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) langgraph langchain(chat models 抽象)langchain(cha… 可选 MCP server 接入可选 MCP serve… ripgrep(文件搜索)ripgrep(文件搜… 子智能体(隔离上下文) 文件系统与 Shell 上下文管理与持久记忆 人在环路与技能 模型无关、生产就绪 deepagents 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言Python(主库)、TypeScript/JavaScript(deepagents.js)框架LangGraph(图运行时)+ LangChain create_agent 之上的 harness
langgraphlangchain(chat models 抽象)可选 MCP server 接入ripgrep(文件搜索)
PyPI 包 deepagents(uv add deepagents);与 LangSmith 集成做追踪/评估/部署;examples 用 uv 管理
来源:README.md(Quickstart、FAQ、Resources);release notes(ripgrep 相关修复);git tree(pyproject.toml、uv.lock)

快速上手

Python 安装:uv add deepagents。最简用法:from deepagents import create_deep_agent,传入 model(如 "openai:gpt-5.5")、tools 列表和 system_prompt,得到 agent 后用 agent.invoke({"messages": "..."}) 调用;该智能体能规划、读写文件并自管上下文,可加自定义工具、换模型、定制提示、配置子智能体。JS/TS 用户用 deepagents.js。另有预构建的终端编码智能体 Deep Agents Code(类似 Claude Code/Cursor,可用任意 LLM),按官方文档安装。生产部署建议结合 LangSmith 做追踪与评估。安全上需注意:Deep Agents 采用「信任 LLM」模型,智能体能做其工具允许的一切,边界应在工具/沙箱层强制,而非指望模型自我约束。
来源:README.md(Quickstart、Deep Agents Code 注记、Security 段落)

使用场景

适合需要构建长程、多步、可委派的 AI 智能体的开发者:研究助手(检索并写报告)、内容生产(博客/社媒等多子智能体协作)、需要文件系统与 shell 的自动化任务、以及希望在 LangGraph/LangChain 生态内快速拿到「带规划+上下文管理+子智能体」完整 harness 的团队。需要更轻量时可降到 LangChain 的 create_agent,需要完全自定义循环时降到 LangGraph——三层可组合。由于采用「信任 LLM」模型,涉及敏感操作的场景必须在工具与沙箱层设好边界。

来源:README.md(Quickstart、examples、FAQ 的分层选择、Security)

优势与局限

优势

  • 开箱即用又可逐件替换,预设面向长程多步任务,省去自己搭脚手架
  • 构建在成熟的 LangGraph 上,天然有流式/持久化/检查点,生产就绪
  • 模型无关,支持前沿/开放权重/本地模型,并能接入 MCP 工具
  • 与 LangChain/LangSmith 生态深度衔接,追踪/评估/部署链路完整,示例丰富

局限

  • 绑定 LangChain/LangGraph 生态,已有其它栈的团队需评估迁移成本
  • 「信任 LLM」安全模型要求使用者自行在工具/沙箱层设边界,否则风险较高
  • 「batteries-included」的预设对极简或非常规需求可能偏重,需要降层使用
  • 完整生产能力(追踪/评估/部署)依赖 LangSmith 等配套
来源:README.md(Principles、FAQ 的分层选择、Security 段落)

最新版本

最新发布为 deepagents==0.6.3(2026-05-20),以 bug 修复为主:把 ripgrep 的 glob 锚定到搜索根目录、为缺少 ID 的消息在 _messages_delta_reducer 中分配 UUID、澄清系统提示中的技能来源标签、以及在把记忆内容注入系统提示前剥离 HTML 注释(后者也是一项安全/稳健性改进)。整体是一个偏稳定性与细节修复的小版本。

来源:GitHub releases/latest(deepagents==0.6.3,Bug Fixes 段落)

总结评价

Deep Agents 给「智能体 harness」这一关键层提供了一个来自 LangChain 生态、构建在 LangGraph 上的成熟选择:开箱即用、模型无关、生产就绪,且每一部分都可替换。对想快速搭建带规划、上下文管理、子智能体和技能的长程智能体、又愿意用 LangChain/LangSmith 生态的团队,它是很顺手的起点;它对 Claude Code 的借鉴也使其在通用智能体能力上有清晰的设计目标。要权衡的是生态绑定、对 LangSmith 的依赖,以及「信任 LLM」模型下必须自己在工具/沙箱层把好安全边界。

来源:综合 README.md 的定位/分层说明、Security 模型与 release 信息
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-24 12:15. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件