学习笔记 · Obsidian
官方学习路径与使用顺序
这两个页面的作用
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["生产案例与评估"]
- 用 LangChain agent 学会 model、message、tool、middleware 和 structured output。
- 用 semantic search、RAG、SQL、voice 等教程练习真实 I/O 与安全审批。
- 区分线程内短期状态、跨线程长期记忆,以及“给模型什么上下文”的 context engineering。
- 需要确定性控制、持久恢复或复杂分支时,再学习 LangGraph Graph API 与 Functional API。
- 任务变长、需要文件系统、规划、上下文压缩或子代理时,使用 Deep Agents。
- 只有上下文隔离、并行性或组织职责确有收益时再用 subagents、handoffs、router 或 skills,不把多代理当默认架构。
Python 教程地图
| 方向 | 官方入口 | 学习重点 |
|---|---|---|
| Deep Agents | Data analysis、Deep research | 文件产物、子代理、研究反思、外部渠道 |
| LangChain | Semantic search、RAG、SQL、Voice | 检索、数据库安全、HITL、多模态实时交互 |
| LangGraph | Custom RAG、Custom SQL | 显式状态、条件边、恢复与细粒度控制 |
| Multi-agent | Personal assistant、Customer support、Knowledge-base router、SQL skills | subagent、handoff、router、渐进式上下文加载 |
| Concepts | Memory、Context engineering | 状态生命周期、信息与工具选择 |
| Resources | Academy、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 验证。