bojieli/ai-agent-book

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

📚 AI‑Agent‑Book とは何ですか？

AI‑Agent‑Book は、大規模言語モデル（LLM）、コンテキスト（プロンプト、メモリ、知識ベース）、外部ツールから構成される AIエージェント の理論と工学について解説するオープンソースで多言語対応の教科書です。本書は 10章 に分かれており、基礎からマルチエージェント協調までをカバーしています。各章には 実行可能な実験（合計109個） が付随しており、実際に概念を試すことができます。

🎯 対象読者

プロダクションレベルのエージェントを構築したい 実務者
再現可能な実験とベンチマークリファレンスを探している 研究者
コードを実行できる構造的な学習パスを好む学生
プロンプト工学から継続的進化まで、エージェント = LLM + コンテキスト + ツール の公式に興味がある 誰でも

🛠️ 主な特徴

特徴	内容
完全な教科書	基礎、コンテキスト工学、メモリ/RAG、ツール利用、コーディングエージェント、マルチモーダル対話、評価、ファインチューニング、生涯学習、マルチエージェント協調の10章をカバー。
109の補足実験	各章ごとに実行可能なPythonプロジェクト（Python 3.11–3.13）を提供。`uv sync --extra chX` または `pip` でインストール可能。
多言語対応	コアの中国語原稿に加え、コミュニティによる15言語への翻訳（英語、スペイン語、インドネシア語、アラビア語、繁体字中国語、ロシア語、タミル語、ベトナム語、日本語、トルコ語、韓国語、ハンガリー語、ヘブライ語、ポルトガル語（ブラジル））。
PDF/EPUBダウンロード	オフライン閲覧可能な、美しいタイプセットされたバージョン（PDFはPandoc、XeLaTeX、ElegantBookで構築）。
オンラインリーダー	Web 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/ – 中国語版のMarkdownソース（チャプター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エージェントに実際に触れてみたい人にとって最適な入門書です。