bojieli/ai-agent-book

これは何？

主な機能

• 01コンテキストエンジニアリング、メモリとRAG、MCPツール、コーディングエージェント、マルチエージェントシステムを扱う全10章。
• 02章ごとに整理された109の付属演習。それぞれPythonプロジェクトとして実行可能。
• 03ダウンロード可能なPDF・EPUBとオンラインリーダー。
• 04書籍を再生成するためのビルドスクリプトとSVG図版を含む、中国語のMarkdown原稿。
• 05コミュニティによる12以上の言語への翻訳。

ユースケース

• AIエージェントの構築について、原則を重視した体系的な理解を深めたい開発者。
• コーディングエージェントを開発しており、本書の章ごとの演習に沿って学びたいエンジニア。
• 評価の章を参考に、評価セットを整備し、エージェントの失敗を分析・改善したいチーム。
• 中国語の技術書を読みながら、コードにも取り組みたい読者。

クイックスタート

1. 1

   uv を使って chapter 1 の依存関係をインストールします（Python 3.11～3.13）

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

   .env.example を .env にコピーし、少なくとも1つのモデルプロバイダーの API キーを追加します

3. 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の演習とPDF・EPUB付きの中国語オープンソース書籍。 このリポジトリには、書籍『Deep Understanding of AI Agents: Design Principles and Engineering Practice』の全文、図版、付属コードが収録されています。本書の基本式は「Agent = LLM + context + tools」で、基礎から本番運用までの全10章を通して、コンテキストエンジニアリング、ユーザーメモリとRAG、MCPによるツール利用、コーディングエージェント、音声やコンピューター操作によるインタラクション、評価、モデルの事後学習、継続的な改善、マルチエージェントの協調について解説しています。

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 にコピーし、少なくとも1つのモデルプロバイダーの API キーを追加します リポジトリのルートから chapter 1 の実験を実行します: uv run python chapter1/context/main.py

ai-agent-book はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/bojieli/ai-agent-book