《深入理解 AI Agent：设计原理与工程实践》开源仓库
以“Agent = LLM + 上下文 + 工具”为核心，提供 10 章全本书籍、95 个配套实验与多语言版本，覆盖从原理到生产实战的 AI Agent 系统学习路径。
- Star 数
- ★ 55k
- 最近更新
- 19 天前
- License
- Apache-2.0
- 主语言
- Python
- FA 评分
- 41/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 想系统学习 AI Agent 原理与工程实现的开发者，可通过阅读 10 章正文与运行配套实验，从基础到生产逐步掌握。
- 不适合
- 只想读书、不想动手跑代码的读者
- 没有 GPU 却想跑第 8 章后训练实验的团队
这个 Agent 能做什么，适合哪些场景？
这是李博杰所著《深入理解 AI Agent》一书的官方开源仓库，包含 10 章完整正文、编译版 PDF/EPUB、以及 95 个按章配套的代码实验。全书围绕“Agent = LLM + 上下文 + 工具”核心公式，依次讲解基础概念、上下文工程、用户记忆与知识库（RAG）、工具与 MCP、Coding Agent、评估、模型后训练（SFT/RL）、持续进化、多模态交互与多 Agent 协作。仓库提供中文原版及 12 种社区翻译版本（英文、西语、印尼语、阿语、繁中等），并支持在线阅读和多语言切换。实验统一支持 Python 3.10+，使用 uv 或 pip 安装依赖，部分实验需要 API Key 或本地 Ollama。
该仓库主要提供书籍阅读与实验运行能力：读者可在线阅读或下载 PDF/EPUB；按章阅读 Markdown 正文（如 book/chapter1.md）；运行 95 个配套实验，示例命令为 uv run python chapter1/context/main.py。实验涵盖了上下文压缩、KV Cache、RAG、知识图谱、MCP 工具调用、Coding Agent（如 SWE-bench）、评估基准（如 GAIA）、模型后训练（MiniMind、verl）、多模态（浏览器自动化、机器人）、多 Agent（TalkAct、斯坦福 AI 小镇）等场景。仓库还提供一键克隆脚本，用于获取外部仓库（如 android_world、OSWorld）作为实验依赖。运行时需按章节安装依赖（如 uv sync --locked --extra ch1），并在 .env 中配置 API Key（如 Kimi、GLM、DeepSeek）。
- 想系统学习 AI Agent 原理与工程实现的开发者，可通过阅读 10 章正文与运行配套实验，从基础到生产逐步掌握。
- 需要实践上下文工程（如 KV Cache、上下文压缩）的算法工程师，可运行第 2 章的 9 个实验项目。
- 构建 RAG 或知识库应用的开发者，可参考第 3 章的用户记忆、结构化索引、知识图谱示例。
- 接入 MCP 协议或开发工具调用的工程师，第 4 章提供了 7 个实验，含事件驱动异步 Agent。
- 研究 Coding Agent 的开发者，第 5 章结合 SWE-bench 等基准提供 13 个实验，覆盖代码生成场景。
- 进行模型后训练（SFT/RL）的研究人员，第 7 章提供 16 个实验，使用 MiniMind、verl、unsloth 等框架。
如何安装或部署这个 Agent？
克隆仓库：git clone https://github.com/bojieli/ai-agent-book.git；建议安装 uv（见官方文档）。安装依赖：在仓库根目录运行 uv sync --locked --extra ch1（替换 ch1 为对应章节）。若不用 uv，可用 python -m pip install -e ".[ch1]"。浏览器、CUDA、FFmpeg 等系统依赖需按实验 README 自行安装。
如何使用这个 Agent？
阅读：可在线访问 bojieli.github.io/ai-agent-book 或下载 PDF/EPUB（Releases）。运行实验：配置 .env（复制 .env.example 并填入至少一个 API Key），然后从根目录运行，例如 uv run python chapter1/context/main.py。部分实验需额外克隆外部仓库（见附录克隆脚本）。
这个 Agent 有哪些优点和局限？
- 全面覆盖 AI Agent 领域：从原理到工程实践，10 章内容系统且深入，包含 95 个可运行实验。
- 多语言支持：提供 13 种语言版本（含社区翻译），并支持在线阅读与多语言切换，方便非中文读者。
- 开源免费：Apache-2.0 许可，正文、配图、代码全部开放，可自由学习与改进。
- 配套实验丰富：涵盖 RV、上下文工程、RAG、MCP、Coding Agent、评估、后训练、多模态、多 Agent 等，适合动手实践。
- 依赖外部 API：运行实验需要至少一个模型提供商的 API Key（如 OpenAI、Kimi、GLM 等），可能产生费用和网络依赖。
- 环境配置复杂：需安装 uv 或 pip、Python 3.10+，部分实验需额外安装浏览器、CUDA、FFmpeg 等系统依赖，且不同章节依赖互不兼容（需按章安装）。
- 外部仓库依赖：多个实验需要克隆第三方仓库（如 SWE-bench、GAIA），且需固定 SHA 版本，增加安装步骤。
- 社区翻译可能滞后：非中文版本可能落后于中文原版，内容更新不同步。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| 《深入理解 AI Agent：设计原理与工程实践》开源仓库 当前 | 41 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 55k | 19 天前 | Python | — |
| Haystack | 52 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 27k | 今天 | Python | OpenAI API |
| Hello-Agents 智能体教程 | 54 · 缺口较多 | 网页应用免费 + 模型费 | ★ 84k | 5 天前 | Python | OpenAI API |
| mu 编程助手 | 77 · 表现良好 | 桌面应用免费 + 模型费 | ★ 525 | 3 天前 | TypeScript | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示这是一个书籍仓库，包含代码示例和构建脚本，没有明显的恶意行为。但作为Agent产品，没有权限管理、用户确认、数据流透明性、敏感数据处理、依赖安全、外部影响、回滚或来源归属的文档或实现。因此所有信任标准得分为0。
自一致性：pyproject.toml中的依赖和章节聚合与README和代码注释一致，构建工作流也相互协调，得2分。依赖可用性：提供了uv.lock和依赖解析工作流，但未验证锁文件是否完整，得2分。失败消息：构建脚本中有错误处理，但缺少面向用户的失败消息文档，得1分。
受众和场景：README和章节说明明确了目标读者和场景，得2分。能力边界：章节聚合和可选依赖定义了能力范围，得2分。触发精度：构建工作流有明确的触发条件，但Agent触发机制不明确，得1分。环境适配：支持多平台和Python版本，得2分。
信息架构：目录结构清晰，章节和代码组织良好，得2分。安装说明：提供了详细的安装指南和依赖分组，得2分。命名稳定性：版本号在构建脚本中硬编码，但未明确命名策略，得1分。示例和FAQ：有测试脚本和示例，但缺少FAQ，得2分。已知限制：在pyproject.toml中注释了依赖冲突和平台限制，得2分。许可证：Apache-2.0许可证文件存在，得2分。版本变更日志：未发现CHANGELOG，得1分。维护责任：有GitHub Actions和问题跟踪，但未明确维护者，得1分。
输出可用性：构建产物（PDF/EPUB）和代码示例可直接使用，得2分。边际价值：作为书籍配套代码，提供了实际可运行的示例，得2分。成本效益：依赖分组和可选安装降低了使用成本，得2分。
声明可追溯性：README和代码注释引用了具体章节和功能，得2分。跨来源佐证：构建工作流和测试脚本相互印证，但缺乏外部验证，得1分。事实与推断分离：代码注释区分了事实和推断，得2分。
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 源码中未见：来源归属可核验从官方仓库或包源安装，核对发布者和仓库地址，避免同名仿冒包。
- 该仓库是书籍配套代码，并非完整的Agent产品，因此信任相关标准无法评估。
- 依赖安全未验证，建议检查uv.lock和依赖来源。
- 未提供用户确认或数据流透明性机制，若用于实际Agent部署需谨慎。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
Always-fresh PDF and EPUB builds from the latest main branch, rebuilt automatically on every book-content change. Assets are overwritten in place, so these download URLs are stable. - 简体中文: [PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-zh-CN.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-zh-CN.epub) …在 GitHub 查看 ↗
常见问题
运行实验需要多少钱？
是否需要 GPU？
all extra，但不包含本地训练栈，可按需安装特殊 extra（如 vllm、unsloth）。