资源说明
本库覆盖用 LangChain v1 从零搭起一个能跑上生产的智能体所需的全部技术知识：环境与分层包生态、create_agent 与工具调用循环、结构化输出、中间件横切系统、持久化记忆与状态快照、危险动作的人工审批、调用链可观测、智能体化检索增强问答、长程任务脚手架，以及贯穿各层的业务解耦复用方式与本机环境陷阱。导入后，你的 Agent 既能讲清每个机制为什么这样设计，也能给出取自真实执行的关键代码与参数，直接照着实现。
文件格式：ZIP。下载后请使用支持该格式的应用打开。
适用范围与前置条件
导入知识库或按 index.md 的阅读顺序使用；页面之间的前置关系以各页 frontmatter 为准。
怎么使用
学习路径
按前置依赖推荐的阅读顺序（前置概念在前）：
- python-env-and-venv-setup（版本门槛与虚拟环境）
- langchain-package-stack（分层包生态与版本核验，依赖 1）
- deepseek-provider-integration（模型接入与型号能力边界，依赖 2）
- create-agent-entry（智能体组装入口，依赖 2、3）
- tool-function-contract（工具三规范与 docstring 硬约束，依赖 4）
- tool-calling-loop（核心范式，依赖 4、5）
- message-stream-anatomy（消息流字段与结果路由，依赖 6）
- parallel-tool-calls（并行调用与不猜参数，依赖 6、7）
- system-prompt-boundary（提示词的职责边界，依赖 4、5）
- invoke-vs-stream（两种调用颗粒度，依赖 4、6）
- pydantic-schema-design（数据模型与两层校验，依赖 2）
- structured-output-response-format（结构化结果，依赖 4、11）
- structured-output-strategy-compat（两条策略与兼容边界，依赖 12、3）
- middleware-hooks（6 个钩子与两种写法，依赖 4、6）
- middleware-execution-order（正序进、逆序出，依赖 14）
- builtin-middleware-catalog（14 个内置中间件，依赖 14）
- pii-redaction-middleware（脱敏挡在模型之前，依赖 14、16）
- middleware-flow-control（工具兜底与提前退出，依赖 14、7）
- checkpointer-persistence（记忆来自外部存档，依赖 4、6）
- thread-id-isolation（会话命名空间，依赖 19）
- state-snapshot-inspection（打开存档看状态，依赖 19、7）
- time-travel-replay（从历史快照重放，依赖 21、19）
- checkpointer-backends（三档存储升级路径，依赖 19）
- human-in-the-loop-interrupt（危险动作前的审批闸门，依赖 19、5、20）
- interrupt-resume-replay（续跑时节点从头重执行，依赖 24）
- hitl-iron-rules（四条不能违反的纪律，依赖 24、25）
- hitl-implementation-routes（两条实现路线与传参差异，依赖 24、14）
- agent-tracing-model（调用链树与三类节点，依赖 6、7）
- langfuse-selfhost-setup（自托管观测栈，依赖 28）
- langfuse-langchain-integration（零侵入接入，依赖 28、29）
- observability-platform-choice（按合规选路径，依赖 28）
- document-chunking（切分与重叠，依赖 2）
- embedding-and-vectorstore（向量化、向量库与检索器，依赖 32）
- agentic-rag-loop（检索器变工具、自主改写重试，依赖 5、4、33）
- retrieval-grader（二元评分门控与知识边界，依赖 34、11、13）
- deepagents-harness（脚手架本质与三层取舍，依赖 4、14）
- todo-planning-mechanism（待办清单防遗忘，依赖 36、10）
- subagent-delegation（委派隔离上下文，依赖 36、9）
- virtual-filesystem-context-engineering（中间结果外置暂存，依赖 36）
- business-decoupling-reuse-pattern（各层换业务只动一处输入，依赖 4、5）
- local-environment-traps（伪装成框架报错的环境坑，依赖 1）