Hello-Agents:从零开始构建智能体的系统教程
📅 主题:DataWhale 开源智能体学习教程深度解析 — 33K+ Stars,从原理到实战的完整指南
一、项目概述
如果说 2024 年是"百模大战"的元年,那么 2025 年无疑开启了"Agent 元年"。技术的焦点正从训练更大的基础模型,转向构建更聪明的智能体应用。
Hello-Agents 是 Datawhale 社区推出的系统性智能体学习教程《从零开始构建智能体》。这个项目旨在为社区提供一本从零开始、理论与实战并重的智能体系统构建指南。
| 属性 | 信息 |
|---|---|
| GitHub | datawhalechina/hello-agents |
| Stars | 33,914+ ⭐ |
| Forks | 3,906 |
| 在线阅读 | hello-agents.datawhale.cc |
| 许可证 | CC BY-NC-SA 4.0 |
核心理念:教程聚焦于 AI Native Agent ——真正以 AI 驱动的智能体,而非 Dify、Coze 这类流程驱动的软件开发。教程将带领你穿透框架表象,从智能体的核心原理出发,深入其核心架构,理解其经典范式,并最终亲手构建属于自己的多智能体应用。
二、内容架构(五部分16章)
教程分为五大部分,每一部分都是通往下一阶段的坚实阶梯:
第一部分:智能体与语言模型基础(第1-3章)
| 章节 | 关键内容 |
|---|---|
| 第一章 初识智能体 | 智能体定义、类型、范式与应用 |
| 第二章 智能体发展史 | 从符号主义到 LLM 驱动的智能体演进 |
| 第三章 大语言模型基础 | Transformer、提示、主流 LLM 及其局限 |
这部分从智能体的定义、类型与发展历史讲起,梳理"智能体"概念的来龙去脉,并快速巩固大语言模型的核心知识,为实践之旅打下坚实的理论地基。
第二部分:构建你的大语言模型智能体(第4-7章)
| 章节 | 关键内容 |
|---|---|
| 第四章 智能体经典范式构建 | 手把手实现 ReAct、Plan-and-Solve、Reflection |
| 第五章 基于低代码平台的智能体搭建 | Coze、Dify、n8n 等低代码智能体平台使用 |
| 第六章 框架开发实践 | AutoGen、AgentScope、LangGraph 等主流框架应用 |
| 第七章 构建你的 Agent 框架 | 从 0 开始构建智能体框架 |
这是动手实践的起点。你将:
- 亲手实现 ReAct 等经典范式
- 体验低代码平台的便捷
- 掌握主流框架的应用
- 从零开始构建一个属于自己的智能体框架,兼具"用轮子"与"造轮子"的能力
第三部分:高级知识扩展(第8-12章)
| 章节 | 关键内容 |
|---|---|
| 第八章 记忆与检索 | 记忆系统,RAG,存储 |
| 第九章 上下文工程 | 持续交互的"情境理解" |
| 第十章 智能体通信协议 | MCP、A2A、ANP 等协议解析 |
| 第十一章 Agentic-RL | 从 SFT 到 GRPO 的 LLM 训练实战 |
| 第十二章 智能体性能评估 | 核心指标、基准测试与评估框架 |
在这一部分,你的智能体将"学会"思考与协作:
- 使用自研框架深入探索记忆与检索、上下文工程
- 学习 Agent 训练(从 SFT 到 GRPO)
- 掌握多智能体间的通信协议(MCP、A2A、ANP)
- 掌握评估智能体系统性能的专业方法
第四部分:综合案例进阶(第13-15章)
| 章节 | 关键内容 |
|---|---|
| 第十三章 智能旅行助手 | MCP 与多智能体协作的真实世界应用 |
| 第十四章 自动化深度研究智能体 | DeepResearch Agent 复现与解析 |
| 第十五章 构建赛博小镇 | Agent 与游戏的结合,模拟社会动态 |
理论与实践的交汇点。你将把所学融会贯通,亲手打造:
- 智能旅行助手:MCP 与多智能体协作的真实应用
- 自动化深度研究智能体:DeepResearch Agent 复现
- 赛博小镇:Agent 与游戏结合,模拟社会动态
第五部分:毕业设计及未来展望(第16章)
| 章节 | 关键内容 |
|---|---|
| 第十六章 毕业设计 | 构建属于你的完整多智能体应用 |
在旅程的终点,你将迎来毕业设计——构建一个完整的、属于你自己的多智能体应用,全面检验学习成果。
三、核心亮点
3.1 完全免费开源
Datawhale 开源免费,完全免费学习本项目所有内容,与社区共同成长。
3.2 理论与实战并重
- 📖 深入理解智能体的概念、历史与经典范式
- 🏗️ 亲手实现 ReAct、Plan-and-Solve、Reflection 等经典范式
- 🛠️ 从零构建自己的智能体框架
3.3 自研框架 HelloAgents
基于 OpenAI 原生 API 从零构建一个自己的智能体框架,已更新 V1.0.0 版本,持续完善。
3.4 高级技能全覆盖
- ⚙️ 上下文工程、Memory、协议、评估等系统性技术
- 🤝 Agentic RL:从 SFT 到 GRPO 的全流程实战训练 LLM
3.5 真实案例驱动
实战开发智能旅行助手、赛博小镇等综合项目。
3.6 求职面试准备
包含智能体求职相关面试问题总结与答案。
四、自研框架 HelloAgents
教程配套自研框架 HelloAgents(GitHub),基于 OpenAI 原生 API 从零构建:
特点:
- 轻量化、易上手
- 完整复现教程中的核心概念
- 兼容学习版本,持续增加新特性
- 适合理解智能体底层原理
架构示意:
┌─────────────────────────────────────────────────────┐
│ HelloAgents │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ Agent │ │ Memory │ │ Tools │ │ Planner │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
│ ↓ │
│ ┌─────────────────┐ │
│ │ LLM Backend │ │
│ │ (OpenAI API) │ │
│ └─────────────────┘ │
└─────────────────────────────────────────────────────┘五、社区贡献精选
教程包含丰富的社区贡献内容:
| 精选内容 | 说明 |
|---|---|
| Agent 面试题总结 | Agent 岗位相关面试问题 |
| Agent 面试题答案 | 相关面试问题参考答案 |
| 上下文工程内容补充 | 上下文工程内容扩展 |
| Dify 智能体创建保姆级教程 | Dify 智能体创建完整操作流程 |
| Hello-agents 课程常见问题 | Datawhale 课程 FAQ |
| Agent Skills 与 MCP 对比解读 | Agent Skills 与 MCP 技术对比 |
| GUI Agent 科普与实战 | GUI Agent 科普与多场景实战 |
| 环境配置 | 开发环境配置指南 |
| 如何写出好的 Skill | Skill 写作最佳实践 |
| Agent 应用开发实践踩坑与经验分享 | Code Agent 应用开发踩坑与经验 |
六、学习路径建议
适合人群
- 有一定编程基础的 AI 开发者
- 软件工程师
- 在校学生
- 对前沿 AI 技术抱有浓厚兴趣的 自学者
前置要求
- 基础 Python 编程能力
- 对大语言模型有基本概念性了解(知道如何通过 API 调用 LLM)
- 无需深厚的算法或模型训练背景
学习建议
智能体是一个飞速发展且极度依赖实践的领域。为了获得最佳学习效果:
- 理论与实践相结合:项目的
code文件夹提供配套全部代码 - 亲手运行、调试、修改:务必亲手运行项目里提供的每一份代码
- 关注社区动态:关注 Datawhale 及其他 Agent 相关社区
- 遇到问题及时提问:可在项目 Issue 区提问
七、快速开始
在线阅读
- 国内加速:hello-agents.datawhale.cc
- 国外访问:GitHub Pages
PDF 版本下载
- GitHub Release:V1.0.0
- 国内下载:Datawhale 平台
本地阅读
# 克隆仓库
git clone https://github.com/datawhalechina/hello-agents.git
# 进入目录
cd hello-agents
# 查看 docs 文件夹八、下一步规划
项目团队正在推进:
- 📹 视频课程陆续放出(更加细致,从设计思路到实施)
- 🔧 HelloAgents 框架继续完善(增加更多工具和特性)
- 📊 调查问卷收集学习需求
- 📚 后续作品《从零开始训练智能体》(掌握从零到一训练自定义场景智能体模型的能力)
参考资料
💡 如果这个项目对你有帮助,请给 datawhalechina/hello-agents 一个 Star!这是对开源社区最好的支持方式。