LangChain、LangGraph 与 Deep Agents：如何选择 Agent 架构
摘要理解 LangChain、LangGraph 与 Deep Agents 的分工，按任务复杂度选择合适的 Agent 架构。
AI Agent · 已完成
LangChain Agent 开发指南
按实际开发顺序讲清 LangChain Agent 的模型、消息、工具、状态、记忆和故障处理。
适合谁正在用 LangChain 开发 Agent，希望补齐运行机制和工程细节的开发者
先修知识能读 Python，调用过至少一种大模型 API
进度20 / 20 篇已发布
状态已完成
这组文章按真实开发时遇到问题的顺序组织：先看 Agent 循环和消息，再处理工具、状态、记忆、错误恢复与可观测性。第一次阅读建议按顺序；已经在项目里踩坑，可以直接跳到对应章节。
阶段 1
理解 Agent，完成第一次调用
建立模型、消息与工具的基础，再让输出可控、可流式展示。
什么是 AI Agent：它与普通大模型调用有什么区别？
摘要基于 LangChain 比较 AI Agent 与普通大模型调用在控制流、决策权和执行路径上的差异，并说明 Workflow 与 Agent 的选择标准。
7 个核心概念，一文看懂 LangChain 如何搭建AI Agent
摘要用 Model、System Prompt、Tools、Agent Loop、State、Middleware 与 Structured Output 七个概念理解 LangChain Agent。
LangChain create_agent 与 Model：一次 Agent 如何跑通
摘要从 create_agent 到 init_chat_model，说明 LangChain Agent 的运行循环、模型接入方式及 timeout、max_retries 等参数。
4 种 Message 一文厘清：System、Human、AI、Tool 到底怎么流转
摘要从 create_agent、invoke 与 stream 入手，说明 System、Human、AI、Tool 四种 Message 在模型和工具之间如何流转。
理解 LangChain Tool：Agent 从会回答到会执行的关键一步
摘要说明 LangChain Tool 的定义、调用机制与设计原则，以及模型决策和程序执行之间的职责边界。
让 LLM 输出真正可编程：LangChain 结构化输出指南
摘要比较 LangChain 的 ProviderStrategy 与 ToolStrategy，并用 Schema 定义可验证、可编程的 LLM 输出。
让 Agent 不再“黑盒等待”：LangChain 流式输出完整拆解
摘要讲解 stream、astream 与 updates、messages、custom 三种模式，展示 Agent 步骤、模型 Token 和自定义进度。
阶段 2
控制执行，管理状态与记忆
从中间件入手，理解短期状态、长期记忆和运行时上下文。
理解 LangChain Middleware：Agent 从“能跑”到“可控”的核心机制
摘要说明 LangChain Middleware 的生命周期与两类 Hook，并用模型选择、Prompt 注入和工具异常处理展示执行链控制方式。
LangChain Middleware 实战：搞定重试、审批和权限
摘要用 ToolRetryMiddleware、SummarizationMiddleware 与 HumanInTheLoopMiddleware 处理重试、长对话和人工审批。
一文理解 LangChain 短期记忆：状态、上下文与 Checkpoint
摘要说明 Thread、State、Checkpoint 与 Checkpointer 如何在多轮调用中保存和恢复 LangChain Agent 状态。
一文理解 LangChain 长期记忆：Store、跨会话与用户画像
摘要说明 LangChain Store 与 Checkpointer 的分工，以及 Namespace、Key、Value、语义搜索和跨会话记忆的实现方式。
一文理解 LangChain 上下文工程：让 Agent 拿到真正需要的信息
摘要说明 Agent 上下文的来源，以及选择、裁剪、摘要和动态注入策略，并展示对应的 LangChain Middleware 实现。
LangChain Agent 运行时：State、Context 与 ToolRuntime
摘要围绕一次 Agent 执行，梳理 State、Context、RunnableConfig、Runtime 与 ToolRuntime 的职责和数据边界。
阶段 3
面向生产，处理风险与故障
加入人工审批与安全边界，处理并发、动态路由、恢复和调试。
LangChain Agent 如何实现人工审核：Human-in-the-loop 从原理到实战
摘要说明 HumanInTheLoopMiddleware、Interrupt、Checkpoint、Thread 与 Command(resume) 如何配合，实现高风险工具调用的人工审核。
理解 LangChain Guardrails：如何给 Agent 加上安全边界
摘要在输入、输出和工具调用处设置安全边界，结合确定性规则、模型判断与中间件处理风险。
让 LangChain Agent 跑得更快：批量调用、并发控制与 Tool 并行
摘要区分批量任务并发与 Agent 内部工具并行，控制吞吐、资源用量和状态隔离。
从固定配置到动态路由：LangChain Agent 如何切换模型、工具与 Prompt
摘要通过中间件动态选择模型、工具与 Prompt，并厘清 State、Context 和 Store 的职责。
LangChain Agent 出错怎么办：重试、Fallback、超时与异常恢复
摘要区分重试、Fallback、超时与检查点恢复，为不同失败场景选择合适的处理方式。
LangChain Agent 调试指南：LangSmith Tracing、Token 与 Tool Call
摘要用 LangSmith 追踪模型与工具调用，定位异常，检查 Token 消耗和响应耗时。