LangChain · LangGraph · LangSmith 中文实战
从第一个 Agent 到生产上线
从 Agent、RAG 和工具调用，到 LangGraph 状态恢复与上线检查。示例均标注适用版本，并附可运行代码和实际输出。
想查某个 API 或概念？直接用顶部的搜索，也可以从下面的任务开始。
从你的意图开始
选一个最接近你现在情况的起点。
先在本机运行一个不需要 API Key 的 Agent，再选择 create_agent、LangGraph 或 Deep Agents。
从一次 Agent 调用到流程控制、状态保存与会话记忆，按前置概念逐步学会。
给 Agent 加护栏、接入模型服务、做 RAG 并建立评测，每一步都能重复跑出结果。
检查崩溃恢复、超时与重试、追踪隐私和发布流程。
旧项目升级、旧写法对照，以及按报错原文排查。
常用指南
不需要 API Key，在本机跑通第一个例子，看清模型每一轮收到了什么。
用同一个任务对比三种实现，确定起点和换用的时机。
接入前先检查：工具参数非法、结构化输出失败、429 与超时会怎样。
把“感觉不错”换成可以比较的数字，防止改动后悄悄变差。
发布前逐项检查超时、重试、恢复、护栏和数据外发。
13 种生产故障，按报错原文对照原因、确认方法和处理办法。
四个组件分别负责什么
LangChain：构建 Agent
create_agent 把模型、工具和中间件组合成 Agent，让模型在循环里调用工具直到任务完成。
LangGraph：编排长流程与状态恢复
需要精确控制流程、长任务恢复或人工介入时使用，重点是 checkpoint 保存了什么。
LangSmith：追踪、评测与调试
接入追踪之前，先确认会向外发送哪些数据，以及脱敏开关实际清除了什么。
langchain-classic：兼容旧接口，支持分步迁移
旧版的 LLMChain、AgentExecutor 等接口移到了这里，可以先换 import 保持行为，再逐步迁移。
文档与资料
查 API 细节，或维护旧版本项目时使用。
导入兼容矩阵和追踪环境变量对照表：只查一个事实，不用通读。
LangChain、LangGraph、LangSmith 的最新英文文档，API 细节以这里为准。
基于 v0.1.x 时期的官方文档，适合维护旧项目，不覆盖当前版本。
基于 2024 年中期 LangChain.js 0.2 时期的文档，不覆盖当前版本。
v0.1 / v0.2 时期的中文文档，旧链接依然可以打开。
常见问题
跟着做需要 OpenAI 之类的 API Key 吗？
不需要。文章里的实验脚本用的是脚本化的模型，不联网、不要密钥，你在自己电脑上就能复现页面上的每一行输出。它只能说明框架本身的行为，不代表真实模型的效果；换成真实模型要改哪里，见入门文章第五节。
如何复现文章中的代码和输出？
每篇文章都标明包版本，代码和实际输出原样放在页面里，文末的“依据与复现”给出复现命令。用同样的版本运行页面中的代码，输出应与文中一致；版本不同时，先对照适用范围，再决定要不要采用结论。
现在以 Python 还是 JavaScript 为主？
目前以 Python 为主。JS/TS 开发者可以看上方的 JS/TS 中文文档，但它基于更早的版本，不覆盖当前版本。