AI Agents 权威指南(配套代码库)
O'Reilly 图书《AI Agents - The Definitive Guide》的官方配套代码库,用十二章可运行的 Jupyter 笔记本覆盖从 LLM 到生产级智能体的完整学习路径。
- Star 数
- ★ 2.9k
- 最近更新
- 3 个月前
- 主语言
- Jupyter Notebook
- FA 评分
- 34/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 工程师阅读本书时,想在 Colab 中逐章运行配套代码来验证 ReAct、层级团队、Swarms 等架构模式的实际行为。
- 不适合
- 希望直接部署成品Agent产品的团队,本仓库只是教学代码
- 不愿注册E2B、Composio、Langfuse、LangSmith等付费或需注册服务的读者
- 官网
- oreilly.com ↗ 来自 GitHub 仓库设置
- 维护状态
- 近半年有提交最近提交 2026-08-01近 7 天每天 +7.7 ★
这个 Agent 能做什么,适合哪些场景?
这是 O'Reilly 图书《AI Agents - The Definitive Guide》的配套代码仓库,按章节组织为 CH01 到 CH12 的 Jupyter 笔记本合集。每章对应书中的一个主题,从 LLM 基础、架构模式(CoT、ToT、ReAct、多智能体团队、Swarms),到高级规划与推理、生产化部署、安全执行与工具治理、评估与可观测、智能体记忆、成本优化,直至威胁建模。所有笔记本均提供 Google Colab 一键运行徽章,无需本地配置即可上手。仓库还包含 utils 工具目录、resources 资源目录,并配套书籍网站(含测验)和 Discord 社区。它定位为学习与参考资源,而非可部署的智能体产品。
仓库提供约三十多个按章节命名的 Jupyter 笔记本(如 ch02_CoT.ipynb、ch03_TreeQuest.ipynb、ch06_MCP_server_composio.ipynb),每个演示一个具体技术点:Ch02 演示思维链、思维树、ReAct、人机协同(HITL)、层级智能体团队与 Swarms;Ch03 演示 ART+RULER 和 TreeQuest(AB-MCTS);Ch05 演示 Deep Agents、MCP with LangGraph 和 Pydantic 智能体一致性;Ch06 演示 A2A+MCP 治理、Composio MCP 服务器、LangGraph+E2B 沙箱和程序化工具调用(Monty);Ch07 演示推理后端与模型回退;Ch08-Ch09 演示评估框架、OWASP ASI 2026、Langfuse 与 LangSmith 评估流水线;Ch10 演示 LangGraph 智能体记忆与记忆拓扑;Ch11 演示按拓扑估算智能体成本、GPU 显存与吞吐需求;Ch12 演示 LlamaFirewall。代码依赖 LangChain/LangGraph 生态,并调用 E2B、Composio、Langfuse、LangSmith、LlamaFirewall 等第三方服务。
- 工程师阅读本书时,想在 Colab 中逐章运行配套代码来验证 ReAct、层级团队、Swarms 等架构模式的实际行为。
- 团队准备将智能体原型推向生产,参考 Ch05-Ch07 的笔记本学习 Pydantic 一致性校验、模型回退和推理后端选型。
- 安全团队需要为智能体系统做威胁建模和工具治理,参考 Ch06 的 MCP 治理与 E2B 沙箱示例以及 Ch12 的 LlamaFirewall 笔记本。
- 平台团队构建智能体评估体系,参考 Ch08-Ch09 的评估框架、OWASP ASI 2026 以及 Langfuse/LangSmith 评估流水线示例。
- 技术负责人评估智能体系统的算力与成本,使用 Ch11 的成本估算器和 GPU 显存/吞吐笔记本做容量规划。
- 研究者对比记忆拓扑对智能体行为的影响,运行 Ch10 的记忆相关实验笔记本。
如何安装或部署这个 Agent?
无需本地安装即可运行:仓库中每个笔记本都有「Open In Colab」徽章,点击后直接在 Google Colab 中打开。若本地运行,克隆仓库 git clone https://github.com/Nicolepcx/ai-agents-the-definitive-guide,安装 Jupyter 以及各笔记本所需的依赖(README 未提供 requirements.txt 或具体版本清单),并在笔记本中配置所需 LLM 供应商及第三方服务(E2B、Composio、Langfuse、LangSmith 等)的 API 密钥。
如何使用这个 Agent?
- 打开 README 中目标章节的表格,点击对应笔记本的 Colab 徽章(例如 Ch02 的 ch02_react.ipynb);2. 在 Colab 中按笔记本内的说明填入 API 密钥;3. 顺序执行单元格观察输出。笔记本按 CH 编号+主题命名,代码结构上依赖仓库 utils 目录中的自定义类与函数。建议先运行 Ch01 的 ch01_code_examples.ipynb 打基础,再按需深入后续章节。
这个 Agent 有哪些优点和局限?
- 与正式出版的 O'Reilly 图书一一对应,十二章结构覆盖从基础到威胁建模的完整智能体工程知识体系。
- 全部笔记本提供一键 Colab 运行,零本地配置即可复现书中示例。
- 示例紧跟生态前沿,涵盖 MCP、A2A、Deep Agents、E2B 沙箱、LlamaFirewall、OWASP ASI 2026 等近期协议与工具。
- 配套书籍网站(测验与补充材料)和 Discord 社区,便于深入学习和提问。
- 这是教学代码库而非可部署产品,没有统一的安装依赖清单或版本锁定,本地复现需要自行解决依赖问题。
- 大量笔记本依赖第三方付费或注册服务(E2B、Composio、Langfuse、LangSmith 等),完整跑通会产生账号和密钥管理成本。
- 仓库许可信息在元数据中未标明,商用或内部培训复用前需确认 LICENSE 文件的实际条款。
- 部分代码与快速演进的 LangChain/LangGraph API 强耦合,随生态升级可能出现笔记本失效需要适配。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| AI Agents 权威指南(配套代码库) 当前 | 34 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 2.9k | 3 个月前 | Jupyter Notebook | — |
| AI Agent 工程学习手册 | 60 · 存在缺口 | 开发框架免费 | ★ 669 | 19 天前 | HTML | — |
| Agent Systems Handbook | 62 · 存在缺口 | 网页应用免费 | ★ 313 | 27 天前 | MDX | — |
| LangChain 生成式 AI 实战 | 41 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 1.5k | 3 个月前 | Jupyter Notebook | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
README 将仓库描述为按章节组织的代理示例,并列出 HITL、工具治理、安全执行和威胁建模等主题,但未展示具体权限范围、敏感数据处理、外部副作用确认、依赖安全或恢复机制;因此这些项仅因主题或基本说明得 1 分,回滚机制无证据得 0 分。README 给出书籍及配套网站、Discord 的出处线索,但未提供明确代码来源或维护者身份,来源归属得 1 分。
README 给出章节结构和示例目录,足以部分说明产品构成;但样本中没有代码、依赖清单、错误处理或故障信息,故自洽性和依赖可用性仅得 1 分,失败信息得 0 分。
十二章目录涵盖从基础模式、生产部署到评估、记忆、成本和威胁建模,受众场景覆盖较广,得 2 分;README 未清楚界定示例能力边界,得 1 分。按章节及 notebook 主题的说明使触发和选择示例相对明确,得 2 分;运行说明主要指向 Google Colab,没有给出本地或其他环境要求,环境适配得 1 分。
README 提供目录、章节映射和 notebook 命名说明,信息架构得 2 分;Colab 徽章提供有限的启动指引,安装说明得 1 分。命名规则有说明但样例大小写和目录形式并不完全统一,得 1 分。章节索引和代码示例目录有实用性,但没有 FAQ,得 2 分。未见已知限制、许可证正文、版本或变更记录;LICENSE 仅在结构示意中出现,许可证得 0 分。README 未明确维护责任人或更新路径,维护责任得 1 分。
章节索引、notebook 标题和 Colab 链接使读者较容易定位并打开示例,输出可用性得 2 分。覆盖多种代理模式及部署、治理、评估等主题,相较于单一示例集具有一定增量价值,得 2 分;但没有运行成本、资源需求的总体说明,成本收益判断仅得 1 分。
README 对书籍、章节和 notebook 的对应关系提供部分可追溯说明,主张可追溯性得 1 分;提供的样本只有 README,缺少代码或测试等独立来源交叉印证,得 0 分。README 将仓库描述为书籍配套代码并列出目录,但没有区分示例说明、经过验证的能力及其限制,事实与推断区分得 1 分。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- 本评估只依据提供的 README 样本;未提供的文件视为未知,未声称运行或独立验证任何 notebook。
- README 虽列出 LICENSE 文件,但未给出其内容;使用和再分发条件无法从本材料确认。
- Colab 链接指向仓库的 main 分支,而评估对象是固定修订;这些链接本身不能证明该修订的内容或可运行性。
常见问题
AI Agents 权威指南(配套代码库) 官网是什么?
AI Agents 权威指南(配套代码库) 免费吗?
AI Agents 权威指南(配套代码库) 开源吗?
AI Agents 权威指南(配套代码库) 安全吗?
AI Agents 权威指南(配套代码库) 还在维护吗?
AI Agents 权威指南(配套代码库) 是谁开发的?
谢谢反馈,我们会据此改进页面。