python-agent/code/003_phase3_frameworks/01_langchain_basics

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开发框架/（按目录名里的 第 X 篇 对应）
• 在 docs 目录里找到对应的小点 markdown 文件阅读详细理论。

🛠️ 建议练习

• 用 LCEL 拼一条 prompt | llm | parser 管道
• 写一个 @tool 函数并解释 docstring 对模型调用决策的影响
• 实现 RunnableParallel：检索 + 问题改写两路并发

🏁 完成后达成标准

• 能用 ChatPromptTemplate + LCEL 组装管道
• 能用 @tool 定义工具并解释 bind_tools 的作用
• 能说清为什么 Chain 做不了 Agent、必须上 LangGraph

---

🚀 运行提示

# 激活根目录的虚拟环境
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