为什么需要它
你不是不会，只是缺一条能落地的路
市面上的资料要么只讲概念，要么只甩 API。Agent Craft 专治两种「学不会」。
!知道概念，但不会动手
听懂了 Prompt、RAG、Agent，真要自己写却卡在第一步：环境怎么配？第一个能跑的 Agent 长什么样？工具调用到底怎么接？
- 每个模块都是独立、可运行的最小工程
- 注释清晰，本地一键复现
- 从「Hello Agent」平滑过渡到完整系统
?会调 API，但不懂原理
用框架能跑通 demo，却说不清 ReAct 为什么这么编排、RAG 召回为什么时好时坏、LangGraph 的状态是怎么流转的。
- 配套 CSDN 博客拆解设计思路
- 关键机制白盒化，可调试、可观测
- 知其然，更知其所以然
核心理念
两大原则，贯穿全程
💻
代码可运行
每个模块独立成章、注释清晰、依赖齐全，git clone 后本地一键复现，不靠截图和伪代码凑数。
📖
原理可理解
配套 CSDN 博客逐篇拆解设计思路与关键机制，把「黑盒」变成「白盒」，让你真正理解 Agent 的底层逻辑。
内容总览
五大篇章，循序渐进
基础 → 框架 → 智能 → 实战 → 工程，每个篇章都是能跑通的能力积木。
🏗️
基础篇
Agent 入门与环境搭建 · LLM 基础调用 · Function Calling 与工具调用。先把地基打牢。
⚙️
框架篇
LangChain 基础与进阶 · RAG 基础与进阶。用成熟框架把能力组装成流水线。
🧠
智能篇
MCP 基础（Server）与进阶（Client）· Agents SDK & Swarm 多智能体协作。
🏁
实战篇
Streamlit 快速入门，把 Agents SDK 对接成真正可用的产品驾驶舱。
🚀
工程篇
综合实战项目 + 部署上线（Ollama · LM Studio · LangServe · Vercel）。
🤝
社区
欢迎 Issue / PR 共建，配套 CSDN 博客与微信交流群，一起把教程补全。
技术栈
用主流工具，学底层逻辑
Python 3.10–3.12
Node.js v20+
OpenAI API
DeepSeek
LangChain
LangGraph
MCP / FastMCP
FAISS · Chroma
Reranker
LangSmith
Streamlit
Agents SDK
Ollama · LM Studio
LangServe · Vercel
三步跑通
五分钟，看到你的第一个 Agent
bash
# 1. 克隆并安装依赖
git clone https://github.com/Annyfee/agent-craft.git
cd agent-craft
pip install -r requirements.txt
pip install -e . # 开发者模式
# 2. 配置 API Key
cp .env.example .env # 填入 OPENAI_API_KEY 等
# 3. 运行第一个示例
python "m01_agent_introduction/Agent-demo.py"15
规划模块
13
已开放模块
100%
代码可运行
∞
配套博客拆解