by Annyfee
AI Agent 教学仓库 | 系统化 LangChain、RAG、LangGraph、MCP 全栈实战代码 | 万字博客详解 | 开源可运行示例 | 从零构建智能体
# Add to your Claude Code skills
git clone https://github.com/Annyfee/agent-craft✅ 系统性开源教学项目,手把手带你用 Python 构建可运行的 AI Agent,涵盖 Prompt、LLM、LangChain、RAG、LangGraph、MCP 到部署发布全流程。
如果你正在学习 AI 智能体开发,却卡在“知道概念但不会动手”或“会调 API 但不懂原理”的阶段——
Agent Craft 就是为你设计的学习路径。
我们从最基础的 LLM 调用开始,一步步带你构建完整的 Agent 能力栈:
所有内容围绕两个原则展开:
💡 我们不重复造轮子,但也不止于调用框架——
而是在 LangChain、LangGraph 等主流工具中,看清 Agent 是如何思考、决策与行动的。
💡 每个模块对应独立目录(含代码、说明与示例),可独立运行与学习。
🔥 已更新至 13 Streamlit 快速入门,持续更新中!
| 章节 | 模块 | 博客 | 核心关键词 | 难度 | |:-----------:|:---------------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------:|:-------------------------------------------------------------|:-----:| | 🏗️ 基础篇 | 01 Agent 入门 & 环境搭建 | 🏠 | OpenAI API | ⭐ | | | | | LLM API 调用 · prompt · 上下文记忆 | ⭐ | | | | | Function Call · 工具函数封装 | ⭐⭐ | | ⚙️ | | | LLM · Prompt · Chain · Memory | ⭐⭐ | | | | | Agents · 缓存 · 流式输出 | ⭐⭐⭐ | | | | | RAG概念 · Split · Embedding · FAISS · RAG 链 | ⭐⭐ | | | | | Chroma · Reranker · RAG工具化 · 集成 | ⭐⭐⭐ | | | | | Langgraph三要素 · LangSmith · ReAct · 提示词安全注入 | ⭐⭐⭐ | | | | | Human-in-the-Loop · Graph-as-a-Tool · Multi-Agent 多智能体编排 | ⭐⭐⭐⭐ | | 🧠 | | | Stdio · Streamable HTTP · FastMCP框架 · Transport通信 · 构建私有 MCP | ⭐⭐ | | | | | langchain-mcp-adapters框架 · 流式输出 · AsyncExitStack · 连接公共MCP | ⭐⭐⭐ | | | | | Swarm · Handoff · Agents SDK · 去中心化 ·“航空公司客服”项目 | ⭐⭐⭐⭐ | | 🏁 | | | Streamlit · st.chat_message · 异步事件流 · 会话持久化 · “智能客服驾驶舱” | ⭐⭐⭐ | | | 14 综合实战项目 | 🚧撰写中 | LangGraph + RAG + MCP + Streamlit + Vercel | ⭐⭐⭐⭐⭐ | | 🚀 | 15 部署上线与项目总结 | 🚧 | · · | ⭐⭐⭐ |
No comments yet. Be the first to share your thoughts!
OllamaLM StudioLangServe目前已开放模块:01 ~ 13。
建议按顺序学习,每一章都有完整代码示例与注释。
📌 后续模块将陆续开放(综合实战等)
“让每个人都能真正理解 Agent 的底层逻辑,而不仅仅是调用框架。”
我们采用 渐进式构建 的教学理念,从最基础的 Prompt 开始,逐步搭建完整的 AI Agent 能力栈:
flowchart LR
A[Prompt 层] --> B[LLM 核心调用]
B --> C[LangChain 工具链]
C --> D[RAG 检索增强生成]
D --> E[LangGraph 流程控制]
E --> F[MCP 扩展能力]
F --> G[多智能体协作与规划]
G --> H[SDK 封装与部署]
💡 环境要求: Python 3.10–3.12,Node.js v20+
# 1. 克隆项目
git clone https://github.com/Annyfee/agent-craft.git
cd agent-craft
# 2. 安装依赖
pip install -r requirements.txt
# 3. 以开发者模式安装项目(重要!)
pip install -e .
# 复制环境变量模板
cp .env.example .env
在 .env 文件中配置:
OPENAI_API_KEY=your_deepseek_api_key_here
LANGCHAIN_API_KEY=your_langsmith_api_key
AMAP_MAPS_API_KEY=your_gaode_api_key
CHATGPT_API_KEY=your_chatgpt_api_key
💡 获取API Key: 访问 DeepSeek、LangSmith、高德地图、ChatGPT 注册并获取API Key
📌 补充说明: 除了 OPENAI_API_KEY (LLM 的 API Key) 是刚需外,其他 API Key 按需填入,无需一次性全部配置。
一切就绪!运行第一个 Agent 示例:
python "m01_agent_introduction/Agent-demo.py"
🌟 如果这个项目帮到了你,请给我点个 Star ⭐,这将是我持续更新的最大动力!