{"id":186,"date":"2026-08-04T16:21:39","date_gmt":"2026-08-04T08:21:39","guid":{"rendered":"https:\/\/haveyouself.fun\/hello-agents-learning-roadmap\/"},"modified":"2026-08-04T16:24:53","modified_gmt":"2026-08-04T08:24:53","slug":"hello-agents-learning-roadmap","status":"publish","type":"post","link":"https:\/\/haveyouself.fun\/en\/hello-agents-learning-roadmap\/","title":{"rendered":"Learning Hello-Agents: A Systematic Roadmap to Building AI Agents from Scratch"},"content":{"rendered":"<p>Calling a large language model API once doesn't mean you've built an agent. The real challenge is organizing planning, tools, memory, context, collaboration, and evaluation into a system that can complete tasks. Recently, I added the open-source tutorial from Datawhale <strong>Hello-Agents: Building Agents from Scratch<\/strong>to my learning list, planning to complete it with a \"read a chapter, run it once, modify one thing, and leave a record\" approach.<\/p>\n<blockquote>\n<p><strong>Project Source and Copyright Notice<\/strong><\/p>\n<p>Original project:<a href=\"https:\/\/github.com\/datawhalechina\/hello-agents\" target=\"_blank\" rel=\"noopener noreferrer external\">Hello-Agents: Building Agents from Scratch<\/a><br \/>\nInitiated and maintained by the Datawhale community and all contributors to Hello-Agents<br \/>\nOnline documentation:<a href=\"https:\/\/hello-agents.datawhale.cc\/\" target=\"_blank\" rel=\"noopener noreferrer external\">Domestic access<\/a> \/ <a href=\"https:\/\/datawhalechina.github.io\/hello-agents\/\" target=\"_blank\" rel=\"noopener noreferrer external\">GitHub Pages<\/a><br \/>\nOpen-source license:<a href=\"https:\/\/creativecommons.org\/licenses\/by-nc-sa\/4.0\/deed.zh-hans\" target=\"_blank\" rel=\"noopener noreferrer external\">CC BY-NC-SA 4.0 (Attribution-NonCommercial-ShareAlike)<\/a><\/p>\n<p>This article is a personal study guide compiled from the project's official README and chapter outline. It is not the full official tutorial, nor does it represent the official stance of Datawhale. The rights to the project name, course structure, and related materials belong to the original authors and contributors; the review date is August 4, 2026.<\/p>\n<\/blockquote>\n<h2>Why choose it as a learning path<\/h2>\n<p>The value of Hello-Agents goes beyond introducing a few popular frameworks. It first explains the fundamentals of agents and large language models, then moves into classic paradigms such as ReAct, Plan-and-Solve, and Reflection, followed by low-code platforms, code frameworks, custom frameworks, memory and retrieval, context engineering, communication protocols, Agentic RL, and performance evaluation, and finally wraps up with complete case studies.<\/p>\n<p>This path connects \"using models\" with \"designing systems.\" Along the way, you'll encounter tools like Dify, Coze, n8n, AutoGen, AgentScope, and LangGraph, but you'll also be encouraged to look beyond the tools and understand more stable capabilities such as planning, acting, feedback, and iteration.<\/p>\n<h2>What you need before starting<\/h2>\n<p>The official prerequisites are clear: basic Python programming skills, a basic understanding of large language models, and ideally knowing how to call an LLM via API. It does not require deep algorithm or model training backgrounds; the focus is on application and building.<\/p>\n<ul>\n<li>Ability to read and modify Python code, and familiarity with functions, classes, virtual environments, and package management.<\/li>\n<li>Understand the basic uses of prompts, context windows, model inputs\/outputs, and API keys.<\/li>\n<li>Be willing to run, debug, and modify examples hands-on, not just read conclusions.<\/li>\n<\/ul>\n<p>Store API keys in local environment variables or config files excluded from version control\u2014never in code, screenshots, or commit history.<\/p>\n<h2>Five-Stage Learning Roadmap<\/h2>\n<ol>\n<li><strong>Build a shared vocabulary (Chapters 1\u20133):<\/strong>Learn agent definitions, history, and LLM fundamentals. Produce a concept table that explains the relationships among agents, LLMs, tool calling, and multi-agent systems.<\/li>\n<li><strong>From usage to building (Chapters 4\u20137):<\/strong>Learn classic paradigms, low-code platforms, mainstream frameworks, and custom frameworks. Produce a runnable single agent and be able to explain its decision loop.<\/li>\n<li><strong>Round out system capabilities (Chapters 8\u201312):<\/strong>Learn memory, RAG, context engineering, MCP\/A2A\/ANP, Agentic RL, and evaluation. Add a memory or evaluation module to your agent and leave reproducible comparison results.<\/li>\n<li><strong>Complete integrated case studies (Chapters 13\u201315):<\/strong>Learn the travel assistant, automated deep research, and CyberTown. Fully reproduce one case, then modify it by swapping data, tools, or tasks.<\/li>\n<li><strong>Complete the capstone project (Chapter 16):<\/strong>Build your own multi-agent application, delivering goals, architecture, run instructions, evaluation results, and limitations.<\/li>\n<\/ol>\n<h2>My six-week execution plan<\/h2>\n<p><strong>Week 1: Foundations.<\/strong>Finish Chapters 1\u20133, and organize concepts like agents, environments, perception, action, planning, and feedback in your own words. The goal is not to memorize terms but to be able to draw a complete flow from input to outcome for a task.<\/p>\n<p><strong>Week 2: Paradigms.<\/strong>Focus on Chapters 4\u20135. First implement a minimal ReAct loop, then redo the same task with a low-code platform, comparing where each implementation is more transparent and flexible.<\/p>\n<p><strong>Week 3: Frameworks.<\/strong>Complete Chapters 6\u20137. Choose a mainstream framework to reproduce examples, while reading the core structure of the self-built HelloAgents framework. Modify at least one tool or piece of decision logic to confirm you truly understand the execution chain.<\/p>\n<p><strong>Week 4: Memory and collaboration.<\/strong>Study Chapters 8\u201310. Add short-term memory, retrieval, or protocol capabilities to your earlier agent, and record context length, response quality, latency, and failure modes.<\/p>\n<p><strong>Week 5: Training and evaluation.<\/strong>Study chapters 11\u201312. If compute resources are limited, focus on understanding SFT, GRPO, and evaluation methods, prioritizing building test sets, metrics, and regression logs over blindly pursuing training scale.<\/p>\n<p><strong>Week 6: Case studies and capstone project.<\/strong>Reproduce one case from Travel Assistant, Deep Research, or Cyber Town, then replace the scenario with a problem you genuinely care about to complete the capstone project in Chapter 16.<\/p>\n<h2>Start today<\/h2>\n<p>If you only want to read, you can directly open the<a href=\"https:\/\/hello-agents.datawhale.cc\/\" target=\"_blank\" rel=\"noopener noreferrer external\">online documentation (China)<\/a>. To run examples or contribute, clone the official repository:<\/p>\n<pre><code>git clone https:\/\/github.com\/datawhalechina\/hello-agents.git\ncd hello-agents<\/code><\/pre>\n<p>Start by reading <code>docs\/preface.md<\/code>, then follow the README's chapter navigation into the main content. For each chapter, rely on the environment and dependencies specified in that chapter's instructions and the actual files in the <code>code<\/code> directory\u2014do not install all dependencies into a single Python environment without checking.<\/p>\n<p>For each learning session, I will record five items: this session's goal, key principles, commands run, inputs and outputs, and failure reasons with next experiment. Each week, I require only one verifiable deliverable to avoid mistaking \"finished reading\" for \"mastered.\"<\/p>\n<h2>Resources<\/h2>\n<ul>\n<li><a href=\"https:\/\/github.com\/datawhalechina\/hello-agents\" target=\"_blank\" rel=\"noopener noreferrer external\">Official GitHub Repository<\/a>: Code, content, contribution history, and latest changes.<\/li>\n<li><a href=\"https:\/\/hello-agents.datawhale.cc\/\" target=\"_blank\" rel=\"noopener noreferrer external\">online documentation (China)<\/a> \/ <a href=\"https:\/\/datawhalechina.github.io\/hello-agents\/\" target=\"_blank\" rel=\"noopener noreferrer external\">GitHub Pages<\/a>: Read online without downloading.<\/li>\n<li><a href=\"https:\/\/github.com\/datawhalechina\/hello-agents\/releases\/latest\" target=\"_blank\" rel=\"noopener noreferrer external\">Latest Release<\/a>: View published releases and PDFs.<\/li>\n<li><a href=\"https:\/\/github.com\/datawhalechina\/hello-agents\/issues\" target=\"_blank\" rel=\"noopener noreferrer external\">Issues<\/a>: Search issues, report bugs, or join discussions.<\/li>\n<\/ul>\n<hr>\n<p><strong>Attribution:<\/strong>The projects and chapters referenced in this article are sourced from the Datawhale community's <a href=\"https:\/\/github.com\/datawhalechina\/hello-agents\" target=\"_blank\" rel=\"noopener noreferrer external\">Hello-Agents official repository<\/a>, and the original authors recommend citing it as <cite>Hello-Agents: Building an AI Agent from Scratch<\/cite>(Sizhou Chen, Tao Sun, Shufan Jiang, et al., 2025). The original project uses <a href=\"https:\/\/creativecommons.org\/licenses\/by-nc-sa\/4.0\/deed.zh-hans\" target=\"_blank\" rel=\"noopener noreferrer external\">CC BY-NC-SA 4.0<\/a> License: Please retain attribution and comply with the non-commercial and share-alike terms.<\/p>","protected":false},"excerpt":{"rendered":"<p>Add Datawhale's open-source tutorial Hello-Agents to your learning list: from core concepts, classic paradigms, and framework practice, gradually progress to memory, context, protocols, evaluation, and multi-agent projects. This article outlines an actionable six-week learning roadmap and fully credits the original project's source and license.<\/p>","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[41],"tags":[42,46,44,43,45],"class_list":["post-186","post","type-post","status-publish","format-standard","hentry","category-artificial-intelligence","tag-ai-agent","tag-datawhale","tag-python","tag-43","tag-45"],"_links":{"self":[{"href":"https:\/\/haveyouself.fun\/en\/wp-json\/wp\/v2\/posts\/186","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/haveyouself.fun\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/haveyouself.fun\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/haveyouself.fun\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/haveyouself.fun\/en\/wp-json\/wp\/v2\/comments?post=186"}],"version-history":[{"count":1,"href":"https:\/\/haveyouself.fun\/en\/wp-json\/wp\/v2\/posts\/186\/revisions"}],"predecessor-version":[{"id":187,"href":"https:\/\/haveyouself.fun\/en\/wp-json\/wp\/v2\/posts\/186\/revisions\/187"}],"wp:attachment":[{"href":"https:\/\/haveyouself.fun\/en\/wp-json\/wp\/v2\/media?parent=186"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/haveyouself.fun\/en\/wp-json\/wp\/v2\/categories?post=186"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/haveyouself.fun\/en\/wp-json\/wp\/v2\/tags?post=186"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}