bojieli/ai-agent-book

Что это?

Ключевые возможности

• 01Десять глав о проектировании контекста, памяти и RAG, инструментах MCP, coding agents и мультиагентных системах.
• 02109 сопутствующих экспериментов, сгруппированных по главам; каждый можно запустить как Python-проект.
• 03PDF и EPUB для скачивания, а также онлайн-версия книги.
• 04Исходный текст на китайском языке в Markdown, иллюстрации в SVG и скрипты для самостоятельной сборки книги.
• 05Переводы сообщества более чем на десяток языков.

Сценарии использования

• Разработчики, которым нужно системно разобраться в принципах создания AI Agent.
• Инженеры, создающие coding agent и желающие пройти эксперименты из книги по главам.
• Команды, которые формируют наборы для оценки и улучшают агента, анализируя его ошибки по материалам главы об оценке.
• Читатели, которым удобнее изучать код параллельно с чтением технической книги на китайском языке.

Быстрый старт

1. 1

   Установите зависимости для chapter 1 с помощью uv (Python 3.11–3.13)

   uv sync --locked --extra ch1
2. 2

   Скопируйте .env.example в .env и добавьте как минимум один API-ключ провайдера моделей

3. 3

   Запустите эксперимент из chapter 1 из корневой папки репозитория

   uv run python chapter1/context/main.py

Что важно знать

• !Большинство экспериментов обращаются к провайдерам LLM, поэтому вам понадобится собственный API-ключ, использование которого может быть платным.
• !Некоторым экспериментам нужны дополнительные системные зависимости, например браузеры, CUDA, FFmpeg или Ollama. Для некоторых компонентов chapter 8 требуется Python 3.12 или новее.
• !В сопутствующие эксперименты входят внешние репозитории, которые нужно вручную клонировать в соответствующие папки.

Темы

Частые вопросы

Что такое ai-agent-book?

Бесплатная китайскоязычная книга с открытым исходным кодом о принципах проектирования AI Agent и инженерной практике: 109 экспериментов, PDF и EPUB для скачивания. В этом репозитории собраны полный текст, иллюстрации и сопутствующий код книги «Глубокое понимание AI Agent: принципы проектирования и инженерная практика». Основная формула книги: Agent = LLM + контекст + инструменты. В десяти главах рассматривается путь от основ до production: проектирование контекста, память пользователя и RAG, работа с инструментами через MCP, coding agents, взаимодействие с голосом и компьютером, оценка, post-training моделей, непрерывное улучшение и взаимодействие нескольких агентов.

ai-agent-book можно использовать бесплатно? Какая у него лицензия?

ai-agent-book распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.

ai-agent-book всё ещё поддерживается?

Активно поддерживается. Последний коммит в ai-agent-book — 8 окт. 2026 г..

Для чего можно использовать ai-agent-book?

Разработчики, которым нужно системно разобраться в принципах создания AI Agent. Инженеры, создающие coding agent и желающие пройти эксперименты из книги по главам. Команды, которые формируют наборы для оценки и улучшают агента, анализируя его ошибки по материалам главы об оценке. Читатели, которым удобнее изучать код параллельно с чтением технической книги на китайском языке.

Как установить ai-agent-book?

Установите зависимости для chapter 1 с помощью uv (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