--- 원문: https://github.com/datawhalechina/hello-agents 창작 제목: "쓰는 사람에서 만드는 사람으로, 16장짜리 무료 에이전트 교과서" 원제: Hello-Agents 《从零开始构建智能体》 (밑바닥부터 만드는 AI 에이전트) 출처: 다비(davi.kr) 정리 https://davi.kr/ 정리일: 2026-09-09 문서의 목적: 중국 오픈소스 커뮤니티 Datawhale이 공개한 AI 에이전트 교재의 구성과 한계를 파악하고, 강의 및 학습 자료로 활용할 방법과 라이선스 제약을 판단한다. --- # 쓰는 사람에서 만드는 사람으로, 16장짜리 무료 에이전트 교과서 원문 링크: 온라인 열람: PDF 내려받기: ## 쉬운 설명 Hello-Agents는 중국의 오픈소스 학습 커뮤니티 Datawhale이 만든 무료 AI 에이전트 교재입니다. 에이전트(Agent)는 사람이 목표만 던져주면 스스로 계획을 세우고 도구를 써서 일을 끝내는 AI 프로그램을 말합니다. 이 교재는 챗GPT 같은 모델을 "쓰기만 하는 사람"을 "직접 에이전트를 만드는 사람"으로 바꾸는 것을 목표로 삼습니다. 전체 16개 장, 5개 부로 구성되어 있고 모든 장이 완성 상태입니다. 1부는 에이전트의 정의와 역사, 대규모 언어모델 기초를 다룹니다. 2부에서는 ReAct(생각과 행동을 번갈아 하는 방식), Plan-and-Solve(먼저 계획을 세우고 푸는 방식) 같은 대표 패턴을 직접 코드로 구현하고, Coze와 Dify, n8n 같은 노코드 도구와 LangGraph, AutoGen 같은 개발 프레임워크를 함께 다룬 뒤, 자체 프레임워크 HelloAgents를 밑바닥부터 만들어 봅니다. 3부는 기억과 검색(RAG), 컨텍스트 엔지니어링, MCP와 A2A 같은 통신 규약, 강화학습 기반 에이전트 훈련(SFT에서 GRPO까지), 성능 평가를 다룹니다. 4부는 여행 비서, 자동 심층 리서치 에이전트, 여러 에이전트가 사는 가상 마을 같은 종합 프로젝트이고, 5부는 졸업 과제입니다. 코드는 Python이 72.5%를 차지하며 전 장의 실습 코드가 code 폴더에 함께 들어 있습니다. 최신 배포판은 2026년 7월 17일 공개된 V1.0.3이고, 이번 버전부터 중국어와 영어 PDF가 함께 제공됩니다. 조회 시점 기준 별 77.8k, 포크 9.7k로 규모가 큰 저장소입니다. ## 활용 방법 가장 빠른 진입 경로는 PDF를 내려받지 말고 온라인 열람 페이지부터 여는 것입니다. 목차 16개를 훑고 자신에게 빈 곳만 골라 읽으면 반나절이면 지도가 그려집니다. **추천 진입 순서 3단계** 1. 진단(30분). 온라인 열람 페이지에서 4장(고전 패턴), 8장(기억과 검색), 10장(통신 규약) 세 곳만 펼쳐 봅니다. 세 곳 다 아는 내용이면 이 교재는 건너뛰고 14장 심층 리서치 에이전트로 바로 갑니다. 2. 실습(주말 2일). 저장소를 클론하고 code 폴더에서 4장 ReAct 예제를 돌립니다. 이 한 장이 교재 전체의 골격이라 여기서 막히면 뒤도 막힙니다. 3. 이식(1주). 13장 여행 비서나 14장 리서치 에이전트를 자기 도메인 데이터로 바꿔 다시 만듭니다. 예제를 읽는 것과 데이터를 바꿔 다시 세우는 것 사이에 실력 차이가 생깁니다. **강사 관점 활용 3가지** - 커리큘럼 골격 참조. 16장 구성 자체를 에이전트 과정 설계의 체크리스트로 씁니다. 노코드 5장, 프레임워크 6장, 자체 구현 7장으로 나눈 3단 구성은 수강생 수준 분기 설계에 그대로 대응됩니다. - 개념 검증용 대조군. 자신이 만든 슬라이드의 용어 정의를 이 교재와 대조해 오류를 잡습니다. 인용이 아니라 검증 용도이므로 라이선스 문제가 없습니다. - 부록 장 우선 활용. Extra05는 Agent Skills와 MCP의 차이를, Extra08은 좋은 Skill을 쓰는 법을 다룹니다. 이 두 편은 한국어 자료가 특히 부족한 영역입니다. **주의할 실행 조건** - 문서 본문은 중국어입니다. 영어 PDF는 V1.0.3부터 제공되지만 한국어판은 없습니다. 번역 도구를 물려 읽는 시간을 일정에 미리 넣으세요. - PDF에는 Extra Chapter가 포함되지 않습니다. 부록은 GitHub에서 따로 읽어야 합니다. ## 전체 내용에 대한 전문가 의견(사실 기반) **가장 먼저 확인할 것은 라이선스입니다.** 이 저작물은 CC BY-NC-SA 4.0을 따릅니다. 비영리(NC) 조항이 걸려 있으므로 유료 강의 교재, 유료 인강, 판매용 자료에 본문이나 그림을 그대로 옮겨 쓰는 것은 허용되지 않습니다. 동일조건변경허락(SA)도 붙어 있어 번역본이나 개작본을 배포할 때는 같은 라이선스를 유지해야 합니다. README가 "완전 무료"라고 강조하는 것은 열람과 학습의 무료를 뜻하는 것이지 상업적 재사용 허용이 아닙니다. 코드 부분의 별도 라이선스 명시가 없어 코드 재사용 범위도 보수적으로 잡는 편이 안전합니다. 확인된 강점은 세 가지입니다. 첫째, 커버리지가 넓습니다. 개념부터 강화학습 기반 훈련과 평가까지 한 저장소에서 이어지는 자료는 흔하지 않습니다. 둘째, 16개 장 전체가 완성 상태이고 2026년 7월까지 갱신이 이어졌습니다. 셋째, 노코드 플랫폼과 코드 프레임워크와 자체 구현을 대립시키지 않고 순서대로 배치해 학습 경로가 끊기지 않습니다. 한계도 분명합니다. README는 "체계적이고 실전 중심인 튜토리얼이 극도로 부족하다"고 서술하지만 이는 저자 측 주장이며 객관적으로 검증된 진술이 아닙니다. 실제로 유사 목적의 공개 자료는 여러 개 존재합니다. 자체 프레임워크 HelloAgents는 학습용으로 설계된 것이라 실무 투입을 전제로 배우면 투자 대비 효과가 낮습니다. 실무 이식이 목표라면 6장의 LangGraph 실습에 무게를 두는 편이 현실적입니다. 별 개수 급증은 Datawhale 커뮤니티의 동원력을 반영한 수치이므로 내용 품질의 직접 지표로 읽지 마십시오. 또한 5장에서 다루는 Coze와 Dify, n8n의 UI는 갱신 주기가 짧아 스크린샷 기준 설명이 실제 화면과 어긋날 가능성이 큽니다. 관련 이전 정리로는 awesome-llm-apps 저장소 분석 항목이 있습니다. 그쪽이 실행 가능한 예제 모음에 가깝다면 이 교재는 원리 설명이 붙은 교과서에 가깝습니다. 두 자료를 교차해 쓰는 편이 효율적입니다. ## Bottom Line 지금 온라인 열람 페이지를 열고 4장과 10장부터 확인하십시오. 무료 자료 중 이 정도 밀도로 원리와 구현을 함께 다루는 것은 드물고, 교재는 계속 갱신되므로 미루면 다시 읽어야 할 분량만 늘어납니다. 다만 유료 강의에 옮겨 쓸 계획이라면 CC BY-NC-SA 4.0 조건부터 확인하고 시작하십시오. ## 핵심 키워드 #HelloAgents #Datawhale #AI에이전트 #ReAct #LangGraph #MCP #AgenticRL #오픈소스교재 #CC_BY_NC_SA --- ## 자체 평가 87점 / 100점 - 확인된 사실: 저장소 구성 16장 5부, 챕터별 주제, HelloAgents 자체 프레임워크, Python 72.5%, CC BY-NC-SA 4.0 라이선스, V1.0.3 배포일 2026년 7월 17일, 중영문 PDF 제공, PDF에 Extra Chapter 미포함, 온라인 열람 및 PDF 링크 접속 확인 - 추론 영역: 라이선스가 유료 강의 활용에 미치는 영향의 구체적 범위, HelloAgents의 실무 적합성 평가, 5장 스크린샷의 최신성 저하 가능성 - 감점 사유: 별 개수가 저장소 메인 페이지 조회값(58.8k)과 릴리스 페이지 조회값(77.8k)에서 불일치해 캐시 시점 차이로 판단하고 후자를 채택했으나 확정하지 못함(-8점). 각 장의 실제 서술 깊이는 본문을 전수 확인하지 않아 목차 기준 판단에 머묾(-5점) 출처 정리: 다비(davi.kr)