Dive into Agents 🤖

从零到一学习 AI Agent，对比 LangChain vs Google ADK，12 周成为 Agent 开发者

---

🎯 项目特点

✨ 比其他仓库更好的地方

特点	dive-into-langgraph	dive-into-agents
框架覆盖	✅ LangGraph	✅ LangChain + ADK 对比
学习路径	✅ 14 章	✅ 12 周实战路线
代码注释	✅ 基础	✅ 详细注释 + 可视化
问答卡片	❌ 无	✅ 间隔重复学习
实战项目	✅ 1 个	✅ 3 个（基础/进阶/企业）
双语支持	❌ 无	✅ 中文 + 英文摘要
学习社群	❌ 无	✅ Discord/微信群
博客输出	❌ 无	✅ 每周博客模板

---

📅 12 周学习路线

Phase 1: Agent 基础（第 1-4 周）

目标： 理解 Agent 核心概念，掌握基础开发

周	主题	LangChain	ADK	产出
第1周	ReAct Agent	✅	✅	《我的第一个 Agent》
第2周	状态管理	StateGraph	Workflow	《Agent 状态管理详解》
第3周	中间件	Middleware	Interceptors	《Agent 中间件实战》
第4周	人机交互	HITL	Human Approval	《让人类介入 Agent》

Phase 2: Agent 进阶（第 5-8 周）

目标： 掌握记忆、上下文、MCP、监督者

周	主题	LangChain	ADK	产出
第5周	记忆系统	LangMem	Memory Store	《Agent 记忆设计》
第6周	上下文工程	State/Store	Context	《Agent 上下文管理》
第7周	MCP 协议	MCP Adapters	MCP Tools	《MCP 集成实战》
第8周	监督者模式	LangGraph Supervisor	ADK Supervisor	《Multi-Agent 架构》

Phase 3: 高级技能（第 9-11 周）

目标： 掌握并行、RAG、搜索

周	主题	LangChain	ADK	产出
第9周	并行执行	Map-reduce	Parallel Agent	《Agent 并行处理》
第10周	RAG	LangChain RAG	Vertex AI Search	《三种 RAG 方式》
第11周	网络搜索	Tavily/DDGS	Grounding	《Agent 联网搜索》

Phase 4: 实战项目（第 12 周）

目标： 构建完整应用

周	主题	项目	产出
第12周	实战项目	3 个可选项目	《我的 Agent 应用》

---

📂 项目结构

dive-into-agents/
├── README.md               # 项目说明
├── roadmap/                # 学习路线图
│   ├── 12-week-plan.md     # 12 周详细计划
│   └── comparison.md       # LangChain vs ADK 对比
├── week01-react-agent/     # 第 1 周学习内容
│   ├── README.md           # 本周概览
│   ├── tutorial/           # 教程（LangChain + ADK）
│   ├── notes.md            # 学习笔记
│   ├── code/               # 代码示例
│   ├── quiz.md             # 问答卡片（间隔重复）
│   └── blog-template.md    # 博客模板
├── week02-stategraph/      # 第 2 周学习内容
├── ... (week03-11)
├── week12-project/         # 第 12 周实战项目
│   ├── project1-basic/     # 项目 1：基础（智能客服）
│   ├── project2-advanced/  # 项目 2：进阶（代码助手）
│   └── project3-enterprise/# 项目 3：企业（数据分析 Agent）
├── resources/              # 学习资源
│   ├── langchain/          # LangChain 相关
│   ├── adk/                # ADK 相关
│   └── papers/             # 论文资源
├── community/              # 学习社群
│   ├── discord.md          # Discord 邀请
│   └── wechat.md           # 微信群二维码
├── templates/              # 模板文件
│   ├── weekly-note.md      # 每周笔记模板
│   ├── blog-template.md    # 博客模板
│   └── quiz-card.md        # 问答卡片模板
└── assets/                 # 图片、图表等
    ├── diagrams/           # 架构图
    └── screenshots/        # 截图

---

🚀 快速开始

前置要求

• Python 3.10+
• pip
• Git
• 一个 LLM API（推荐 GLM-5 或 Gemini）

安装

# 克隆仓库
git clone https://github.com/yourusername/dive-into-agents.git
cd dive-into-agents

# 安装依赖
pip install -r requirements.txt

# 开始第 1 周学习
cd week01-react-agent
# 阅读 README.md

---

📚 学习资源

官方文档

• LangChain
• LangGraph
• Google ADK

推荐教程

• dive-into-langgraph - LangGraph 中文教程
• NirDiamant/GenAI_Agents - 系统全面
• LangChain-OpenTutorial - 官方教程

---

🤝 贡献指南

我们欢迎任何形式的贡献！

• 🐛 报告 Bug
• 💡 提建议
• 📝 完善内容
• 🔧 提交 PR

详见 CONTRIBUTING.md

---

📄 License

MIT License - 详见 LICENSE

---

🙏 致谢

感谢以下项目的启发：

• dive-into-langgraph
• NirDiamant/GenAI_Agents
• LangChain
• Google ADK

---

📮 联系方式

• GitHub Issues: 提交问题
• Discord: 加入社群
• 微信群: 见 community/wechat.md

---

⭐ 如果这个项目对你有帮助，请给一个 Star！⭐

---

创建时间：2026-03-22