深入理解 AI Agent PDF（设计原理与工程实践 ）

深入理解 AI Agent PDF（设计原理与工程实践 ）

/~cf8f3ZsbbO~:/

链接：https://pan.quark.cn/s/babfe9c6f5e4

深入理解 AI Agent：设计原理与工程实践

一本围绕 Agent = LLM + 上下文 + 工具 核心公式展开的硬核开源书。10 章正文 + 94 个配套实验（可运行 / 复现 / 设计）+ 10 语言译本，从原理讲到生产级 Harness 工程与具身智能。

仓库地址：https://github.com/bojieli/ai-agent-book

许可证：Apache License 2.0

作者：李博杰（Pine AI 首席科学家）

核心公式

Agent = LLM（大脑：理解 / 推理 / 决策）
      + 上下文（眼睛：当前可见的 Prompt / KV Cache / 记忆 / 检索）
      + 工具（手脚：MCP / Bash / Browser / Code / 机器人执行器）

书中反复强调：模型之外的 Harness 工程（上下文调度、工具路由、评估、进化）才是 Agent 的竞争力分水岭。

内容速览（第 1--10 章）

章	主题	一句话核心	实验数
1	Agent 基础知识	Agent = LLM + 上下文 + 工具；Harness 工程才是竞争力	4
2	上下文工程	KV Cache、Prompt Engineering、Agent Skills、上下文压缩	9
3	用户记忆和知识库	跨会话记忆、RAG、结构化索引、知识图谱	13
4	工具	MCP 协议、感知/执行/协作类工具、异步事件驱动 Agent	7
5	Coding Agent 与代码生成	代码是"能创造新工具的工具"，生产级 Coding Agent 全景	12
6	Agent 的评估	评估环境、指标、统计显著性、评估驱动选型	11
7	模型后训练	预训练 / SFT / RL 三阶段，工具调用内化，样本效率	16
8	Agent 的持续进化	从轨迹中学习，更新知识 / 指令 / 程序 / 参数	8
9	多模态与实时交互	语音三范式、Computer Use、XLeRobot、Sim2Real 抓取	10
10	多 Agent 协作	上下文共享/隔离、协作框架、Agent 社会涌现	8

总计：10 章 · 94 实验（部分实验标注 ✅可运行 / 📖复现 / 🚧设计）。

阅读与下载

• 中文原版正文：book/chapter*.md

• 离线电子书（推荐）：PDF / EPUB 从 Release 或构建脚本生成

  • 中文 PDF / EPUB

  • 英文、繁中（台）、俄、日、韩、阿、越、泰米尔、土耳其由社区翻译，位于 book-en/ book-ar/ book-zhtw/ book-ru/ book-ja/ book-ko/ book-tr/ book-vi/ book-ta/

• 在线阅读：GitHub Pages（支持章节折叠、全文搜索、多语言切换，随 main 推送重建）

• 自行编译 PDF：需 pandoc + xelatex + ElegantBook

快速上手（跑通第一个实验）

# 1. 克隆
git clone https://github.com/bojieli/ai-agent-book.git
cd ai-agent-book

# 2. 准备 Python 环境（以 chapter1 为例）
cd chapter1
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt   # 若子目录无该文件，按各章 README 安装

# 3. 配置 API Key（任选其一，见下表）
cp .env.example .env
# 编辑 .env：填入 OPENAI_API_KEY / ZHIPU_API_KEY / DEEPSEEK_API_KEY 等

# 4. 跑最小 Agent Loop 示例
python agent_basic.py

推荐申请哪些 API Key

平台	链接	特色	适用节点
Kimi（月之暗面）	https://platform.moonshot.cn/	Kimi 系列，Coding/Agent 强	中国大陆
智谱 GLM	https://open.bigmodel.cn/	GLM-5.2，1M 上下文	中国大陆
SiliconFlow	https://siliconflow.cn/	DeepSeek/Qwen 等开源模型直连	中国大陆
DeepSeek	https://platform.deepseek.com/	DeepSeek-V4 推理/Agent	全球
Krill AI	https://www.krill-ai.com	中转 GPT/Claude/Gemini/国产模型，优惠码 ai-agent-book 享 Codex 套餐 77 折	全球+大陆
OpenRouter	https://openrouter.ai/	400+ 模型统一 OpenAI 兼容接口	全球

书中实验默认用 OpenAI 兼容 Base URL，把 .env 里的 BASE_URL 和 API_KEY 指向上述任一平台即可，无需改业务代码。

目录结构（简版）

ai-agent-book/
├── book/            # 中文正文 markdown
├── book-en/ book-ja/ ...   # 各语言译本
├── chapter1..10/    # 配套实验（含 README 标注可运行/复现/设计）
├── images/          # SVG 配图源文件
├── scripts/         # EPUB/PDF 统一构建脚本
├── LICENSE          # Apache-2.0
└── README.md

外部仓库与硬件轨道说明

第 6/7/9/10 章部分实验映射 20 个外部仓库（GAIA、OSWorld、SWE-bench、OpenVLA+RoboTwin2、XLeRobot、SimpleVLA-RL 等），不内置在本书源码里，需用附录一键克隆脚本拉取；机器人实机轨道（9-8 / 9-9 / 9-10）需授权硬件，阶段 1--4 可在仿真完成。

贡献方式

• 正文勘误 / 前沿补充 → 改 book/chapter*.md

• 代码 Bug 修复、新实验 → 对应 chapter*/ 提 PR（建议先跑通再提）

• 配图改进 → 改 images/*.svg

• 新语言翻译 → 参照 book-en/ 组织方式新建 book-xx/

一句话定位

不是"用 LangChain 搭个 Demo"的入门册子，而是把 上下文工程、工具协议、评估矩阵、后训练、持续进化、多模态与多 Agent​ 串成一条生产级链路的系统教材------适合面试官追着问"你的 Agent 为什么在生产里不崩"时，回去翻的那本书。

---