
deepagentsjs
开箱即用的 TS 智能体框架,复杂任务自动拆解执行
deepagentsjs 是 LangChain 团队推出的 TypeScript 智能体开发框架,定位为“开箱即用的 agent harness”。它基于 LangGraph 构建,把构建复杂智能体所需的常用能力打包成可复用组件,解决开发者从零搭建 agent 时反复处理规划、子任务分解、文件系统操作、子智能体调度等基础设施的问题。核心能力包括:内置规划与任务分解工具,让模型自主拆解复杂目标;提供虚拟文件系统接口,方便读写与持久化中间产物;支持派生子智能体处理并行或专项任务;与 LangChain 生态无缝集成,可直接调用模型、工具与记忆模块。相比裸用 LangGraph,它把常见 agent 模式固化为默认行为,降低样板代码量,适合需要快速验证多步骤 agent 工作流的 TypeScript 团队。
项目数据
使用教程
环境要求
- Node.js 与 npm 环境(README 未标注具体版本,npm 包安装所需)
- TypeScript 5.0+(README 徽章标注)
- 浏览器环境需使用 browser 入口,避免 Node 专属导出
安装与启动步骤
-
1安装依赖包
在项目根目录执行 npm 安装命令,这是 README 中给出的唯一安装方式。
npm install deepagents -
2选择运行入口
按运行环境选择入口:Node.js 服务端用 deepagents,浏览器用 deepagents/browser。
import { createDeepAgent, StateBackend } from "deepagents/browser"; import { createDeepAgent, FilesystemBackend } from "deepagents"; // import { createDeepAgent, FilesystemBackend } from "deepagents/node"; -
3编写智能体代码
使用 createDeepAgent 创建智能体,README 未给出完整示例,参数用法请查阅官方文档。
如何确认成功
在代码中成功 import { createDeepAgent } from "deepagents" 并运行,无模块找不到的报错。
常见问题
Q:浏览器环境可以直接用 deepagents 吗?
A:不建议。浏览器请使用 deepagents/browser 入口,它不含 Node 专属导出;deepagents 为默认 Node.js/服务端入口。
Q:Node.js 下有两个入口该怎么选?
A:deepagents 与 deepagents/node 提供相同的完整 API,默认使用 deepagents 即可,deepagents/node 为可选的显式入口。
Q:安装后怎么确认装上了?
A:在代码中 import deepagents 相关导出,能正常编译运行且不报模块缺失,即表示安装成功。
注意事项
- README 仅提供 npm install deepagents 一条安装命令,其余初始化代码请参考官方文档 https://docs.langchain.com/oss/javascript/deepagents/overview
- 浏览器打包场景务必改用 deepagents/browser,否则可能引入 Node 专属依赖导致构建失败
- 项目基于 LangGraph 构建,需自行准备并配置 LangChain 生态所需的模型调用凭据
核心亮点
- 内置规划、文件系统、子智能体等常用能力,减少从零搭建的样板代码
- 基于 LangGraph 与 LangChain 生态,模型、工具、记忆可直接复用
- TypeScript 原生实现,类型友好,适合前端/Node 团队快速上手
不足之处
- 项目较新,API 与文档仍在快速迭代,稳定性待观察
- 社区规模尚小,第三方示例与问题解答资源有限
适用场景
- 构建需要多步骤规划与执行的自动化研究助手
- 在 Node 服务中集成可调用工具与文件操作的智能体
- 快速验证基于 LangGraph 的多智能体协作原型
替代项目
LangGraph、CrewAI
项目介绍
上一篇:langchain-nvidia
下一篇:langchain-azure
同类项目推荐
ComfyUI_Custom_Nodes_AlekPet
开源
给 ComfyUI 装上语音翻译和姿态检测,工作流更全能
Custom nodes that extend the capabilities of Comfyui
langchain
开源
组装 AI 应用的乐高积木,从想法到上线不换工具
The agent engineering platform.
transformers
开源
全球最大的模型仓库全家桶,想用的模型一把抓
Transformers: the model-definition framework for state-of-the-art machine learning m···
bruno
开源
把 API 测试当代码管理,用 Git 搞定协作与版本追踪
Opensource IDE For Exploring and Testing API's (lightweight alternative to Postman/I···