全部文章
全部文章：LangChain 与 LangGraph 实战指南目录
文章已按读者意图整理到各栏目：开始、系统学习、开发指南、生产实践、排错与迁移和参考手册。这里按阅读顺序列出所有文章，方便从旧链接进入的读者找到位置。
- LangChain v1 入门：用 create_agent 跑通第一个 Agent（无需 API Key） 从零用 LangChain v1 的 create_agent 搭一个会调用工具的 Agent：展示一次调用的消息轨迹、模型收到的工具定义、invoke 输入的 7 种写法，以及 7 个新手常见错误。
- create_agent 还是 LangGraph？同一任务两种实现的选型决策表 用同一个客服退款任务分别实现 create_agent 与手写 LangGraph：对比轨迹、代码量、人工审批与审核回路，并给出哪些需求该用哪一种的决策表。
- Deep Agents、create_agent、LangGraph 怎么选：同一任务三种实现 用同一个客服任务比较 Deep Agents、create_agent 与手写 LangGraph：工具面、大结果卸载、子 Agent 隔离、文件寿命、审批与失控护栏，并给出选型决策表。
- Agent 中间件与安全护栏：限流、脱敏、重试与降级 用脚本化模型展示 create_agent 内置中间件的边界行为：失控循环如何被限流终止、PII 脱敏漏掉哪些路径、重试与降级的组合顺序，以及中间件对 recursion_limit 的额外消耗。
- OpenAI 兼容模型接入检查：工具调用、结构化输出、超时与重试 用本地模拟的 OpenAI 兼容服务检查 ChatOpenAI 接入：工具参数非法时 Agent 静默结束、两种结构化输出各自失败、429 与超时放大多少请求，附可复用的检查脚本与排查表。
- RAG 切分与检索参数：chunk_size、overlap 和 MMR 怎么选 用一份合成中文语料比较 RecursiveCharacterTextSplitter 的切分参数：默认分隔符为何切断中文句子、chunk_size 对召回与上下文长度的影响、overlap 何时有效，以及 MMR 与 overlap 的冲突。
- RAG 检索评测：用 hit@k、MRR 发现逐题回归 用一个可复现的中文小评测集说明 RAG 检索评估：直接问法与改写问法的指标落差、汇总指标掩盖逐题回归、逐题保护的回归检查，以及 20 道题的统计噪声有多大。
- LangGraph checkpoint 与故障恢复：崩溃后如何安全续跑 用一个会重复扣款的订单流程复现并记录 LangGraph 的 checkpoint 行为：崩溃续跑、进程重启恢复、待写入机制、interrupt 重跑、幂等键、重放与 RetryPolicy 的默认行为。
- ChatOpenAI 超时与重试：如何计算一次调用的最坏耗时 复现并记录 ChatOpenAI 的超时与重试行为：在测试的版本中默认客户端没有超时，退避和 Retry-After 如何拉长最坏延迟，timeout 为什么不是总时长上限，以及 SDK 与中间件两层重试如何相乘。
- LangSmith 追踪上线前检查：外发数据、脱敏与故障影响 用本地接收端抓取 LangSmith SDK 的真实上传内容：哪些字段明文外发、各脱敏开关实际清掉了什么、中文手机号正则为何失效，以及追踪服务中断时进程退出会被拖多久。
- LangChain 生产发布检查表：上线前必须确认的 7 项 把上线前核对写成 7 项可执行预检并逐项注入故障验证：依赖锁定、导入、密钥、超时预算，以及并发下的会话隔离、SQLite 线程限制和同一会话的丢更新。
- LangChain 旧教程迁移到 v1：导入、调用与报错对照 按旧教程里的 import、调用方式和参数名，逐条对照 LangChain 0.3.27 与 1.4.7 的实际运行结果，给出新写法、需要安装的包，以及常见报错的原因和处理办法。
- LangChain 生产故障速查：13 类报错的原因与处理 把 LangChain v1 与 LangGraph 项目最常遇到的 13 种报错与静默失败逐个复现，给出原文报错、原因、确认方法和处理办法，并链接到详细实验。
- 工具调用 schema 排障：docstring、参数校验与异常处理 说明 LangChain 工具定义如何变成模型看到的 JSON schema：docstring 的两种写法、7 类参数校验结果，以及工具抛异常时三种处理方式对 Agent 运行的不同影响。
- LangChain 从 v0.x 升级到 v1：分步迁移与回滚 把使用 AgentExecutor、LLMChain 的 LangChain 0.x 项目升级到 v1：先用 langchain-classic 零行为变更换 import，再迁到 create_agent；附真实运行输出、行为差异和回滚方案。
- 旧 RAG 入库代码升级到 v1：加载、切分、向量库怎么换，结果变不变 旧教程的 RAG 入库代码（TextLoader、RecursiveCharacterTextSplitter、FAISS）在 0.3.27 与 1.4.7 下逐项对比：换哪个包、输出是否一致，以及 langchain-community 停止维护后各环节怎么取舍。
- RetrievalQA 与 LLMChain 迁移到 LCEL：保持结果一致 把旧版 RetrievalQA、LLMChain 改写成 LCEL 链之前先量一遍：发给模型的消息是否一致、输出形状哪里变了、三种 chain_type 各调用几次模型、检索为空时旧链会怎样，以及怎样保持调用方不改。
- ConversationBufferMemory 迁移到 v1：thread_id、持久化与历史裁剪 旧版 ConversationBufferMemory 在 v1 里怎么替代：checkpointer 与 thread_id 的会话隔离、忘记配置时的静默失忆、两种历史裁剪的取舍，以及重启后的持久化与删除，均附脚本与实际输出。
- LangChain v1 导入兼容矩阵 在 langchain 0.3.27、1.4.7 以及 1.4.7 加 langchain-classic 三种环境里逐个导入 36 个常用符号，给出可用性矩阵与迁移目标，每个结果都来自真实运行。
- LANGCHAIN_TRACING_V2 与 LANGSMITH_TRACING：新旧变量并存时谁生效 旧教程写 LANGCHAIN_TRACING_V2，官方新文档写 LANGSMITH_TRACING。两者并存时开关以旧名字为准，项目、密钥和端点以新名字为准；附 0.3.27 与 1.4.7 的对比和自检脚本。
最后更新于