bojieli/ai-agent-book
《深入理解 AI Agent:设计原理与工程实践》(李博杰 著)开源主仓库:全书正文、编译版 PDF 与按章配套代码
這是什麼
bojieli/ai-agent-book 是《深入理解 AI Agent:設計原理與工程實踐》的開源主倉庫,內容包含全書正文、配圖、編譯版 PDF/EPUB,以及按章配置的實驗程式。README 用一句話定義全書主軸:Agent = LLM + 上下文 + 工具。它不是只談 prompt 的入門文章,而是把 Agent 從基礎概念一路拆到上下文工程、記憶與知識庫、工具與 MCP、Coding Agent、評估、後訓練、持續進化、多模態互動與多 Agent 協作。對想系統化理解 AI Agent 的讀者來說,這個 repo 更像一本可讀、可下載、也可跑實驗的工程教材。
為什麼上榜
週榜熱度非常明顯:目前 20,761 stars,本週新增 15,909 stars。它爆紅的原因,應該不只是「AI Agent」這個題材正熱,而是 README 展示的完整度很高:全書 10 章、92 個配套實驗,其中 70+ 可獨立執行,並提供中文、英文、正體中文、俄文、越南文、泰米爾文、日文等 7 種語言。同類資源常見問題是只講概念、缺少可復現程式,或只是一串零散 demo;這個專案則把閱讀、章節索引、程式碼與離線電子書整合在同一個倉庫,降低了學習與教學的組織成本。
適合誰,可以拿來做什麼
它最適合三類人:第一,是想從工程角度補齊 Agent 基礎的 LLM 開發者;第二,是正在設計 RAG、記憶、工具調用、MCP、Coding Agent 的團隊;第三,是需要課程教材或讀書會材料的技術社群。README 的章節安排很適合循序閱讀:先理解 Agent harness 與上下文,再進入知識庫、工具、評估與訓練,最後擴展到多模態和多 Agent。若只想找一個立即可部署的框架,這不是那種 repo;它的價值在於把原理、設計取捨與工程實驗放在一起,適合拿來建立判斷力。
上手
README 提供最直接的入口是下載 PDF/EPUB 或線上閱讀;若要自行編譯電子書,可使用倉庫裡的建置說明。它也提供自行編譯 PDF 的方式,但需要先安裝 pandoc、xelatex、ElegantBook 文件類與相關字型:
cd book && bash build_pdf.sh
若要跑部分章節的外部實驗,README 說明第 6、7、9、10 章有 19 個外部倉庫 未內置,需要依附錄命令 clone 到指定目錄;各章 README 若標註特定 commit,應切換到對應版本以維持復現一致。
README 重點摘要
- 全書以 Agent = LLM + 上下文 + 工具 為核心公式,10 章從基礎、上下文、記憶、工具一路講到多 Agent。
- 提供 PDF/EPUB 與線上閱讀;線上版支援多語切換、章節折疊、全文搜尋,且 main 分支推送後自動重新構建。
- README 標示共有 92 個配套實驗,70+ 可獨立運行,各章以「讀」與專案數量連到正文與程式碼。
- 第 6、7、9、10 章部分評測基準、訓練框架與機器人平台因體積與版權未內置,需要照附錄 clone 外部 repo。
- 專案採 Apache-2.0,歡迎內容勘誤、程式修復、新實驗、配圖改善與新語言翻譯等貢獻。