Bin✳

学习笔记 · Obsidian

LangChain Docs 系统学习

LangChainLangGraphLangSmith
来源更新 2026-08-11下载 Markdown ↓

全站公开文档已完成 以 2026-08-11 的官方索引和页面内链为基线，2,102 / 2,102 个有效可学习路由均已精读、归纳并映射到中文专题笔记。

从这里开始

  • 全站覆盖进度：2,102 条逐页账本；每个页面都能回到对应专题笔记。
  • Build 总览与技术选型：先判断该用 Deep Agents、LangChain 还是 LangGraph。
  • 文档索引与 MCP 接入：理解官方 Markdown、llms.txt、sitemap 与 MCP 的使用边界。

推荐顺序：先读 Build 总览和目标框架，再读 LangSmith Test/Observability，最后按部署方式进入 Platform、Agent Server API 与 Smith API。Integration 页面适合作为选型字典，不必线性通读。

覆盖口径

  • llms.txt：1,018 个入口；sitemap.xml：1,516 个入口；合并后 1,592 个种子。
  • 递归闭合正文内链后得到 2,115 个原始候选；排除非文档协议端点 /mcp 后为 2,114 个文档候选。
  • HTML 与官方 Markdown 双重验证排除 12 个确定 404，最终有效路由为 2,102。
  • 官方 Markdown 响应中 2,017 个直接 200、85 个明确 3xx；重定向目标也已读取。
  • oss/python/integrations/tools/google_imagen 的 HTML 当前为 413，但官方 Markdown 为 200，因此保留并学习正文。
  • 登录后课程内部、第三方产品内部页面和已确认不存在的路由不冒充已读；范围是 docs.langchain.com 当前公开文档及其明确官方跳转目标。

知识地图

领域核心入口解决的问题
Deep AgentsPython · TypeScript · Code长任务 harness、文件、子代理、记忆、权限与沙箱
Managed Deep AgentsPython · TypeScript托管项目、渠道、身份、调度、评估与部署
LangChainPython · TypeScriptAgent 原语、模型、工具、中间件、MCP、检索与 UI
LangGraphPython · TypeScript显式状态图、持久化、恢复、HITL、流式与部署
OpenWiki定位、模式与知识格式面向代码库/知识库的研究型应用
IntegrationsPython · TypeScript模型、向量库、加载器、工具、沙箱与运行时选型
LangSmith Test评估体系与方法选择数据集、实验、evaluator、人工标注与回归
Observability / Prompts / Gateway观测与追踪 · Prompt 治理 · GatewayTrace、成本、告警、Prompt 版本和模型网关
LangSmith Platform平台与部署 · FleetCloud/自托管、RBAC、数据平面、灾备、Engine 与 Fleet
Runtime APIsAgent Server API · Smith API 管理 · Tracing · Datasets · Platform ToolsAssistants、Threads、Runs、Store、治理、反馈、数据集与沙箱
Learn / Reference / ContributeLearn · Reference · Contribute学习路径、API 导航、贡献与集成发布
API Reference / Other OSSControl Plane API · Other OSS控制平面、OAuth、Deployment，以及版本/迁移边界

技术层级

flowchart TD
    A["应用需求"] --> B{"控制粒度"}
    B -->|"长任务与预组装能力"| C["Deep Agents"]
    B -->|"通用 Agent 组合"| D["LangChain"]
    B -->|"显式状态机与恢复"| E["LangGraph"]
    C --> D
    D --> E
    C --> F["LangSmith"]
    D --> F
    E --> F
    F --> G["Test / Deploy / Observe / Govern"]

贯穿全站的生产原则

  • 先验证单 Agent，再引入多 Agent；多代理带来上下文、权限、评估和恢复成本。
  • thread/checkpointer 的短期状态与 store/namespace 的长期记忆必须分开设计。
  • 工具、MCP、Computer Use 与 Sandbox 都是副作用边界；默认最小权限、审批、超时和审计。
  • Dataset、Prompt、Agent 与 Deployment 都要固定版本；生产流量不可依赖可变的 latest。
  • Trace、share token、feedback URL、附件 URL 和公开 Dataset 都可能成为能力型凭据，不能进入普通日志或第三方脚本。
  • 构建成功不等于生产可用；还要验证真实身份、数据存储、网络、恢复、成本、可观测与回滚。

验证状态

  • URL manifest、笔记 frontmatter sources 与 Progress checklist 已做集合级对账。
  • Vault frontmatter、wikilink、敏感值规则、重复文件名与 Inbox 策略均通过只读审计。
  • Git whitespace 检查通过；未复制整页官方正文，笔记以中文主题归纳、差异、决策和风险为主。
  • macOS 当时处于锁屏状态，未完成 Obsidian GUI 目视检查；文件级与 Vault 级验证均已完成。

专题笔记索引

下方索引由目录机械生成；逐官方页面的反向索引请使用 Progress。

<!-- LANGCHAIN_NOTE_INDEX_BEGIN -->

00-Site-Guide

01-Overview

02-Deep-Agents-Code

02-Deep-Agents/Python

02-Deep-Agents/TypeScript

03-Managed-Deep-Agents/Python

03-Managed-Deep-Agents/TypeScript

04-LangChain/Python

04-LangChain/TypeScript

05-LangGraph/Python

05-LangGraph/TypeScript

06-OpenWiki

07-Integrations/Python/Data-Tools-and-Runtime

07-Integrations/Python/Models-and-Providers

07-Integrations/TypeScript/Data-Tools-and-Runtime

07-Integrations/TypeScript/Models-and-Providers

07-LangSmith/Agent-Server-API

07-LangSmith/Fleet

07-LangSmith/Observability-Prompts-and-Gateway

07-LangSmith/Platform-Deployment-and-Admin

07-LangSmith/Smith-API/01-Administration

07-LangSmith/Smith-API/02-Traces-Feedback

07-LangSmith/Smith-API/03-Datasets-Evaluation-Prompts

07-LangSmith/Smith-API/04-Platform-Tools-Sandboxes

07-LangSmith/Test

08-Learn

09-Reference

10-Contribute/Python

10-Contribute/TypeScript

11-Other-OSS

12-API-Reference

<!-- LANGCHAIN_NOTE_INDEX_END -->

← 继续探索AI 与智能体回到顶部 ↑