bojieli/ai-agent-book

项目概览

该项目将系统性的 Agent 教学文本与经过实际验证的可运行代码示例相结合，解决了在学习 AI Agent 时理论与实践脱节的问题，并提供了异步事件驱动智能体及 MCP 服务器等前沿主题的配套实现。

项目类型

MCP · AI Agent · RAG 与知识库

应用场景

学习教育

部署方式

查看项目说明

License

Apache-2.0

适合谁

• 需要系统学习 AI Agent 设计原理并希望获得经过验证的配套可运行代码的开发者和 AI 工程师。
• 正在研究事件驱动的异步智能体或模型上下文协议（MCP）底层实现的开发人员。

核心能力

• 提供 AI Agent 书籍的全文文本，包含中文、英文和泰米尔文 PDF 版本，并提供 Markdown 格式的源代码。
• 提供按章节组织的代码示例（如搜索智能体、上下文消融和编程智能体），这些示例配置为通过 API Key 即可独立运行。
• 演示如何使用 vLLM 或 Ollama 进行跨平台的本地大语言模型部署，并提供工具调用（tool calling）支持。
• 提供使用模型上下文协议（Model Context Protocol）构建的感知、执行和协作类 MCP 服务器示例。
• 提供事件驱动的异步智能体演示，具备收件箱事件队列、并行工具执行以及中断功能。

限制与风险

• 书中的部分复现指南依赖于外部代码仓库，用户必须单独克隆这些外部仓库才能完成复现。
• 运行配套的演示代码需要外部大语言模型的 API Key，这可能会为用户带来实际的费用开销。

如何开始

• 设置过程具有中等难度。用户需要克隆仓库并进入特定的章节目录（如 chapterN/project-name），配置 API Key 后通过 Python 运行项目。部分复现指南需要单独克隆外部仓库及依赖，若需自行构建 PDF 书籍则需安装 pandoc 和 LaTeX。

核验依据

• README: 本仓库是《深入理解 AI Agent：设计原理与工程实践》一书的开源主仓库，包含**全书正文**与**配套示例代码**。全书正文、配图与配套实验代码全部开源，欢迎把实验亲手跑一遍、提 issue 和 PR。
• README: 中文 PDF（原版）：book/深入理解-AI-Agent-李博杰-v1.1.pdf
• README: 全书提供中英双语版本： - **中文 PDF（原版）**：[`book/深入理解-AI-Agent-李博杰-v1.1.pdf`](book/深入理解-AI-Agent-李博杰-v1.1.pdf) - **英文 PDF**（社区贡献翻译，by [@nsdevaraj](https://github.com/nsdevaraj)）：[`book-en/AI-A…
• README: 所有项目按**章节**组织，与全书十章一一对应，涵盖从基础概念到高级技术的完整学习路径，目录为 chapterN/项目名/。第 5、8、9、10 章的绝大多数实验现均提供可独立运行的配套 demo，并已对接真实 LLM API 验证跑通。
• README: ✅ **可独立运行**：本仓库自带完整代码，配置好 API Key（见文末）即可运行。

内容核验时间：