bojieli/ai-agent-book

这是什么？

核心功能

• 01十章内容覆盖上下文工程、记忆与 RAG、MCP 工具、Coding Agent 和多 Agent 协作。
• 02按章组织的 109 个配套实验，每个都是可运行的 Python 项目。
• 03提供 PDF 与 EPUB 电子书下载，并有在线阅读版本。
• 04中文正文以 Markdown 和 SVG 图表形式开源，附带构建脚本。
• 05社区贡献了十余种语言的译本。

适用场景

• 希望系统理解 AI Agent 设计原理的开发者。
• 想按章节实践、从零搭建 Coding Agent 的工程师。
• 需要为 Agent 建立评估集并针对失败案例改进的团队。
• 偏好边读书边跑代码的中文技术读者。

快速上手

1. 1

   用 uv 安装第一章依赖（需 Python 3.11–3.13）

   uv sync --locked --extra ch1
2. 2

   将 .env.example 复制为 .env，并填入至少一个模型提供商的 API Key

3. 3

   在仓库根目录运行第一章的实验

   uv run python chapter1/context/main.py

使用前须知

• !大多数实验需要调用大模型提供商，需要自备 API Key，且可能需要付费。
• !部分实验需要浏览器、CUDA、FFmpeg、Ollama 等系统依赖，第八章部分组件需要 Python 3.12+。
• !配套实验中的部分外部仓库需要手动克隆到对应目录。

标签

常见问题

ai-agent-book 是什么？

开源免费的 AI Agent 设计原理与工程实践中文书，配有 109 个可运行实验与 PDF/EPUB 电子书。 本仓库是《深入理解 AI Agent：设计原理与工程实践》的开源主仓库，收录全书正文、配图、编译脚本以及按章配套的实验代码。全书以“Agent = LLM + 上下文 + 工具”为核心框架，用十章从原理讲到工程，内容涵盖上下文工程、用户记忆与 RAG、基于 MCP 的工具使用、Coding Agent、语音与 Computer Use 等交互方式、评估、模型后训练、持续进化以及多 Agent 协作。

ai-agent-book 可以免费使用吗？用的什么许可证？

ai-agent-book 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

ai-agent-book 还在维护吗？

活跃维护中。ai-agent-book 最近一次提交是在 2026年10月8日。

ai-agent-book 适合用来做什么？

希望系统理解 AI Agent 设计原理的开发者。 想按章节实践、从零搭建 Coding Agent 的工程师。 需要为 Agent 建立评估集并针对失败案例改进的团队。 偏好边读书边跑代码的中文技术读者。

ai-agent-book 怎么安装和运行？

用 uv 安装第一章依赖（需 Python 3.11–3.13）: uv sync --locked --extra ch1 将 .env.example 复制为 .env，并填入至少一个模型提供商的 API Key 在仓库根目录运行第一章的实验: uv run python chapter1/context/main.py

在哪里获取 ai-agent-book？

源代码和安装说明在 GitHub 上：https://github.com/bojieli/ai-agent-book