DeepAgents 快速上手教程

发 生 了什么

掘金上发 布了 一篇实 战教程，带 领 开 发者使 用 DeepAgents 构 建一 个生产可 用的 Agent 应用。 De epAgents 是一 个以 TypeScript 为核心的 Agent 框架，构 建于 LangChain 和 LangGraph 之上。 教 程预 计 完 成时 间为 60 分钟，在 一 个客 服场景中完 整 覆盖了工具调用 、子 Agent、人工审 批中断（ human - in-the-loop） 、记忆、 技能模 块以 及流式输出等核心 能 力。

教程明 确将 DeepAgents 与 Claude Agent SDK 和 Codex SDK 进 行对比，将 其定位为更 高层 级 的" 框 架层 （ harness）"， 而非底 层能 力 SDK。作者认 为这一 区 别至 关重要： DeepAgents 预 先 内 置了 Plan → Act → Check → Recover 的执行循 环，团 队可以快 速 搭建出 可 运 行的 Agent 骨架， 再 按 需下 沉到 LangGraph 原 语 层实 现自定义控制流。

为什么值 得关注

对 于正 在评估 Agent 框 架的工程团队来说 ，这 篇教程的定 位思 路值 得细 读 。 教 程清 晰地划 分了三 层 技 术 栈：

• L angChain —— 组件层（模 型、工具、RAG、 提 示词）
• LangGraph —— 运行 时引擎（分 支 、检查点、中断/ 恢复）
• Deep Agents —— 框 架层（预组 装 骨架、上下文治 理、错 误 恢复）

这种 分层方 式与 成 熟团 队在 生 产环境中构 建 Agent 的 实际 路 径高 度吻合—— 不是单 体 式 的 L L M 调用，而是带 有明确 恢复路 径的有 状 态工 作流。教程着 重演 示的 中 断- 恢复模式（ 退 款 执 行前 需 人 工审批）反 映了一 个 真实的运 营需求， 而 大 多数" Hello World"级 别 的 Agent Demo 对 此 完 全 忽略 。

对于正 在评估 Agent 基 础设施自 建 还 是采 购的 C TO 而 言： DeepAgents 与 LangGraph 官 方的 create_ react_agent 预 置 方 案以 及 OpenAI 的 Agents SDK 处 于同一 竞争 赛道，但它 主 要面向已 深 度投 入 LangChain/L angGraph 生态、 希 望快 速上手而 又 不想 放 弃现 有技术 栈的团 队。

教程 通 过 p npm 安 装， 需 要三个核心依 赖包 ：

最 简 Agent 通 过 createDeepAgent 调 用初 始化，接受 provider :model 格式 的 model 字 符串（例 如 open ai:gpt-5.4 ）以 及一 个 systemPrompt 。工具使用 Lang Chain 的 tool() 辅助函数定 义，配 合 Zod schema 进 行输入校 验—— 这 是标准的 LangCh ain 工具写 法，没有任 何私 有 DS L。

客服场景演示了 两个对 接 模 拟 API 的 工具： query_ order （订单查询）和 query_warranty（保 修 状态查询）。在生 产部 署中，这两 个工具分 别代 理 到 O MS 和保修 系统 API。 针 对高风险操作（如 退款）的 中断/恢复模式 ， 底 层使用了 LangGraph 原 生 的检查点机制，这 意味着团队无 需自 行 实现即 可获得持 久化 的 执行状态。

整 体 架构遵循作 者定义的 Harness 模式：优 先规 划执行、通 过工具调用产 生副 作用、每 阶段进行验证、在 中断或 超时后支 持状 态恢复。本 质 上是带 有预 设 默 认配 置的 LangGraph State Graph。

后 续值 得关注

• 未 来 30 天内 DeepAgents 在 npm 和 GitHub 上的活 跃度—— 采 用情 况 将 决定它 是真 正获 得 市 场认可， 还是仅停 留在教程受 众 圈子 内
• L angGraph 自 身 的预置 Agent 抽象正 在快 速演 进，关 注其 功 能对 齐公 告， 这 可 能会压 缩 DeepAgents 的差 异化空 间
• Claude Agent SDK 和 Open AI Agents SDK 均 有 活跃的路 线图——任何在 此 赛道 竞争的 TypeScript-first 框架都需要密 切 跟踪它 们的工具 调用和中断 API 动 态
• 教程中 使 用 open ai:gpt-5.4 作为模型 字符串——需 关 注这 究 竟是真 实的模型版本号 还是占 位符，目 前 GPT-5 的 具 体版本命 名 尚未得 到公 开确认