datawhalechina/deepagents-in-action

Public

📚 《Deep Agents 实战》—— LangChain 官方大使出品,基于 LangChain / LangGraph 生态,从零构建生产级 AI Agent 的完整指南

  • Stars2.7k+108 tuần này
  • Forks278
  • Watchers13
  • Issues5
  • Ngày tạo05/05/2026
  • Cập nhật gần nhất12/10/2026
  • Ngôn ngữJupyter Notebook
  • Giấy phép—
README.md37.4 KBRaw

Deep Agents 实战

Deep Agents 实战 — 基于 LangChain / LangGraph 的中文开源课程,感谢 2,000+ GitHub Stars

在线阅读 B 站视频 小红书图文

Deep Agents License: CC BY-NC-SA 4.0 PRs Welcome

作者:沧海九粟 · LangChain 官方认证大使 · LCAE 认证

基于 LangChain / LangGraph 的中文开源课程,配套 16 章图文、视频与实验模板。从第一个 Agent 开始,逐步掌握任务规划、文件系统、子 Agent 协作与上下文管理。

从这里开始: 环境准备 → 5 分钟上手 → 课程大纲

Note

课程从 0.5 起步,当前推荐使用最新的 Deep Agents 0.7.x。从 0.5 / 0.6 升级的读者,请先阅读 v0.7 版本更新与迁移指南。

版本要求与模型配置

旧章节和图片保留了当时的默认行为,紧邻它们的“v0.7 提醒”代表当前用法。进阶与 Beta 功能的依赖要求以各章说明为准。

功能 版本要求
FilesystemPermission 基础权限 / interrupt 模式 分别需要 deepagents>=0.5.2 / deepagents>=0.6.8
第 13 章:RubricMiddleware(Beta) 章节以 deepagents==0.7.1 验证
第 14 章:Event Streaming v3 deepagents>=0.6
第 15 章:Interpreters(Beta) Python 3.11+、langchain-quickjs>=0.2.0

示例默认通过 硅基流动 接入支持工具调用的模型,使用 MODEL_NAME 环境变量配置模型名。小模型可用于简单试跑;任务规划、上下文总结和多 Agent 编排需要更强的模型能力。

模型可用性、价格与免费额度会调整,使用前请查阅 模型广场、价格页和更新公告。框架说明见 Deep Agents 官方文档。


课程大纲

推荐技能

配合课程学习,推荐安装以下两个 AI 编码助手技能,在开发过程中获得框架级的专业指导:

# LangChain 开发指南 — 工程陷阱与验证修复
npx skills add ob-labs/agentseek --skill langchain-dev-guide

# LangSmith Trace 调试 — 追踪与性能分析
npx skills add ob-labs/agentseek --skill langsmith-trace

技能源码:langchain-dev-guide · langsmith-trace

准备篇 — 动手实操前的环境搭建与工具安装

基于 AgentSeek 工程化套件,帮助学员快速搭建开发环境:

版本更新 — 理解变化,再决定如何升级

版本更新不按功能逐条抄录,而是解释默认行为为什么改变、哪些应用会受影响,以及如何用评测和 Trace 验证迁移结果:

如果你从 0.5 或 0.6 一路学到这里,建议先读更新章,再升级依赖和重跑原有实验。v0.7 的默认 Harness 更轻,通用提示词不再重复占用每轮输入;Todo 从固定成本变成按任务选择;Middleware 可以在原位置换;文件工具新增删除能力,并明确覆盖、分页和截断语义。官方给出的 65% 是简单回合的基础输入降幅,不代表每个应用的总成本都会下降 65%。

按章节开始实验

每章下方列出实验目标和模板。第 6、8、9、11 章需按正文补充能力;第 15、16 章共用的 deepagents/subagents-dynamic 已合并至 main,可直接创建。

创建与启动模板(所有章节通用)

安装 AgentSeek,将下面的 deepagents/default 替换为对应章节的模板名:

uv tool install --upgrade agentseek
agentseek create deepagents/default --checkout main --no-input

进入生成目录,查看可用任务,按项目 README 安装依赖并配置 .env,然后检查环境、启动应用:

agentseek task --list
# 完成依赖安装与 .env 配置后
agentseek doctor
agentseek dev

用 agentseek create --list-templates --checkout main

Nội dung README thuộc về datawhalechina và cộng đồng đóng góp, giấy phép Không có giấy phép. Nguồn: github.com/datawhalechina/deepagents-in-action