bojieli/ai-agent-book

《深入理解 AI Agent：设计原理与工程实践》（李博杰著）开源主仓库：全书正文、编译版 PDF 与按章配套代码

📚 AI‑Agent‑Book 는 무엇인가요?

AI‑Agent‑Book 는 대규모 언어 모델(LLM), 컨텍스트(프롬프트, 메모리, 지식 기반), 외부 도구로 구성된 AI 에이전트 의 이론과 공학을 안내하는 오픈소스이며 다국어 지원 교과서입니다. 이 책은 10개의 장으로 나뉘어 있으며, 기초부터 다중 에이전트 협업까지 다룹니다. 각 장은 실제로 실행 가능한 실험(총 109개) 과 함께 제공되어, 개념을 직접 시도해볼 수 있습니다.

🎯 누구를 위한가요?

프로덕션 수준의 에이전트를 구축하고 싶은 실무자
재현 가능한 실험과 벤치마크 참조를 찾는 연구자
코드를 실행할 수 있는 구조화된 학습 경로를 선호하는 학생
프롬프트 공학에서 지속적 진화까지 에이전트 = LLM + 컨텍스트 + 도구 공식에 관심 있는 누구나

🛠️ 핵심 기능

기능	제공 내용
완전한 교과서	기초, 컨텍스트 공학, 메모리/RAG, 도구 사용, 코딩 에이전트, 다중 모달 상호작용, 평가, 파인튜닝, 평생 학습, 다중 에이전트 협업을 다루는 10개 장.
109개의 보조 실험	각 장마다 실행 가능한 Python 프로젝트(3.11–3.13) 제공. `uv sync --extra chX` 또는 `pip`로 설치 가능.
다국어 지원	핵심 중국어 원고에 더해 커뮤니티 번역으로 15개 언어(영어, 스페인어, 인도네시아어, 아랍어, 번체자, 러시아어, 타밀어, 베트남어, 일본어, 터키어, 한국어, 헝가리어, 히브리어, 포르투갈어-브라질) 제공.
PDF/EPUB 다운로드	오프라인 읽기 가능한 아름다운 타이포그래피 버전(PDF는 Pandoc, XeLaTeX, ElegantBook으로 생성).
온라인 리더	웹 UI(https://bojieli.github.io/ai-agent-book/)에서 장별 접기, 전체 텍스트 검색, 실험으로 바로 연결 가능.
확장 가능한 실험 생태계	책에서 인용된 22개 외부 리포지토리(예: Claude 빠른 시작, 브라우저 사용, XLeRobot, GAIA 벤치마크)를 복제하는 스크립트 제공.
명확한 기여 가이드	오픈소스 라이선스(Apache-2.0), 이슈 템플릿, 기여 유형 목록(콘텐츠, 코드, 번역, 그래픽).
후원 및 API 키	LLM 제공업체(Kimi, GLM, SiliconFlow, DeepSeek, Atlas Cloud, Krill AI, OpenRouter) 추천 및 Krill AI 사용자용 할인 코드 제공.

📂 리포지토리 구조(개요)

book/ – 중국어판의 마크다운 소스(장 1–10, 후기, 서문).
book‑en/, book‑es/, … – 커뮤니티 유지 관리 번역판.
chapterX/ – 각 장의 실험용 하위 폴더(예: chapter1/context/).
EPUB.md – EPUB 버전 빌드 지침.
docs/EXPERIMENT_STATUS.md – 실험의 기능 상태 추적.
LICENSE – Apache-2.0.

🚀 실험 시작하기

# UV 패키지 매니저 설치(선택 사항이지만 권장)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 장 1의 종속성 동기화(필요시 ch1 대신 ch2 … ch10로 변경)
uv sync --locked --extra ch1

# 데모 실행(환경이 pip로 설치된 경우에도 동일한 명령어 사용 가능)
uv run python chapter1/context/main.py

모든 실험은 LLM API 키가 필요합니다(.env 파일 또는 환경 변수에 설정). 각 실험의 README에는 지원하는 제공업체가 명시되어 있습니다.

📖 책 사용 방법

읽기 – GitHub에서 직접 장을 둘러보거나 온라인 리더를 통해.
실행하기 – 각 장의 "실험" 링크를 따라 관련 코드를 클론/실행.
반복하기 – 코드를 수정하고, 다른 프롬프트를 시도하거나, 모델을 교체하거나, 새로운 도구를 추가하여 이해를 심화.
기여하기 – 오타 수정, 다이어그램 개선, 새로운 실험 추가, 장 번역.

🙌 커뮤니티 및 지원

기여자는 앞면에 명시되어 있으며, 누구나 PR 또는 이슈를 열 수 있습니다.
후원: Krill AI는 유료 플랜 사용자에게 할인 코드(ai-agent-book) 제공.
토론: 실험, 부족한 종속성, 번역 도움과 관련된 질문은 이슈가 주요 장소입니다.

🎓 TL;DR

AI‑Agent‑Book 은 LLM 기반 에이전트의 설계, 구축, 평가, 진화를 가르치는 무료이고 다국어 지원 교과서이며, 재현 가능한 Python 실험의 완전한 세트를 제공합니다. 이론이 아닌 실용적인 학습 자료로서, 현대 AI 에이전트에 직접 손을 대고 싶은 누구에게나 훌륭한 입문 자료입니다.