信息卡

一句话定位

这是李博杰撰写并完全开源的中文技术书《深入理解 AI Agent：设计原理与工程实践》主仓库，全书围绕核心公式"Agent = LLM + 上下文 + 工具"展开，包含十章正文与百余个配套实验，主张"Harness 工程才是竞争力"，从设计原理一路讲到工程实战，当前已迭代至 2.0 版本并支持 14 种语言翻译。

趋势解读：为什么火

AI Agent 从概念热炒进入落地深水区后，市场上极缺一套体系化、不贩卖焦虑又能量化动手的系统性教材。该书把课程级内容、可运行实验与工业界实战经验一次性开源，天然形成口碑传播；叠加国内 Agent 学习热潮与作者的行业影响力，月增超过两万星跻身趋势榜第五。

核心功能拆解

• 第一章：Agent 入门，建立核心公式与 Harness 工程观念。
• 第二章：上下文工程——KV Cache 原理、提示工程、Agent Skills 与上下文压缩。
• 第三章：用户记忆与知识库——跨会话记忆、RAG、结构化索引与知识图谱。
• 第四章：工具体系——MCP 协议、感知/执行/协作三类工具划分与主动工具发现。
• 第五章：Coding Agent 与通用 Agent，提出"代码是能创造新工具的工具"的论断。
• 第六章：交互空间扩展——异步事件驱动、语音交互、Computer Use 与机器人操作。
• 第七至十章：评估方法（SWE-bench、OSWorld、GAIA 等基准对比）、模型后训练三阶段选型（预训练/SFT/RL）、从运行轨迹持续进化，以及多智能体协作框架与上下文共享隔离策略。
• 实验体系：约百个实验分三类标注——✅ 本地可运行、📖 外部复现轨道、🚧 设计阶段，附录提供一键克隆映射外部仓库的脚本。

架构与技术栈浅析

正文以 Markdown 组织在各章目录下（如 chapter2/README.md），配图为 SVG；电子书构建链采用 pandoc + xelatex + ElegantBook 文档类；实验依赖由 pyproject.toml 按章节 extras 管理，涉及 vLLM、Unsloth、Playwright、Ollama 等组件；实验调用的模型平台覆盖 Kimi、智谱 GLM、DeepSeek、OpenRouter 等。

安装与环境要求

需要 Python 3.11–3.13，推荐使用 uv 配合锁文件按章节安装依赖；调用模型的实验需将 `.env.example` 复制为 `.env` 并配置对应 API Key。第 8 章部分组件要求 Python 3.12 以上。

uv sync --locked --extra ch1                      # 推荐：仅安装第一章依赖
uv sync --locked --extra ch2 --extra vllm         # 特殊 extra 合并在同一条命令
python -m pip install -e ".[ch1]"                 # 无 uv 时的 pip 替代方案

快速上手示例

uv run python chapter1/context/main.py            # 运行第一章上下文示例
python chapter1/context/main.py                   # pip 用户等价命令
cd book && bash build_pdf.sh                      # 本地构建 PDF 电子书
git clone https://github.com/SWE-bench/SWE-bench.git chapter7/SWE-bench   # 外部实验轨道

进阶使用要点

• 按章节 extras 安装可以避免拉起 vLLM/CUDA 这类重型依赖。
• 第 7 章实验复现请遵循附录锁定版本的克隆脚本，保证统计显著性结论可验证。
• 计划深入后训练方向需准备 GPU 环境（第 8 章 Unsloth/vLLM 实验）。
• 翻译版多由社区维护，以中文原版为最新事实源。

典型应用场景

• 自学体系课：照章顺序完成正文加实验，两周搭建完整 Agent 知识框架。
• 企业内训教材：直接采用章节结构授课，实验提供现成作业模板。
• 选型调研：参考第 7 章评估基准对比来决定生产环境的模型与技术栈。

同类生态位对比

相较 Hugging Face Agents Course 等英文课程偏框架教学，本书更强调原理推导与中国工程师熟悉的本土模型平台实践；相比零散博客文集，其完整的章节体系与百余个带状态标注的实验是最大差异化。

资源导航

• 仓库：https://github.com/bojieli/ai-agent-book
• 电子书构建脚本：book/build_pdf.sh