面向正在做或准备转型AI Agent 开发者的 LangGraph TypeScript 完全指南。
📚 前置教程:建议先阅读专栏《深入浅出LangChain》,掌握Agent基础概念后再学习本教程。
📖 本专栏介绍
本专栏是专为正在做或想要转入 AI Agent 开发领域的开发者量身打造的技术系列教程。全教程以LangGraph TypeScript 最新版(@langchain/langgraph)为核心,带你从零开始,由浅入深,最终具备独立构建生产级 AI Agent 系统的能力。
关于 Python 版本:LangGraph 同样支持 Python,两者 API 设计理念一致。本专栏以 TypeScript 版本为主,读者可将所学原理平迁至 Python 版本使用。
💡重要提示:如果你还没有阅读《深入浅出LangChain》,强烈建议先从那里开始。本教程是LangChain.js的进阶篇,假设你已经熟悉Agent的基本工作原理。
🎯 目标读者
- ✅ 已阅读《深入浅出LangChain》,想深入学习LangGraph的工程师
- ✅ 有一定 JavaScript/TypeScript 基础,想转入 AI Agent 开发的前后端开发者
- ✅ 了解 LangChain 基础,想深入学习 LangGraph 编排能力的工程师
- ✅ 想构建可靠、可控、可扩展的 AI Agent 系统的技术人员
- ✅ 对 AI 工作流、多智能体系统感兴趣的架构师
📋 前置知识
| 知识点 | 要求程度 | 说明 |
|---|---|---|
| 《深入浅出LangChain》 | ⭐⭐⭐⭐⭐ | 强烈建议先完成,特别是Agent基础章节 |
| TypeScript 基础语法 | 必须掌握 | async/await、接口、泛型等 |
| Node.js 基础 | 必须掌握 | 模块系统、npm等 |
| LLM / ChatGPT 基本概念 | 了解即可 | Prompt、Token、Context Window |
| LangChain 基础 | 了解更佳 | 模型调用、工具定义、ReAct模式 |
📚 推荐阅读顺序
🌟 第一步:阅读导读(5分钟)
👉《深入浅出 LangGraph—导读》- 了解本教程的定位、学习路线和最佳实践。
📖 第二步:确认前置知识
如果你还没有阅读《深入浅出LangChain》,至少请先完成以下章节:
- 《深入浅出 LangChain — 第一章:AI Agent 开发导论》
- 《深入浅出 LangChain —— 第四章:提示词工程》
- 《深入浅出 LangChain —— 第五章:工具系统》
🚀 第三步:开始学习
按照下面的目录顺序,循序渐进地学习…
💡 系列文章正在马不停蹄地写作中,你可以订阅该专栏,每日都会更新。
第一部分:入门篇 —— 认识 LangGraph
| 章节 | 标题 | 核心内容 |
|---|---|---|
| 第 1 章 | AI Agent 时代与 LangGraph | AI Agent 概念、LangGraph 定位、生态系统、快速上手 |
| 第 2 章 | 环境搭建与第一个 Agent | 安装配置、Hello World、StateGraph 基本用法 |
| 第 3 章 | 图的核心概念:节点、边与状态 | StateGraph、Node、Edge、State、Annotation |
| 第 4 章 | 状态管理深入:如何设计 State | State Schema 设计、Reducer 函数、消息状态、自定义状态 |
第二部分:进阶篇 —— 掌握核心能力
| 章节 | 标题 | 核心内容 |
|---|---|---|
| 第 5 章 | 条件边与动态路由 | 条件边、路由函数、多路分发、循环图设计 |
| 第 6 章 | 工具调用与 Tool Node | 工具定义、ToolNode、错误处理、自定义工具 |
| 第 7 章 | 持久化与检查点机制 | Checkpointer、MemorySaver、PostgresSaver、状态回放 |
| 第 8 章 | 人机交互:中断与审批流程 | interrupt()、Command、人工审核、修改状态后继续 |
| 第 9 章 | 流式输出:实时响应用户 | stream()、streamMode、Token 流、事件流、UI 集成 |
| 第 10 章 | 记忆系统:短期与长期记忆 | 会话内记忆、跨会话记忆、记忆存储、记忆检索 |
| 第 11 章 | 子图:构建模块化 Agent | Subgraph、图组合、状态传递、模块化设计 |
第三部分:专家篇 —— 高阶设计模式
| 章节 | 标题 | 核心内容 |
|---|---|---|
| 第 12 章 | 多 Agent 系统架构 | 主管模式、网络模式、Agent 通信、任务分发 |
| 第 13 章 | Functional API:函数式工作流 | @entrypoint、@task、与 Graph API 对比、适用场景 |
| 第 14 章 | 持久化执行与故障恢复 | 长时任务、中断恢复、超时处理、幂等设计 |
| 第 15 章 | 时间旅行:调试与状态回溯 | Time Travel、状态回溯、重放历史、调试技巧 |
| 第 16 章 | 生产部署与 LangSmith 集成 | 应用结构、LangSmith 追踪、性能监控、部署最佳实践 |
第四部分:实战篇 —— 真实项目构建
| 章节 | 标题 | 核心内容 |
|---|---|---|
| 第 17 章 | 实战一:智能客服 Agent 系统 | 意图识别、知识库检索、工单管理、多轮对话 |
| 第 18 章 | 实战二:代码审查 Agent | 工具链集成、多步骤分析、报告生成、自动修复建议 |
| 第 19 章 | 实战三:多 Agent 研究助理 | 任务拆解、并行搜索、信息汇总、结构化输出 |
| 第 20 章 | 实战四:生产级 Agent 平台 | 完整架构、前后端集成、监控告警、CI/CD 部署 |
🛠️ 技术栈
| 技术 | 版本 | 说明 |
|---|---|---|
@langchain/langgraph | 1.2.9+ | 核心框架 |
@langchain/core | 1.1.40+ | LangChain 核心 |
@langchain/openai | 最新版 | OpenAI 集成 |
| TypeScript | 5.x | 开发语言 |
| Node.js | 20+ | 运行环境 |
| Zod | 3.x | Schema 验证 |
🔗 参考资源
- LangGraph 官方文档
- LangGraph GitHub
- LangChain Academy(免费课程)
- LangSmith 平台
本专栏持续更新,跟随 LangGraph 最新版本迭代。当前覆盖版本:
@langchain/langgraph@1.2.9