增加每章节 README 文件

2026-09-22 15:57:59 +08:00
parent 8e86665096
commit 9445061c76
49 changed files with 3815 additions and 6 deletions
@@ -0,0 +1,54 @@
+# LangChain 基础
+
+> 所属：阶段三 · 主流 Agent 开发框架
+> 目标：掌握 LangChain 的 ChatModel / PromptTemplate / LCEL / @tool 四件套。
+
+---
+
+## 📌 学习目的
+
+掌握 LangChain 的 ChatModel / PromptTemplate / LCEL / @tool 四件套。
+
+## ✅ 学习要求（前置条件）
+
+已完成阶段一「06_llm_api_in_practice」。
+
+## 📚 主要学习内容
+
+- ChatModel：ChatOpenAI / ChatDeepSeek / ChatOllama 切换仅改 import
+- PromptTemplate / ChatPromptTemplate + Few-shot
+- LCEL：`prompt | llm | parser` 表达式语言
+- @tool 装饰器：自动生成 JSON Schema / `bind_tools` / `AIMessage.tool_calls`
+
+## 📖 对应 docs
+
+- 目录：[`docs/03-阶段三-主流Agent开发框架/`](../../docs/03-阶段三-主流Agent开发框架/)（按目录名里的 `第 X 篇` 对应）
+- 在 docs 目录里找到对应的小点 markdown 文件阅读详细理论。
+
+## 🛠️ 建议练习
+
+- [ ] 用 LCEL 拼一条 `prompt | llm | parser` 管道
+- [ ] 写一个 @tool 函数并解释 docstring 对模型调用决策的影响
+- [ ] 实现 RunnableParallel：检索 + 问题改写两路并发
+
+## 🏁 完成后达成标准
+
+- [ ] 能用 ChatPromptTemplate + LCEL 组装管道
+- [ ] 能用 @tool 定义工具并解释 bind_tools 的作用
+- [ ] 能说清为什么 Chain 做不了 Agent、必须上 LangGraph
+
+---
+
+## 🚀 运行提示
+
+```bash
+# 激活根目录的虚拟环境
+cd /Users/jack/source/Demo/py/demo_python_agent
+source .venv/bin/activate   # 或直接用 uv run ...
+
+# 进入本章目录
+cd code/003_phase3_frameworks/01_langchain_basics
+
+# 跑你的练习文件
+uv run python your_exercise.py
+```