README.md
深入理解 AI Agent:設計原理與工程實踐
中文 · 中文繁體 ← 當前 · English · Tiếng Việt · தமிழ்
Agent = LLM + 上下文 + 工具——本書圍繞這個核心公式,用 10 章把 AI Agent 從原理講到工程實戰。全書正文、配圖、88 個配套實驗全部開源,歡迎親手把實驗跑一遍。
| 📚 10 章 正文,從基礎到生產 | 📂 88 個 配套專案(70+ 可獨立執行) | 🌐 5 種 語言:中 / 中文繁體 / 英 / 泰 / 越 |
|---|
📖 電子書
📥 直接下載(全書正文,開源免費)。以下連結始終指向 main 分支的最新建置;固定版本見 Releases:
- 中文(原版):PDF · EPUB
- 中文繁體(社群翻譯,by @tigercosmos):PDF · EPUB
- 英文(社群翻譯,by @nsdevaraj):PDF · EPUB
- 泰米爾語(社群翻譯,by @nsdevaraj):PDF · EPUB
- 越南語(社群翻譯,by @toanalien):PDF · EPUB
中文正文原始碼位於 book/;中文繁體/英文/泰米爾/越南語版本為社群貢獻(可能滯後於中文原版),分別位於 book-zhtw/、book-en/、book-ta/、book-vi/。
可使用統一的建置腳本產生中文、中文繁體、英文、泰米爾語和越南語 EPUB 3 電子書。請參閱 EPUB 建置說明。
🔧 想自行編譯 PDF?(需 pandoc / xelatex / ElegantBook)
-
正文原始碼:
book/introduction.md(引言)、book/chapter1.md~book/chapter10.md(第一至第十章)、book/afterword.md(後記) -
編譯:安裝 pandoc、xelatex、ElegantBook 文件類與相關字型後,執行
cd book && bash build_pdf.sh圖表由
book/gen_*_figs.py生成、存於book/images/,排版細節見book/preamble.tex與book/*.lua。
📑 內容速覽(第 1–10 章)
全書圍繞核心公式 Agent = LLM + 上下文 + 工具 展開,十章層層遞進:
| 章 | 主題 | 一句話核心 | 正文 | 程式碼 |
|---|---|---|---|---|
| 1 | 🚀 Agent 基礎知識 | 「模型即 Agent」新典範 + Agent = LLM + 上下文 + 工具;Harness 工程才是競爭力 | 讀 | 4 |
| 2 | 🎯 上下文工程 | 上下文決定能力上限:KV Cache、提示工程、Agent Skills、上下文壓縮 | 讀 | 9 |
| 3 | 📚 使用者記憶和知識庫 | 跨會話記住使用者、接入外部知識:使用者記憶、RAG、結構化索引、知識圖譜 | 讀 | 13 |
| 4 | 🛠️ 工具 | 工具是 Agent 的雙手:MCP 協議、感知/執行/協作三類工具、事件驅動非同步 Agent、主動工具發現 | 讀 | 7 |
| 5 | 💻 Coding Agent 與程式碼生成 | 程式碼是「能創造新工具的工具」,生產級 Coding Agent 全景 | 讀 | 12 |
| 6 | 🎯 Agent 的評估 | 把表現變成可比較訊號:評估環境、指標、統計顯著性、評估驅動選型 | 讀 | 10 |
| 7 | 🧠 模型後訓練 | 預訓練/SFT/RL 三階段:何時選 SFT、何時選 RL,工具呼叫內化、樣本效率 | 讀 | 14 |
| 8 | 🔄 Agent 的自我進化 | 不改權重也能成長:經驗學習、從工具使用者到創造者 | 讀 | 6 |
| 9 | 🎙️ 多模態與即時互動 | 從文字擴充套件到語音、GUI、物理世界:語音三典範、Computer Use、機器人 | 讀 | 7 |
| 10 | 🤝 多 Agent 協作 | 群體智慧高於個體:協作框架、上下文共享/隔離、湧現的「Agent 社會」 | 讀 | 6 |
💡 讀 = 在 GitHub 網頁直接讀章節正文(markdown);N = 該章配套專案數,點選檢視程式碼。專案型別說明(✅ 可執行 / 📖 復現 / 🚧 設計)見各章 README。
📚 如何高效閱讀本書?詳見 學習建議(核心理念、學習路徑、難度分級、實踐建議)。
🔑 API 金鑰
建議申請下面幾個平台的 API Key 方便學習。模型選型可參考 這篇指南。
| 平台 | 連結 | 特色 |
|---|---|---|
| Kimi(月之暗面) | https://platform.moonshot.cn/ | Kimi 系列,Coding、Agent 能力強 |
| 智譜 GLM | https://open.bigmodel.cn/ | GLM-5.2 等,Coding、Agent 能力強 |
| Siliconflow | https://siliconflow.cn/ | 各種開源模型(DeepSeek、Qwen 等) |
| 火山引擎 | https://www.volcengine.com/product/ark | 位元組豆包閉源模型,國內訪問延遲低 |
| OpenRouter | https://openrouter.ai/ | 一站式訪問 Gemini / Claude / GPT-5 等海外模型(官方 API 需海外 IP/支付方式,OpenAI 還需海外身份認證) |
📦 附錄 · 外部倉庫獲取
第 6、7、9、10 章的評測基準、訓練框架、機器人平台等 20 個外部倉庫未內建(出於體積與版權),需要自行克隆到對應目錄。
一鍵克隆指令碼
🔧 展開克隆命令(共 20 個外部倉庫)
# 第 6 章 · 評測基準
git clone https://github.com/google-research/android_world.git chapter6/android_world
git clone https://huggingface.co/datasets/gaia-benchmark/GAIA chapter6/GAIA
git clone https://github.com/xlang-ai/OSWorld.git chapter6/OSWorld
git clone https://github.com/SWE-bench/SWE-bench.git chapter6/SWE-bench
git clone https://github.com/sierra-research/tau2-bench.git chapter6/tau2-bench
git clone https://github.com/laude-institute/terminal-bench.git chapter6/terminal-bench
# 第 7 章 · 訓練框架(bojieli/* 為本書適配的分支)
git clone https://github.com/bojieli/minimind.git chapter7/MiniMind-pretrain/minimind # 實驗 7-3 從零訓 LLM
git clone https://github.com/bojieli/minimind-v.git chapter7/MiniMind-pretrain/minimind-v # 實驗 7-4 從零訓 VLM(投影層)
git clone https://github.com/bojieli/AdaptThink.git chapter7/AdaptThink-original
git clone https://github.com/bojieli/AWorld.git chapter7/AWorld
git clone https://github.com/bojieli/SFTvsRL.git chapter7/SFTvsRL
git clone https://github.com/bojieli/verl.git chapter7/verl
git clone https://github.com/thinking-machines-lab/tinker-cookbook.git chapter7/tinker-cookbook
git clone https://github.com/bojieli/lighteval.git chapter7/Intuitor/lighteval
git clone https://github.com/19PINE-AI/rlvp.git chapter7/RLVP/rlvp # 實驗 7-14 RLVP 論文程式碼
git clone https://github.com/PRIME-RL/SimpleVLA-RL.git chapter7/SimpleVLA-RL/SimpleVLA-RL # 實驗 7-13 視覺-語言-動作 RL
# 第 9 章 · 瀏覽器自動化與 Claude 示例
git clone https://github.com/browser-use/browser-use.git chapter9/browser-use
git clone https://github.com/anthropics/claude-quickstarts.git chapter9/claude-quickstarts
# 第 10 章 · 雙 Agent 架構(已獨立為 TalkAct 專案)+ 斯坦福 AI 小鎮
git clone https://github.com/19PINE-AI/TalkAct.git chapter10/use-computer-while-calling
git clone https://github.com/joonspk-research/generative_agents.git chapter10/generative_agents # 實驗 10-7 斯坦福 AI 小鎮
各專案 README 如標註了特定 commit,請按說明
git checkout到對應版本以保證復現一致。第 10 章use-computer-while-calling已發展為獨立維護的 19PINE-AI/TalkAct,本倉庫只保留指向它的說明文件。
其它復現路徑
下面這些實驗無專屬 clone 命令,但有特定的復現方式:
| 實驗 | 型別 | 說明 |
|---|---|---|
| 6-2 / 6-3 / 6-4 / 6-9 | 📝 讀者練習 | 人肉基準、記憶評估、JSON Cards vs RAG、記憶選型——改造複用第 3 章 user-memory / user-memory-evaluation / contextual-retrieval |
| 5-12 | 📝 讀者練習 | 能創造 Agent 的 Agent——基於 chapter5/coding-agent 自舉擴充套件 |
| 7-8 | 📝 讀者練習 | Prompt 蒸餾——落地實現見 chapter8/prompt-distillation(跨章複用) |
| 7-9 | 📝 讀者練習 | CoT 蒸餾 [擴充套件]——書中給出實驗設計與驗收標準,無專屬程式碼 |
| 6-11 | 🤖 模擬評估 | OpenVLA + RoboTwin2——VLA 訓練/環境依賴見 chapter7/SimpleVLA-RL 的 README |
| 9-8 / 9-9 | 🔧 真實硬體 | XLeRobot 遙操作與 LLM Agent 控制——需 SO-100 機械臂,Teleop · LLM Agent |
| 9-10 | 🔧 真實硬體 | RGB 零樣本 Sim2Real 抓取——StoneT2000/lerobot-sim2real(模擬可純 GPU,部署需 SO-100) |
🤝 貢獻
本書與配套程式碼全部開源,非常歡迎社群透過 Pull Request 參與共建:
| 型別 | 說明 |
|---|---|
| 📝 書籍內容改進 | 勘誤、補充、更清晰的表述,或新增前沿進展(正文見 book/chapter*.md) |
| 🐛 程式碼改進與 Bug 修復 | 讓配套專案更健壯、更易用、更貼近生產實踐 |
| 🧪 新的實踐專案 | 為某個實驗補充/替換更好的實現,或貢獻全新的示例專案 |
| 🎨 配圖設計改進 | 讓 book/images/ 中的圖表更清晰美觀(配圖由 book/gen_*_figs.py 生成) |
| 🌐 新語言翻譯 | 歡迎翻譯成更多語言,可參考中文繁體(book-zhtw/)、英文(book-en/)、泰米爾語(book-ta/)、越南語(book-vi/)的組織方式 |
提交前建議先把相關實驗親手跑一遍、確認可復現;也歡迎先提 issue 討論想法。
📄 許可證
本專案採用 Apache License 2.0 開源許可證,詳見 LICENSE 檔案。部分子專案可能包含各自的許可證資訊,請以子專案中的說明為準。
⭐ Star History
由 scripts/gen_star_history.py 生成,GitHub Actions 每日自動更新 · 點選圖片檢視即時資料