以配套 Notebook 组合 LangGraph、MCP、E2B 等工具，覆盖从 Agent 架构到安全执行与评估的完整实践方案

方案简介

本方案源自 O'Reilly 书籍《AI Agents - The Definitive Guide》的官方配套代码仓库。仓库按章节组织为一系列 Jupyter Notebook，每篇 Notebook 演示一组真实可运行的技术组合：从基础 LLM 到 Agent 的蓝图（第1章）、规划与多智能体架构（CoT、ToT、ReAct、HITL、层级团队、Swarms，第2章）、高级规划与可扩展执行（ART+RULER、TreeQuest/AB-MCTS，第3章）、模型能力与优化（第4章）、从原型到生产的可靠执行（Deep Agents、MCP with LangGraph、Pydantic 一致性，第5章）、安全执行与工具治理（A2A+MCP Governed、Composio MCP Server、LangGraph+E2B 沙箱，第6章）等。学习者无需本地搭建环境，通过 README 提供的 Colab 徽章链接即可在浏览器中一键运行任意章节代码。适合正在学习 AI Agent 工程化、希望看到各工具（LangGraph、MCP、E2B、Pydantic 等）如何组合落地的开发者。

亮点与能力

• 覆盖 CoT、ToT、ReAct、HITL 等核心 Agent 推理与交互模式
• 提供层级 Agent 团队与 Swarms 多智能体架构示例
• ART + RULER、TreeQuest (AB-MCTS) 等高级规划与可扩展执行示例
• Supervisor Agent Team 展示监督式多智能体编排
• Deep Agents、MCP with LangGraph 展示生产化工具集成
• Pydantic Agent Consistency 保证输出结构一致
• A2A + MCP Governed、LangGraph + E2B Sandbox 演示安全执行与工具治理
• 全部 Notebook 可在 Google Colab 直接打开运行

组成与分工

• Jupyter Notebook：每章代码的载体，按 ch01_attention_mechanism_variations.ipynb 命名规则组织
• Google Colab：云端运行环境，点击徽章即可免本地配置运行
• LangGraph：Agent 编排框架，用于多智能体与工具调用（第4-6章多个示例）
• MCP：工具协议，与 LangGraph、Composio、A2A 组合实现工具接入与治理
• E2B：沙箱执行环境，配合 LangGraph 实现安全的代码执行
• Pydantic：约束 Agent 输出一致性
• Composio：托管 MCP Server 的工具平台
• utils 目录：自定义类、函数与工具函数

前置要求

• 可访问 Google Colab 的浏览器（推荐方式）
• 或本地 Jupyter 环境（可自行 clone 仓库运行 Notebook）

本地使用时可克隆仓库：

git clone https://github.com/Nicolepcx/ai-agents-the-definitive-guide

仓库目录结构：

├── LICENSE
├── README.md <- The top-level README for developers using this project.
├── CH01 <- Per chapter folder with Jupyter notebooks.
├── [name].ipynb <- Jupyter notebooks with naming as mentioned above.
├── CH02 <- Per chapter folder with Jupyter notebooks.
... <- Same structure for all chapters.
├── utils <- Custom classes and functions and utility functions.
├── resources <- Some miscellaneous resources.

实施步骤

1. 选择章节与主题

根据目录确定学习主题，例如第2章的 ReAct：

• Chapter 2 — Architectures and Patterns: Planning, Reactivity, and Multi-Agent-Systems

2. 点击 Open In Colab 徽章

README 中每篇 Notebook 都附带 Colab 链接，例如 ReAct：

https://colab.research.google.com/github/Nicolepcx/ai-agents-the-definitive-guide/blob/main/CH02/ch02_react.ipynb

3. 在 Colab 中运行 Notebook

Notebook 按 ch01_attention_mechanism_variations.ipynb 规则命名，ch01 表示章节，后半部分描述内容。直接逐单元运行即可。

4. 结合书籍与社区深入

书籍可在 O'Reilly 或 Amazon 获取，配套网站提供测验与补充材料，也可加入 Discord 交流。

使用与配置要点

• 第5章生产化主题：Deep Agents、MCP with LangGraph、Product Reliability Rule、Pydantic Agent Consistency 四个 Notebook 分别对应可靠执行的不同侧面
• 第6章安全治理：A2A + MCP Governed、MCP Server with Composio、LangGraph + E2B Sandbox 展示沙箱化与工具治理
• 第3章高级规划：ART + RULER、RULER Cat Poems、TreeQuest (AB-MCTS)
• 第4章：Supervisor Agent Team
• 验证成功方式：Notebook 在 Colab 中顺利执行完毕即为跑通

注意事项与常见问题

• README 材料未提供依赖清单或 requirements 文件说明，Notebook 运行所需的 API 密钥等配置需在 Colab/书籍中确认
• 代码是书籍配套材料，脱离书籍单独阅读可能缺少上下文
• 部分章节文件夹为小写（如 ch06），与整体 CH 命名约定略有差异

优缺点

• ✓ 可直接在 Colab 打开运行
• ✓ 按章节组织代码结构清晰
• ✕ 需配合书籍理解背景
• ✕ README 未提供依赖清单

出处

本方案挖掘自开源项目 Nicolepcx/ai-agents-the-definitive-guide，方案内容与实施命令均来自其 README 原文。