LangChain 官方文档学习计划
基于 LangChain Python 官方文档 整理，笔记存放于 lang-chain/（主体笔记）与 link/（入口与官方链接索引）。要求：简明扼要、方便记忆、无遗漏，按步骤执行。
目录与文件约定
| 目录 | 用途 |
|---|---|
docs/tech-stack/ai-agent/link/ | 入口页、官方链接索引（如 lang-chain.mdx） |
docs/tech-stack/ai-agent/lang-chain/ | 按官网结构整理的笔记（按模块分文件） |
第一阶段：入门（Get started）
| 步骤 | 官方章节 | 本地笔记路径 | 核心要点（笔记需覆盖） |
|---|---|---|---|
| 1.1 | Overview | lang-chain/01-getting-started/overview.mdx | LangChain 是什么、与 LangGraph 关系、一句话创建 Agent、四大核心价值 |
| 1.2 | Install | lang-chain/01-getting-started/install.mdx | 安装方式、可选依赖（如 langchain[anthropic]）、环境要求 |
| 1.3 | Quickstart | lang-chain/01-getting-started/quickstart.mdx | 最小可运行示例、create_agent、invoke 入参格式 |
| 1.4 | Philosophy | lang-chain/01-getting-started/philosophy.mdx | 设计哲学、何时用 LangChain vs LangGraph |
第二阶段：核心组件（Core components）
| 步骤 | 官方章节 | 本地笔记路径 | 核心要点（笔记需覆盖） |
|---|---|---|---|
| 2.1 | Agents | lang-chain/02-core/agents.mdx | Agent 抽象、创建与配置、与 LangGraph 的关系、持久化/流式/人机回环 |
| 2.2 | Models | lang-chain/02-core/models.mdx | 统一模型接口、多厂商切换（OpenAI/Anthropic/Google 等）、避免厂商锁定 |
| 2.3 | Messages | lang-chain/02-core/messages.mdx | 消息类型、角色、结构化消息、与模型输入输出的关系 |
| 2.4 | Tools | lang-chain/02-core/tools.mdx | 工具定义、注册、Agent 如何选择与调用工具、常用工具模式 |
| 2.5 | Short-term memory | lang-chain/02-core/short-term-memory.mdx | 短期记忆（对话窗口、上下文管理） |
| 2.6 | Streaming | lang-chain/02-core/streaming.mdx | 流式输出、事件类型、与 UI 对接 |
| 2.7 | Structured output | lang-chain/02-core/structured-output.mdx | 结构化输出、Schema、解析与校验 |
第三阶段：中间件（Middleware）
| 步骤 | 官方章节 | 本地笔记路径 | 核心要点（笔记需覆盖） |
|---|---|---|---|
| 3.1 | Middleware Overview | lang-chain/03-middleware/overview.mdx | 中间件概念、执行顺序、适用场景 |
| 3.2 | Built-in middleware | lang-chain/03-middleware/built-in.mdx | 内置中间件列表与用法 |
| 3.3 | Custom middleware | lang-chain/03-middleware/custom.mdx | 自定义中间件、接口与示例 |
第四阶段：进阶（Advanced usage）
| 步骤 | 官方章节 | 本地笔记路径 | 核心要点（笔记需覆盖） |
|---|---|---|---|
| 4.1 | Guardrails | lang-chain/04-advanced/guardrails.mdx | 安全护栏、输入输出校验、策略配置 |
| 4.2 | Runtime | lang-chain/04-advanced/runtime.mdx | 运行时配置、超时、重试、并发 |
| 4.3 | Context engineering | lang-chain/04-advanced/context-engineering.mdx | 上下文构建、Prompt 编排、上下文窗口管理 |
| 4.4 | MCP | lang-chain/04-advanced/mcp.mdx | Model Context Protocol、与外部数据源/工具对接 |
| 4.5 | Human-in-the-loop | lang-chain/04-advanced/human-in-the-loop.mdx | 人机回环、审批、干预点 |
| 4.6 | Multi-agent | lang-chain/04-advanced/multi-agent.mdx | 多 Agent 协作、编排模式（若有独立页则按官网） |
| 4.7 | Retrieval | lang-chain/04-advanced/retrieval.mdx | 检索增强、RAG 集成、向量存储与检索器 |
| 4.8 | Long-term memory | lang-chain/04-advanced/long-term-memory.mdx | 长期记忆、持久化存储、与 Agent 状态结合 |
第五阶段：Agent 开发（Agent development）
| 步骤 | 官方章节 | 本地笔记路径 | 核心要点（笔记需覆盖） |
|---|---|---|---|
| 5.1 | LangSmith Studio | lang-chain/05-development/studio.mdx | Studio 功能、可视化调试、轨迹与状态 |
| 5.2 | Test | lang-chain/05-development/test.mdx | 测试方式、断言、回归测试 |
| 5.3 | Agent Chat UI | lang-chain/05-development/ui.mdx | 聊天 UI 组件、与 Agent API 对接 |
第六阶段：部署与可观测（Deploy with LangSmith）
| 步骤 | 官方章节 | 本地笔记路径 | 核心要点（笔记需覆盖） |
|---|---|---|---|
| 6.1 | Deployment | lang-chain/06-deploy/deployment.mdx | 部署方式、环境、生产注意事项 |
| 6.2 | Observability | lang-chain/06-deploy/observability.mdx | 可观测性、指标、日志、追踪 |
入口与链接（link 目录）
| 步骤 | 说明 | 本地路径 |
|---|---|---|
| 0 | 入口页：导航到本仓库 LangChain 笔记 + 官方文档链接表 | link/lang-chain.mdx |
link/lang-chain.mdx内容建议：简介 + 本仓库笔记目录（链接到lang-chain/index.mdx及各阶段）+ 官方文档链接表（Get started / Core / Middleware / Advanced / Development / Deploy），便于「无遗漏」对照。
执行顺序建议
- 先做 link：完善
link/lang-chain.mdx（入口 + 官方链接索引）。 - 再做 lang-chain：按阶段 1 → 2 → 3 → 4 → 5 → 6 依次写笔记；每步：打开对应官方页面 → 提炼要点 → 写入对应
.mdx，保持简明、易记、无遗漏。 - 最后：在侧栏中把
lang-chain/与link/lang-chain.mdx接好，方便从站点内导航。
每完成一个阶段可在本计划中打勾或备注，便于跟踪进度。