Hello-Agents 智能体教程
从基础原理、框架实现到多智能体项目，系统学习如何构建 AI 原生智能体。
- Star 数
- ★ 84k
- 最近更新
- 5 天前
- License
- NOASSERTION
- 主语言
- Python
- FA 评分
- 54/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用OpenAI API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 具备 Python 基础的 AI 开发者希望从 ReAct 等经典范式开始，逐步理解并实现智能体内部机制。
- 不适合
- 想要开箱即用的托管智能体服务的团队
- 需要集中式依赖与启动说明的部署者
- 希望直接使用 Anthropic 或 Claude 生态的开发者
这个 Agent 能做什么，适合哪些场景？
Hello-Agents 是 Datawhale 编写的中文智能体学习教程，而不是一个可直接部署的成品智能体。教程由 16 章、配套代码、社区扩展章节和 PDF 版本组成，覆盖 LLM 基础、ReAct、Plan-and-Solve、Reflection、低代码平台、主流框架、自研 HelloAgents 框架、RAG、Memory、上下文工程、通信协议、Agentic RL 和性能评估。核心实践路线包括使用 OpenAI 原生 API 从零构建 HelloAgents 框架，并在此基础上完成单智能体与多智能体应用。综合案例包括智能旅行助手、自动化深度研究智能体和模拟社会动态的赛博小镇，最终以完整多智能体应用作为毕业设计。它适合具备基础 Python 能力并了解如何通过 API 调用 LLM 的开发者、软件工程师、学生和自学者；不适合寻找开箱即用托管 Agent 服务的团队。
该仓库提供可在线或本地阅读的课程内容，以及位于 code 文件夹中的配套代码。学习流程先介绍智能体、Transformer、提示和主流 LLM，再实现 ReAct、Plan-and-Solve 与 Reflection，并演示 Coze、Dify、n8n、AutoGen、AgentScope 和 LangGraph。随后课程使用 OpenAI 原生 API 构建 HelloAgents 框架，并扩展 Memory、RAG、存储、上下文工程、MCP、A2A、ANP、SFT、GRPO 和评估方法。最后，学习者运行、调试和修改示例代码，产出智能旅行助手、DeepResearch Agent、赛博小镇以及自己的多智能体毕业项目。仓库本身主要交付教程、代码和学习项目，不提供统一的托管服务、稳定产品 API 或现成部署边界。
- 具备 Python 基础的 AI 开发者希望从 ReAct 等经典范式开始，逐步理解并实现智能体内部机制。
- 软件工程师已经会调用 LLM API，希望比较 Coze、Dify、n8n 与 AutoGen、AgentScope、LangGraph 等不同构建路径。
- 学生或自学者需要一套从 LLM 基础延伸到 Memory、RAG、上下文工程和智能体评估的结构化课程。
- 开发团队希望通过智能旅行助手、自动化深度研究智能体或赛博小镇案例练习 MCP 与多智能体协作。
- 希望进入智能体岗位的学习者需要结合章节练习、面试题及参考答案准备求职。
- 研究 Agentic RL 的实践者希望学习从 SFT 到 GRPO 的 LLM 训练流程及旅行助手后训练案例。
如何安装或部署这个 Agent？
来源没有给出可验证的依赖安装命令、Python 版本、包管理器、环境变量名称或一键部署方法，因此无法提供准确的复制即用安装命令。本地学习需要取得仓库文件、具备基础 Python 环境，并按具体章节准备相应的 LLM API 访问条件；涉及 OpenAI 原生 API 的 HelloAgents 实践需要相应 API 权限。仓库也提供在线阅读和发布页中的 PDF，无需安装即可阅读。
如何使用这个 Agent？
先在线阅读或在本地按第一至第三章学习智能体与 LLM 基础；随后按第四至第七章依次实现 ReAct、Plan-and-Solve、Reflection，并学习低代码平台、主流框架和 HelloAgents 框架。进入第八至第十二章后，将 Memory、RAG、上下文工程、通信协议、Agentic RL 和评估加入实践。最后运行、调试并修改 code 文件夹中的配套代码，完成智能旅行助手、DeepResearch Agent、赛博小镇和多智能体毕业设计。来源未提供一个适用于整个仓库的统一 CLI、启动命令或首次调用示例，实际命令需要以各章节内容为准。
这个 Agent 有哪些优点和局限？
- 课程结构完整，从智能体与 LLM 基础一直覆盖到多智能体应用、训练和评估，共 16 章。
- 不只介绍现成工具，还安排使用 OpenAI 原生 API 从零构建 HelloAgents 框架，便于理解框架内部结构。
- 同时覆盖 ReAct、Plan-and-Solve、Reflection、Memory、RAG、上下文工程、MCP、A2A、ANP、SFT 和 GRPO 等具体技术。
- 包含智能旅行助手、DeepResearch Agent、赛博小镇和毕业设计等端到端实践，并提供 code 文件夹中的配套代码。
- 提供在线阅读、国内加速入口、免费 PDF 以及面试题和社区扩展内容。
- 它是学习教程而非可直接部署的 Agent 产品，采用者需要自行运行、调试、修改代码并定义生产部署方式。
- 来源没有集中说明 Python 版本、依赖安装命令、环境变量、API 凭证配置或统一启动入口，首次搭建成本无法准确评估。
- 自研 HelloAgents 框架明确基于 OpenAI 原生 API；来源没有证明其可直接兼容 Anthropic API、ChatGPT、Claude Code 或 Claude AI。
- 不同章节涉及 Coze、Dify、n8n、AutoGen、AgentScope、LangGraph 和多种协议，学习与环境配置范围较大。
- 仓库元数据显示 License 为 NOASSERTION，而 README 声明作品采用 CC BY-NC-SA 4.0；用于商业场景前需要核实代码与内容各自的许可范围。
这个 Agent 与同类方案有什么区别？
教程将智能体构建方式区分为两类：Dify、Coze、n8n 代表流程驱动的软件工程路线，LLM 主要作为数据处理后端；Hello-Agents 的重点则是 AI Native Agent，强调理解核心架构、经典范式并亲自构建框架。它还介绍 AutoGen、AgentScope 和 LangGraph，但来源没有提供性能、成本或功能基准，因此不能据此判断哪一种框架更优。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Hello-Agents 智能体教程 当前 | 54 · 缺口较多 | 网页应用免费 + 模型费 | ★ 84k | 5 天前 | Python | OpenAI API |
| AI Agent 工程学习手册 | 55 · 缺口较多 | 开发框架免费 | ★ 601 | 2 天前 | HTML | — |
| PowerContext | 55 · 缺口较多 | 命令行工具免费 | ★ 1.3k | 今天 | Python | Codex · Claude Code |
| 《深入理解 AI Agent：设计原理与工程实践》开源仓库 | 41 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 55k | 19 天前 | Python | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
least_privilege：终端工具测试显示存在安全模式、白名单及危险命令拒绝意图，但未提供实现代码，故仅薄弱支持。user_confirmation：未见执行终端命令、浏览器搜索或其他外部动作前的用户确认机制。data_flow_transparency：README说明会使用API、框架、浏览器及终端等组件，测试也暴露了搜索和命令输入，但没有完整描述数据发送目的地、保留方式或第三方边界。sensitive_data_handling：提到实践需要API密钥，且改进测试刻意避免实际调用LLM，但未见密钥存储、日志脱敏或隐私规范。dependency_security：没有锁定、审计、漏洞处理或依赖更新证据。external_effects：测试明确覆盖终端执行和网络搜索，并尝试拒绝危险命令，但没有系统性的副作用分级或隔离说明。rollback：未提供命令撤销、状态恢复或事务补偿机制。source_attribution：README清楚列出负责人、联合发起者、章节贡献者、社区归属和BibTeX引用，归属证据充分；发布者注册状态未知未被当作负面信号。
self_consistency：README的教程定位、章节导航、代码实践和测试中的智能体工具示例总体一致；但测试来自社区共创子项目，不能充分代表整个仓库或主框架。dependency_availability：在线阅读、发布版、代码目录和若干外部框架被指出，但未给出可核验的依赖清单、版本约束或离线替代方案。failure_messages：测试代码为初始化失败、工具未注册、空输入、异常和部分失败提供了清楚的中文信息；扣分是这些属于打印式测试反馈，未证明产品级结构化错误处理。
audience_and_scenarios：明确面向具备Python和LLM基础的开发者、工程师、学生及自学者，并覆盖低代码、框架开发、旅行助手、深度研究和多智能体等场景，说明充分。capability_boundaries：章节结构区分理论、实践、高级技术和综合案例，也说明无需深厚训练背景；但未清晰界定各示例可用于生产环境的范围和安全边界。trigger_precision：测试列出pwd、ls、中文同义表达等明确触发词，并检查terminal_exec注册；扣分是未提供实际提示词或路由实现，且测试不调用LLM。environment_fit：仅说明基础Python/API前置条件和另有环境配置章节链接，当前材料没有操作系统、Python版本、硬件、环境变量或兼容矩阵。
information_architecture：五部分、十六章、状态表、学习路径、扩展章节和贡献区形成清晰完整的导航。install_notes：提供在线阅读和本地阅读方向，也指向环境配置内容，但当前材料没有具体安装命令或可复现配置。naming_stability：Hello-Agents教程与HelloAgents自研框架的名称大体可区分，章节命名稳定；但仓库大小写、Hello-Agents/HelloAgents以及外部框架仓库之间可能造成混淆。examples_and_faq：README列出大量实战案例、完整代码、社区FAQ及两份工具测试，覆盖充分。known_limitations：提到LLM局限、学习前置知识及尚在完善的规划，但缺少集中、可操作的已知问题和生产限制清单。license：README明确声明CC BY-NC-SA 4.0，LICENSE.txt包含完整条款，满分有直接证据支持。versioning_changelog：只提到相关HelloAgents框架V1.0.0和未来计划，未见本仓库版本策略或变更日志。maintenance_responsibility：列出项目负责人、核心贡献者、Issue、讨论和PR渠道；但发布者身份未经注册验证，且没有明确维护承诺、响应周期或安全联系路径。
output_usability：内容导航、在线阅读、PDF、代码和逐步项目使教程产出较易使用；扣分是当前证据没有展示主框架最终输出格式、质量规范或生产集成接口。marginal_value：从原理、经典范式、自研框架到记忆、协议、强化学习、评估及综合案例的连续课程，相比单点示例具有明确增量价值。cost_benefit：教程免费并提供在线版本和代码，降低学习成本；但API密钥、外部平台、计算资源、网络依赖及训练成本没有量化，因此不能评为全面优化。
claim_traceability：章节、案例、测试文件和贡献者角色让许多主张可回溯到仓库内具体位置；但诸如“全面掌握”“真实结果”和改进效果等表述缺少结果记录。cross_source_corroboration：README的实践定位与终端、浏览器及智能体测试相互支持，许可证声明也由完整LICENSE文本印证；扣分是只有少量实现侧文件，无法交叉验证大多数章节与框架能力。fact_inference_separation：测试通过“预期”“应该”和“不实际执行LLM”等措辞部分区分预期与事实；但test_agent_improvements直接打印带勾的修改总结，测试判断也较启发式，容易把声明或预期误读成已验证结果。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 这是仅基于所给文件的静态低置信度评估；未执行代码、测试、网络请求或LLM调用。
- 社区子项目可执行终端命令并进行浏览器搜索；在验证白名单实现、参数转义、沙箱边界和用户确认流程前，不应在敏感环境运行。
- 不要把测试脚本打印的勾选总结或“应该”结果视为真实测试证据；其中一个脚本明确未调用LLM。
- 未见依赖锁定、安全审计、密钥管理、数据保留说明或回滚机制，部署前需单独审查。
- 许可证为CC BY-NC-SA 4.0，包含非商业和相同方式共享限制；License metadata中的NOASSERTION与仓库文件不一致，复用前应核实适用范围，尤其是代码与第三方材料。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
V1.0.3 Hello-Agents V1.0.3 20260717
发布说明摘录
基于 2026 年 7 月 17 日最新内容制作的 Hello-Agents V1.0.3 中英文 PDF 正式发布！ > 本次更新以修正文档问题、优化内容细节和提升阅读体验为主。同步收录自 V1.0.2 发布以来的文档修订，修复了页面显示、内容表述、代码示例及链接导航等问题。整体章节结构与内容体量变化不大。 本次更新 - 同步 Hello-Agents 项目截至 2026 年 7 月 17 日的最新正文 - 修复 V1.0.2 发布以来发现的文档 Bug 与内容错误 - 优化部分代码、公式、图片和页面显示效果 - PDF 内容导航改为 GitHub 绝对地址，可直接点击访问对应章节 - 同步更新中文与英文版本 - PDF 仅保留教程正文，不包含 Extra Chapter 本 Hello-Agents PDF 教程完全开源免费。为防止各类营销号添加水印后向智能体系统初学者倒卖，我们在正式发布的 PDF 文件中预先添加了不影响阅读的 Datawhale 开源标志水印，敬请谅解～ …在 GitHub 查看 ↗ -
V1.0.2 Hello-agents V1.0.2 20260210
发布说明摘录
基于2026年2月10日为止的 Hello-Agents 全新PDF发布！ > 修复了在项目发布后的三个月内所有的页面显示问题、事实错误问题、代码报错问题等等... 本 Hello-Agents PDF 教程完全开源免费。为防止各类营销号加水印后贩卖给多智能体系统初学者，我们特地在 PDF 文件中预先添加了不影响阅读的 Datawhale 开源标志水印，敬请谅解～ This Hello-Agents PDF tutorial is completely open source and free. To prevent various marketing accounts from adding watermarks and reselling it to beginners of multi-agent systems, we have specially added a Datawhale open-source watermark to the PDF file without affecting readability. Thank you for your understanding. 在线阅读地址：https://datawhalechina.github.io/hello-agents …在 GitHub 查看 ↗ -
V1.0.0 Hello-agents V1.0.0 20251103
发布说明摘录
_本 Hello-Agents PDF 教程完全开源免费。为防止各类营销号加水印后贩卖给多智能体系统初学者，我们特地在 PDF 文件中预先添加了不影响阅读的 Datawhale 开源标志水印，敬请谅解～_ _This Hello-Agents PDF tutorial is completely open source and free. To prevent various marketing accounts from adding watermarks and reselling it to beginners of multi-agent systems, we have specially added a Datawhale open-source watermark to the PDF file without affecting readability. Thank you for your understanding._ > 在线阅读地址：https://datawhalechina.github.io/hello-agents Hello-agents：https://github.com/datawhalechina/hello-agents Datawhale ：https://www.datawhale.cn/home …在 GitHub 查看 ↗
常见问题
这是可以直接上线的智能体服务吗？
学习前需要什么基础？
是否必须使用 OpenAI API？
是否包含多智能体与 MCP 实践？
能否用于商业项目？
Hello-Agents 和 HelloAgents、pip 包 hello-agents 是一回事吗？
hello-agents 发布在 PyPI，其 learn_version 分支与教程正文对应。本站另有它的单独资料页。