学习笔记 · Obsidian

官方学习路径与使用顺序

LangChainLangGraphPythonTypeScriptJavaScript

这两个页面的作用

Python 与 JavaScript/TypeScript 的 Learn 页面不是新的 API 章节,而是把分散在 Deep Agents、LangChain、LangGraph 和多代理文档中的教程重新编排成一条学习路径。它们适合确定学习顺序,页面是否真的学完仍以各教程来源和 全站覆盖账本 为准。

推荐顺序

flowchart LR
    A["基础 Agent"] --> B["检索 / SQL / Voice"]
    B --> C["状态、记忆与 Context Engineering"]
    C --> D["LangGraph Graph / Functional API"]
    D --> E["Deep Agents 长任务"]
    E --> F["多代理模式"]
    F --> G["生产案例与评估"]
  1. 用 LangChain agent 学会 model、message、tool、middleware 和 structured output。
  2. 用 semantic search、RAG、SQL、voice 等教程练习真实 I/O 与安全审批。
  3. 区分线程内短期状态、跨线程长期记忆,以及“给模型什么上下文”的 context engineering。
  4. 需要确定性控制、持久恢复或复杂分支时,再学习 LangGraph Graph API 与 Functional API。
  5. 任务变长、需要文件系统、规划、上下文压缩或子代理时,使用 Deep Agents。
  6. 只有上下文隔离、并行性或组织职责确有收益时再用 subagents、handoffs、router 或 skills,不把多代理当默认架构。

Python 教程地图

方向官方入口学习重点
Deep AgentsData analysis、Deep research文件产物、子代理、研究反思、外部渠道
LangChainSemantic search、RAG、SQL、Voice检索、数据库安全、HITL、多模态实时交互
LangGraphCustom RAG、Custom SQL显式状态、条件边、恢复与细粒度控制
Multi-agentPersonal assistant、Customer support、Knowledge-base router、SQL skillssubagent、handoff、router、渐进式上下文加载
ConceptsMemory、Context engineering状态生命周期、信息与工具选择
ResourcesAcademy、Case studies课程练习与生产案例

TypeScript 的当前差异

TypeScript Learn 页面保留相同的总体结构,但当前公开卡片更少:LangGraph 只列 Custom RAG,多代理标题下没有具体教程卡片。它仍链接 Memory、Context engineering、Graph API、Functional API 和 Case studies。

这只说明 Learn 聚合页的当前展示范围,不等价于 TypeScript 不支持 SQL 或多代理。能力判断必须回到对应框架文档、集成文档和 API Reference;不能从导航缺卡片推断功能缺失。

学习完成标准

  • 能解释何时选 Deep Agents、LangChain 或 LangGraph,而不是只会复制 quickstart。
  • 能指出线程、checkpoint、store、sandbox、HITL 和 tracing 的边界。
  • 能为外部 I/O 说明权限、幂等、重试、超时、成本与数据保留策略。
  • 能用测试和 trace 复现问题,而不是只观察最终文本。
  • 能识别 Python 与 TypeScript 文档不对称、过期链接或复制错误,并回到源码/版本化 Reference 验证。