中文 · English · Español · Bahasa Indonesia · العربية · 繁體中文（台灣） · Русский · Tiếng Việt · தமிழ் · 日本語 · Türkçe · 한국어 ← 현재 · Magyar
📥 PDF / EPUB 다운로드(권장) — PDF와 EPUB 판본에서 가장 좋은 읽기 경험을 제공합니다. 온라인 판본에서는 언어 전환, 접을 수 있는 장별 탐색, 전체 텍스트 검색을 이용할 수 있습니다.
에이전트 = LLM + 컨텍스트 + 도구 — 이 책은 이 핵심 공식을 중심으로 10개 장에 걸쳐 AI 에이전트의 원리부터 엔지니어링 실전까지 설명합니다. 본문과 그림, 94개의 연계 실습을 모두 오픈 소스로 공개합니다.
| 📚 기초부터 프로덕션까지 10개 장 | 📂 94개 연계 실습(로컬 프로젝트와 외부 재현 트랙 포함) | 🌐 13개 언어: 중 / 영 / 스페인 / 인도네시아 / 아랍 / 번체 중국어(대만) / 러 / 타밀 / 베트남 / 일 / 터키 / 한 / 헝가리 |
|---|
📥 다운로드(전체 본문, 무료·오픈 소스). 아래 링크는 항상
main브랜치의 최신 빌드를 가리킵니다. 고정 버전은 Releases에서 확인할 수 있습니다.
- 한국어(커뮤니티 번역, @JeongJaeSoon): PDF · EPUB
- 중국어 원문: PDF · EPUB
- 영어(@nsdevaraj, @whanyu1212): PDF · EPUB
- 스페인어(커뮤니티 번역, @santhreal): PDF · EPUB
- 번체 중국어(대만)(@tigercosmos): PDF · EPUB
- 러시아어(@ui99ru): PDF · EPUB
- 타밀어(@nsdevaraj): PDF · EPUB
- 베트남어(@toanalien): PDF · EPUB
- 일본어(@eltociear): PDF · EPUB
- 아랍어(@TheSyBuilder): PDF · EPUB
- 터키어(@memisemre): PDF · EPUB
🌐 온라인으로도 읽을 수 있습니다.
main브랜치가 갱신될 때마다 사이트가 자동으로 다시 빌드됩니다.
중국어 원문은 book/에 있으며, 한국어판은 book-ko/에 있습니다. 다른 언어판은 각 언어 디렉터리에 있는 커뮤니티 번역으로, 중국어 원문보다 갱신이 늦을 수 있습니다.
🔧 PDF / EPUB를 직접 빌드하려면? (PDF는 pandoc / xelatex / ElegantBook 필요)
-
EPUB: 공통 빌더를 사용합니다. 자세한 내용은 EPUB 빌드 안내를 참고하세요
-
본문 소스:
book-ko/introduction.ko.md,book-ko/chapter1.ko.md~book-ko/chapter10.ko.md,book-ko/afterword.ko.md -
빌드: pandoc, xelatex, ElegantBook 문서 클래스와 Noto CJK KR 글꼴을 설치한 뒤 다음을 실행합니다.
cd book-ko && bash build_pdf.sh
그림은
book-ko/images/의 SVG 파일을 사용합니다. 조판 설정은book-ko/preamble.tex와book-ko/*.lua에서 확인할 수 있습니다.
| 장 | 주제 | 핵심 내용 | 본문 | 코드 |
|---|---|---|---|---|
| 1 | 🚀 AI 에이전트 기초 | 에이전트 = LLM + 컨텍스트 + 도구. 경쟁력의 핵심은 하네스 엔지니어링 | 읽기 | 4 |
| 2 | 🎯 컨텍스트 엔지니어링 | KV Cache, 프롬프트 엔지니어링, Agent Skills, 컨텍스트 압축 | 읽기 | 8 |
| 3 | 📚 사용자 메모리와 지식 베이스 | 세션 간 사용자 메모리, RAG, 구조화 색인, 지식 그래프 | 읽기 | 12 |
| 4 | 🛠️ 도구 | MCP, 인식·실행·협업 도구, 이벤트 기반 비동기 에이전트, 능동적 도구 탐색 | 읽기 | 8 |
| 5 | 💻 코딩 에이전트와 코드 생성 | 코드는 새 도구를 만들 수 있는 도구. 프로덕션급 코딩 에이전트의 전체 구조 | 읽기 | 13 |
| 6 | 🎯 에이전트 평가 | 평가 환경, 지표, 통계적 유의성, 평가 기반 선택 | 읽기 | 17 |
| 7 | 🧠 모델 사후 학습 | 사전 학습·SFT·RL, 도구 호출 내재화, 샘플 효율성 | 읽기 | 18 |
| 8 | 🔄 에이전트의 지속적 진화 | 실행 궤적에서 학습 신호를 얻고 지식·지침·프로그램·파라미터 갱신 | 읽기 | 9 |
| 9 | 🎙️ 멀티모달과 실시간 상호작용 | 음성, GUI, Computer Use, 로보틱스 | 읽기 | 12 |
| 10 | 🤝 멀티 에이전트 협업 | 협업 구조, 컨텍스트 공유와 격리, 에이전트 사회 | 읽기 | 8 |
💡 읽기는 GitHub에서 장 본문을 여는 링크이며, N은 해당 장의 연계 프로젝트 수입니다. 프로젝트 유형(✅ 독립 실행 / 📖 재현 가이드 / 🚧 진행 중)은 각 장의 README에 설명되어 있습니다.
📚 효율적인 학습 순서는 **학습 가이드**에서 확인하세요.
실습을 원활하게 진행하려면 몇 가지 플랫폼의 API 키를 준비하는 편이 좋습니다. 모델 선택은 이 안내를 참고하세요.
| 플랫폼 | 링크 | 비고 | 접속 지역 |
|---|---|---|---|
| Kimi (Moonshot) | https://platform.moonshot.cn/ | 긴 컨텍스트와 에이전트 기능에 강한 Kimi 계열 | 중국 본토 |
| Zhipu GLM | https://open.bigmodel.cn/ | GLM-4.6 등, 중국어 성능과 비용 효율이 좋음 | 중국 본토 |
| SiliconFlow | https://siliconflow.cn/ | DeepSeek, Qwen 등 여러 오픈 소스 모델 | 중국 본토 |
| DeepSeek | https://platform.deepseek.com/ | DeepSeek 공식 API | 글로벌·중국 본토 |
| Krill AI | www.krill-ai.net | 주요 글로벌·중국 모델을 한곳에서 제공 | 글로벌·중국 본토 |
| OpenRouter | https://openrouter.ai/ | GPT, Claude, Gemini, Kimi, GLM, DeepSeek, Qwen 등을 한곳에서 제공 | 글로벌 |
이 프로젝트를 후원하는 Krill AI에 감사드립니다. Krill은 GPT, Claude, Gemini와 여러 중국 모델을 위한 안정적인 API 중계 서비스, 기업 맞춤 지원, 전용 WebSocket 연결을 제공합니다.
이 책의 독자는 이 링크로 가입하고 충전할 때 프로모션 코드 ai-agent-book을 입력하면 첫 Codex 플랜을 23% 할인받을 수 있습니다.
🧪 실험 실행 상태, 증거, 미충족 승인 조건은
EXPERIMENT_STATUS.md에서 별도로 관리합니다. 소스 코드를 복제하거나 설치한 것만으로는 실험 완료를 입증할 수 없습니다.
제6·7·9·10장의 벤치마크, 학습 프레임워크, 로봇 플랫폼에 쓰이는 외부 저장소 23개는 크기와 라이선스 문제로 이 저장소에 포함되어 있지 않습니다.
🔧 clone 명령 펼치기 (외부 저장소 23개)
# 제6장 · 평가 벤치마크
git clone https://github.com/google-research/android_world.git chapter6/android_world
git clone https://huggingface.co/datasets/gaia-benchmark/GAIA chapter6/GAIA
git clone https://github.com/xlang-ai/OSWorld.git chapter6/OSWorld
git clone https://github.com/SWE-bench/SWE-bench.git chapter6/SWE-bench
git clone https://github.com/sierra-research/tau2-bench.git chapter6/tau2-bench
git clone https://github.com/laude-institute/terminal-bench.git chapter6/terminal-bench
# 제7장 · 학습 프레임워크(bojieli/*는 책에 맞춘 fork)
git clone https://github.com/bojieli/minimind.git chapter7/MiniMind-pretrain/minimind
git clone https://github.com/bojieli/minimind-v.git chapter7/MiniMind-pretrain/minimind-v
git clone https://github.com/bojieli/AdaptThink.git chapter7/AdaptThink-original
git clone https://github.com/bojieli/AWorld.git chapter7/AWorld
git clone https://github.com/bojieli/SFTvsRL.git chapter7/SFTvsRL
git clone https://github.com/bojieli/verl.git chapter7/verl
git clone https://github.com/bojieli/SandboxFusion.git chapter7/SandboxFusion && git -C chapter7/SandboxFusion fetch origin 4a0d573ebd64c98234c190a9d1d49e4276199a0c && git -C chapter7/SandboxFusion checkout --detach 4a0d573ebd64c98234c190a9d1d49e4276199a0c && test "$(git -C chapter7/SandboxFusion rev-parse HEAD)" = "4a0d573ebd64c98234c190a9d1d49e4276199a0c" # 실험 7-15 코드 샌드박스
git clone https://github.com/thinking-machines-lab/tinker-cookbook.git chapter7/tinker-cookbook
git clone https://github.com/19PINE-AI/rlvp.git chapter7/RLVP/rlvp
git clone https://github.com/PRIME-RL/SimpleVLA-RL.git chapter7/SimpleVLA-RL/SimpleVLA-RL
# 제9장 · 브라우저 자동화와 Claude 예제
git clone https://github.com/browser-use/browser-use.git chapter9/browser-use
git clone https://github.com/anthropics/claude-quickstarts.git chapter9/claude-quickstarts
git clone https://github.com/Vector-Wangel/XLeRobot.git chapter9/XLeRobot && git -C chapter9/XLeRobot fetch origin 3d14695e40c9c68229c0aacffca6053c75cd3eb6 && git -C chapter9/XLeRobot checkout --detach 3d14695e40c9c68229c0aacffca6053c75cd3eb6 && test "$(git -C chapter9/XLeRobot rev-parse HEAD)" = "3d14695e40c9c68229c0aacffca6053c75cd3eb6" # Exp 9-7/9-9 shared
git clone https://github.com/Grigorij-Dudnik/RoboCrew.git chapter9/RoboCrew && git -C chapter9/RoboCrew fetch origin c749148f29bd14e61347f9fc3530c343fff0d994 && git -C chapter9/RoboCrew checkout --detach c749148f29bd14e61347f9fc3530c343fff0d994 && test "$(git -C chapter9/RoboCrew rev-parse HEAD)" = "c749148f29bd14e61347f9fc3530c343fff0d994" # Exp 9-8/9-9; RoboCrew v0.3.1
git clone https://github.com/StoneT2000/lerobot-sim2real.git chapter9/lerobot-sim2real && git -C chapter9/lerobot-sim2real fetch origin 87d6c1d969f6e0ca4dc5697940804e231118a63a && git -C chapter9/lerobot-sim2real checkout --detach 87d6c1d969f6e0ca4dc5697940804e231118a63a && test "$(git -C chapter9/lerobot-sim2real rev-parse HEAD)" = "87d6c1d969f6e0ca4dc5697940804e231118a63a" # Exp 9-11
# 제10장 · 듀얼 에이전트 구조와 Stanford AI Town
git clone https://github.com/19PINE-AI/TalkAct.git chapter10/use-computer-while-calling
git clone https://github.com/joonspk-research/generative_agents.git chapter10/generative_agents
SandboxFusion명령은 재현성을 위해 고정된 커밋 SHA를 detached HEAD 상태로 체크아웃하고, 실제 HEAD가 해당 SHA와 일치하는지 확인합니다. 다른 프로젝트 README가 특정 커밋을 지정한다면 해당 버전으로git checkout하세요. 제10장의use-computer-while-calling은 독립 프로젝트 19PINE-AI/TalkAct로 발전했습니다.
책과 연계 코드는 모두 오픈 소스이며 Pull Request를 환영합니다.
| 유형 | 내용 |
|---|---|
| 📝 본문 | 오탈자 수정, 보충 설명, 더 명확한 표현, 최신 동향 반영 |
| 🐛 코드 개선과 버그 수정 | 연계 프로젝트의 견고성·사용성·프로덕션 적합성 개선 |
| 🧪 새 실습 프로젝트 | 더 나은 구현을 추가하거나 기존 구현을 대체 |
| 🎨 그림 | book-ko/images/의 한국어 SVG 그림 개선 |
| 🌐 새 번역 | 기존 언어판의 디렉터리 구성을 참고해 새 번역 추가 |
제출하기 전에 관련 실험을 직접 실행해 재현 가능성을 확인해 주세요. 아이디어를 먼저 Issue로 논의하는 것도 환영합니다.
이 프로젝트는 Apache License 2.0에 따라 배포됩니다. 일부 하위 프로젝트는 별도 라이선스를 포함할 수 있습니다.
scripts/gen_star_history.py로 생성하며 GitHub Actions가 매일 갱신합니다.