BrandPeng/Langchain1.0-Langgraph1.0-Learning

项目概述

这是一个实践型学习仓库，目标是系统掌握 LangChain 1.0 和 LangGraph 1.0 的核心概念与实战技能。仓库基于 LangChain 1.0（2025年10月正式发布）构建，强调使用新的 create_agent API 和中间件架构，并涉及多模态、结构化输出、持久化等特性。

学习路径（四阶段 22+3 模块）

• 第一阶段：基础知识（第1-2周）——覆盖 LLM 调用、提示词模板、消息类型、自定义工具、创建 Agent 和 Agent 循环。
• 第二阶段：实战技能（第3-4周）——内存、上下文管理、检查点、中间件、结构化输出、验证重试、RAG 基础与进阶、工具与智能体进阶。
• 第三阶段：高级主题（第5-6周）——LangGraph 状态图、多智能体、条件路由、图像输入、文件处理、混合模态、LangSmith 集成、错误处理。
• 第四阶段：综合项目（第7-8周）——RAG 系统、多智能体客服系统、研究助手。

项目结构

仓库按 phase1_fundamentals、phase2_practical、phase3_advanced、phase4_projects 四个目录组织，每个目录下包含对应模块的独立文件夹（例如 01_hello_langchain），另有 docs、.env.example、requirements.txt 和 README.md。

核心技术点（摘自 README）

• 模型调用：使用 init_chat_model，支持文本、字典、消息对象多种输入。
• 自定义工具：通过 @tool 装饰器创建，强调 docstring 的重要性。
• 创建 Agent：推荐使用 langchain.agents.create_agent（langgraph.prebuilt.create_react_agent 已弃用）。
• LangGraph 状态图：当 create_agent 不够用时，可手动定义 StateGraph。

环境要求与安装

• Python ≥3.10（不支持 3.9）
• 克隆仓库 → 创建虚拟环境 → 安装依赖 → 配置 .env（填入 API keys）
• 验证安装：运行 python phase1_fundamentals/01_hello_langchain/main.py

所需的 API Keys

Key	用途
GROQ_API_KEY	Groq（免费）
OPENAI_API_KEY	OpenAI（可选）
PINECONE_API_KEY	Pinecone 向量库（免费）
LANGSMITH_API_KEY	LangSmith 监控（可选）

常见问题与资源

README 提供了常见错误排查（如导入路径、API 密钥、上下文记忆等）以及官方文档链接（LangChain、LangGraph、迁移指南、LangSmith）和许可证（MIT）。

注：README 中还列出了“后续计划”——构建基于 LangChain 1.0 的完整 RAG 前后端项目（技术栈：Agentic RAG、LangChain、ChromaDB、SQLite、FastAPI、Vue）以及基于 LangGraph 1.0 的多智能体前后端项目（Python、LangGraph、LangChain、FastAPI、MCP、Vue、SQLite），但这些尚未在仓库中实现（仅作为未来规划）。