GenAI 에이전트를 프로토타입에서 프로덕션 단계로 발전시키는 코드 중심 튜토리얼 28개 모음으로, 메모리, RAG, 배포, 보안, 관측 가능성을 다룹니다.
bojieli/ai-agent-book
AI Agent 설계 원칙과 엔지니어링 실무를 다루는 무료 오픈소스 중국어 도서와 109개 실습
- 스타
- 54,919
- 포크
- 6,280
- 열린 이슈
- 35
- 마지막 커밋
- 12일 전
어떤 프로젝트인가요?
이 저장소에는 『Deep Understanding of AI Agents: Design Principles and Engineering Practice』의 전체 원문과 삽화, 부록 코드가 담겨 있습니다. 이 책의 핵심 공식은 Agent = LLM + context + tools이며, 기초부터 프로덕션까지 10개 장에 걸쳐 context engineering, 사용자 메모리와 RAG, MCP를 통한 도구 사용, 코딩 에이전트, 음성 및 컴퓨터 사용을 활용한 상호작용, 평가, 모델 post-training, 지속적인 개선, 멀티 에이전트 협업을 다룹니다.
저장소에는 중국어 원문의 Markdown 파일, SVG 그림, PDF 및 EPUB 출력을 위한 빌드 스크립트가 포함되어 있습니다. 12개가 넘는 언어로 커뮤니티 번역본을 제공하며, 온라인 뷰어는 GitHub Pages에 게시되어 있습니다. 각 장에는 uv 또는 pip로 설치할 수 있는 Python 프로젝트 형태의 실행 가능한 실습이 있으며, 부록에는 일부 실습을 재현할 수 있도록 특정 커밋에 고정된 외부 저장소 목록이 있습니다.
대부분의 장에서 요구하는 사전 지식은 높지 않습니다. 중급 수준의 Python, LLM 채팅 제품 사용 경험, 기본적인 명령줄 및 Git 지식이면 됩니다. post-training 장에서만 충분한 수학 및 머신러닝 배경지식이 필요합니다.
핵심 기능
- 01context engineering, 메모리와 RAG, MCP 도구, 코딩 에이전트, 멀티 에이전트 시스템을 다루는 10개 장.
- 02장별로 구성된 109개의 부록 실습으로, 각각 Python 프로젝트로 실행할 수 있습니다.
- 03다운로드 가능한 PDF 및 EPUB 파일과 온라인 뷰어.
- 04책을 재현할 수 있는 Markdown 형식의 중국어 원문, SVG 그림, 빌드 스크립트.
- 0512개가 넘는 언어로 제공되는 커뮤니티 번역본.
활용 사례
- AI 에이전트 구축을 체계적이고 원칙 중심으로 이해하고 싶은 개발자.
- 책의 장별 실습을 따라가며 코딩 에이전트를 만들고 싶은 엔지니어.
- 평가 장을 참고해 평가 세트를 구성하고 에이전트의 실패 사례를 개선하려는 팀.
- 중국어 기술 도서를 읽으며 코드 실습을 함께 진행하고 싶은 독자.
빠른 시작
- 1
uv를 사용해 chapter 1의 종속 항목을 설치합니다(Python 3.11–3.13).
uv sync --locked --extra ch1 - 2
.env.example을 .env로 복사하고 모델 제공업체 API 키를 하나 이상 추가합니다.
- 3
저장소 루트에서 chapter 1 실험을 실행합니다.
uv run python chapter1/context/main.py
사용 전 알아둘 점
- 대부분의 실험은 LLM 제공업체를 호출하므로 개인 API 키가 필요하며, 유료일 수 있습니다.
- 일부 실험에는 브라우저, CUDA, FFmpeg, Ollama 등의 추가 시스템 종속 항목이 필요하며, chapter 8의 일부 구성 요소에는 Python 3.12 이상이 필요합니다.
- 함께 제공되는 실험에는 외부 저장소가 포함되어 있으며, 해당 폴더에 직접 clone해야 합니다.
토픽
자주 묻는 질문
- ai-agent-book은(는) 무엇인가요?
- AI Agent 설계 원칙과 엔지니어링 실무를 다루는 무료 오픈소스 중국어 도서와 109개 실습 이 저장소에는 『Deep Understanding of AI Agents: Design Principles and Engineering Practice』의 전체 원문과 삽화, 부록 코드가 담겨 있습니다. 이 책의 핵심 공식은 Agent = LLM + context + tools이며, 기초부터 프로덕션까지 10개 장에 걸쳐 context engineering, 사용자 메모리와 RAG, MCP를 통한 도구 사용, 코딩 에이전트, 음성 및 컴퓨터 사용을 활용한 상호작용, 평가, 모델 post-training, 지속적인 개선, 멀티 에이전트 협업을 다룹니다.
- ai-agent-book은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- ai-agent-book은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- ai-agent-book은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. ai-agent-book의 마지막 커밋은 2026년 10월 8일입니다.
- ai-agent-book은(는) 어디에 사용할 수 있나요?
- AI 에이전트 구축을 체계적이고 원칙 중심으로 이해하고 싶은 개발자. 책의 장별 실습을 따라가며 코딩 에이전트를 만들고 싶은 엔지니어. 평가 장을 참고해 평가 세트를 구성하고 에이전트의 실패 사례를 개선하려는 팀. 중국어 기술 도서를 읽으며 코드 실습을 함께 진행하고 싶은 독자.
- ai-agent-book는 어떻게 설치하나요?
- uv를 사용해 chapter 1의 종속 항목을 설치합니다(Python 3.11–3.13).: uv sync --locked --extra ch1 .env.example을 .env로 복사하고 모델 제공업체 API 키를 하나 이상 추가합니다. 저장소 루트에서 chapter 1 실험을 실행합니다.: uv run python chapter1/context/main.py
- ai-agent-book은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/bojieli/ai-agent-book
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
질문을 계획하고 웹·로컬 자료를 수집해 인용이 포함된 보고서를 작성하는 오픈소스 자율 연구 에이전트
AI 에이전트가 실제 작업을 수행하도록 Docker 기반 Linux 데스크톱, 브라우저, 문서 도구를 제공하는 오픈 에이전트 프레임워크
자연어 설명만으로 내장 도구, 메모리, 오케스트레이션을 갖춘 프로덕션 수준의 AI 에이전트를 생성하는 노코드 플랫폼입니다.
에이전트 작업 결과를 에이전트와 LLM이 공유하는 편집 가능한 Markdown 스킬 파일로 바꾸는 오픈소스 메모리 레이어입니다.
간단한 챗봇부터 멀티 에이전트 시스템까지, 생성형 AI 에이전트 기법을 다루는 실행 가능한 Jupyter Notebook 튜토리얼 50개 이상을 모았습니다.