深度智能体概述

构建能够规划、使用子智能体并利用文件系统处理复杂任务的智能体

构建由 LLM 驱动的智能体和应用程序的最简单方式——内置任务规划、文件系统上下文管理、子智能体生成和长期记忆等功能。 你可以使用深度智能体完成任何任务，包括复杂的多步骤任务。

我们将 deepagents 视为一个”智能体框架”。它与其他智能体框架具有相同的核心工具调用循环，但内置了更多工具和功能。

deepagents 是一个独立库，构建在 LangChain 的智能体核心构建模块之上，并使用 LangGraph 的工具在生产环境中运行智能体。

deepagents 代码仓库 包含：

• 深度智能体 SDK：一个用于构建能处理任何任务的智能体的包
• 深度智能体 CLI：基于深度智能体 SDK 构建的终端编程智能体
• ACP 集成：用于在 Zed 等代码编辑器中使用深度智能体的 Agent Client Protocol 连接器

LangChain 是为你的智能体提供核心构建模块的框架。 要了解 LangChain、LangGraph 和深度智能体之间的区别，请参阅框架、运行时和框架。要查看与 Anthropic 框架的并排比较，请参阅深度智能体 vs. Claude Agent SDK。

创建一个深度智能体

import * as z from "zod";
// npm install deepagents langchain @langchain/core
import { createDeepAgent } from "deepagents";
import { tool } from "langchain";

const getWeather = tool(
  ({ city }) => `${city}总是阳光明媚！`,
  {
    name: "get_weather",
    description: "获取指定城市的天气",
    schema: z.object({
      city: z.string(),
    }),
  },
);

const agent = createDeepAgent({
  tools: [getWeather],
  systemPrompt: "You are a helpful assistant",
});

console.log(
  await agent.invoke({
    messages: [{ role: "user", content: "东京的天气怎么样？" }],
  })
);

请参阅快速入门和自定义指南，开始构建你自己的智能体和应用程序。

使用 LangSmith 跟踪请求、调试智能体行为并评估输出。按照跟踪快速入门进行设置。准备好投入生产时，部署到 LangSmith Cloud 以获得托管服务。

何时使用深度智能体

当你想构建能够执行以下操作的智能体时，请使用深度智能体 SDK：

• 处理复杂的多步骤任务，需要规划和分解
• 管理大量上下文，通过文件系统工具和摘要
• 切换文件系统后端，使用内存状态、本地磁盘、持久化存储、沙箱或自定义后端
• 执行 Shell 命令，在使用沙箱后端时通过 execute 工具
• 运行解释器代码，使用解释器进行工具组合、子智能体编排和结构化数据转换
• 委派工作给专门的子智能体以实现上下文隔离
• 持久化记忆，跨对话和线程
• 控制文件系统访问，使用声明式权限规则限制智能体可以读写的文件
• 要求人工审批，通过人机协作工作流处理敏感操作
• 使用任何模型——提供商无关，支持前沿和开源模型

对于构建更简单的智能体，可以考虑使用 LangChain 的 createAgent 或构建自定义的 LangGraph 工作流。

核心能力

规划和任务分解

深度智能体包含内置的 write_todos 工具，使智能体能够将复杂任务分解为离散步骤、跟踪进度，并在获得新信息时调整计划。

上下文管理

文件系统工具（ls、read_file、write_file、edit_file）允许智能体将大量上下文卸载到内存或文件系统存储中，防止上下文窗口溢出，并支持处理可变长度的工具结果。自动摘要功能会在上下文窗口增长时压缩较早的对话消息，使智能体在长时间会话中保持有效。

Shell 执行

使用沙箱后端时，智能体可以获得 execute 工具来运行 Shell 命令，用于测试、构建、git 操作和系统任务。沙箱后端提供隔离环境，智能体可以执行代码而不会影响你的主机系统。

解释器

添加解释器以在内存运行时中运行 JavaScript。解释器让智能体能够以编程方式组合工具、编排子智能体，以及在没有完整 Shell 环境的情况下转换结构化数据。

可插拔的文件系统后端

虚拟文件系统由可插拔后端驱动，你可以根据用例进行切换。可从内存状态、本地磁盘、用于跨线程持久化的 LangGraph 存储、用于隔离代码执行的沙箱（Modal、Daytona、Deno）中选择，或使用复合路由组合多个后端。你也可以实现自己的自定义后端。

子智能体生成

内置的 task 工具使智能体能够生成专门的子智能体以实现上下文隔离。这可以保持主智能体的上下文整洁，同时仍然可以深入处理特定子任务。

长期记忆

使用 LangGraph 的 Memory Store 扩展智能体以实现跨线程的持久记忆。智能体可以保存和检索之前对话中的信息。

文件系统权限

声明权限规则来控制智能体可以读写的文件和目录。子智能体可以继承或覆盖父级的规则。

人机协作

使用 LangGraph 的中断功能为敏感工具操作配置人工审批。控制哪些工具在执行前需要确认。

技能

使用可复用的技能扩展智能体，提供专门的工作流、领域知识和自定义指令。

智能默认值

附带有见解的系统提示，教模型如何有效使用其工具——在行动前规划、验证工作并管理上下文。可根据需要自定义或替换默认值。

开始使用

快速入门

构建你的第一个深度智能体

自定义

了解自定义选项

模型

配置模型和提供商

后端

选择和配置可插拔的文件系统后端

解释器

在 QuickJS 中组合工具和转换数据

权限

使用权限规则控制文件系统访问

人机协作

为敏感操作配置审批

CLI

使用深度智能体 CLI

参考文档

查看 deepagents API 参考文档

---

通过 MCP 连接这些文档到 Claude、VSCode 等工具，获取实时答案。

在 GitHub 上编辑此页面或提交问题。