ai-agents-the-definitive-guide README

The project's README from github.com/Nicolepcx/ai-agents-the-definitive-guide. As one markdown file: README.md.

⭐ If you find this repository helpful, please consider giving it a ⭐ here on GitHub (click the star button in the top right corner) It's a quick way to show support for this openly available code. ⭐

OReilly_logo_rgb.png

AI Agents - The definitive Guide

This is the corresponding code for the book AI Agents - The Definitive Guide the book can be found here and on Amazon. The book has an accompanying website with quizzes and additional material, as well as a Discord channel.

TOC

Instructions and Navigation

All of the code is organized into folders. Each folder starts with CH followed by the chapter number. For example, CH01. The notebooks are then organized as follows: ch01_attention_mechanism_variations.ipynb, where ch01 indicates the chapter and attention_mechanism_variations what is done in the notebook.

Repo structure

├── 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.

Running the Notebooks

Every notebook can be opened and run on Google Colab directly from the links below. Just click the Open In Colab badge next to the notebook you want to run.

Chapter 1 — From LLMs to Agents: The Foundational Blueprint

Notebook Colab
Code Examples Open In Colab

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

Notebook Colab
Chain-of-Thought (CoT) Open In Colab
Tree-of-Thought (ToT) Open In Colab
ReAct Open In Colab
Human-in-the-Loop (HITL) Open In Colab
Hierarchical Agent Teams Open In Colab
Swarms Open In Colab

Chapter 3 — Advanced Planning, Reasoning, and Scalable Execution in Agents

Notebook Colab
ART + RULER Open In Colab
RULER Cat Poems Open In Colab
TreeQuest (AB-MCTS) Open In Colab

Chapter 4 — Models Behind the Agents: Capabilities and Optimization

Notebook Colab
Supervisor Agent Team Open In Colab

Chapter 5 — From Prototypes to Production: Contracts, Tools, and Reliable Execution

Notebook Colab
Deep Agents Open In Colab
MCP with LangGraph Open In Colab
Product Reliability Rule Open In Colab
Pydantic Agent Consistency Open In Colab

Chapter 6 — Secure Execution and Tool Governance

Notebook Colab
A2A + MCP Governed Open In Colab
MCP Server with Composio Open In Colab
LangGraph + E2B Sandbox Open In Colab
Programmatic Tool Calling (Monty) Open In Colab

Chapter 7 — Deploying Agents in Real Products

Notebook Colab
Hardening Backbone Open In Colab
Inference Backends Open In Colab
Model Fallback Open In Colab

Chapter 8 — Foundational Evaluation and Operational Observation of Agentic Systems

Notebook Colab
OWASP ASI 2026 Open In Colab
Evaluation Harness Open In Colab

Chapter 9 — Customized and Advanced Evaluation of Agentic Systems

Notebook Colab
AgentVista Open In Colab
External Evaluation Pipelines (Langfuse) Open In Colab
External Evaluation Pipelines (LangSmith) Open In Colab
RULER Trace Answer Ranking (LangSmith) Open In Colab

Chapter 10 — Agent Memory: How Persistence Turns Agents Into Evolving Systems

Notebook Colab
Agent Memory with LangGraph Open In Colab
Memory vs. No Memory Open In Colab
Memory Topologies Open In Colab

Chapter 11 — From Compute to Cost: Designing Efficient Agentic Systems

Notebook Colab
Agent Cost Estimator by Topology Open In Colab
Memoizing Swarm Research Engine Open In Colab
Memory Footprint, Throughput & GPU Requirements Open In Colab

Chapter 12 — Threat Modeling for AI Agents

Notebook Colab
LlamaFirewall Open In Colab

ai-agents-the-definitive-guide (Nicolepcx/ai-agents-the-definitive-guide)

Searching Database…

2.8K ·GitHub
Ai-agents-the-definitive-guide
这是什么？它是《AI Agents - The Definitive Guide》一书的配套代码仓库：一组可以直接运行的 Jupyter 笔记本，逐章讲解全书内容，从基础的智能体模式一直讲到生产环境部署和威胁建模。
这是要安装到项目里的库，还是别的东西？都不是——它是一组 Jupyter 笔记本，每个章节一个文件夹（CH01-CH12），文件名类似 ch01attentionmechanismvariations.ipynb。这些笔记本是用来运行的，不是用来安装的。
我具体怎么运行其中一个笔记本？README 里的每个笔记本都有 'Open In Colab' 徽章——点一下，笔记本就会直接在 Google Colab 上打开并运行，本地不需要任何配置。
我是不是得已经在开发智能体才能看懂这些内容？内容从基础讲起——第 1 章从大语言模型讲到智能体——然后逐步深入到生产部署、评估和威胁建模，目标是帮助开发者把智能体从原型做成真正的系统。
除了代码，这本书还附带其他东西吗？有。这本书有一个配套网站，上面有测验和额外资料，还为读者提供了 Discord 频道。
这些笔记本用了哪些框架和工具？全书贯穿使用 LangChain 和 LangGraph，笔记本里还涉及 Pydantic、MCP、Composio、E2B 沙箱、Monty 程序化工具调用、Langfuse、LangSmith 和 LlamaFirewall。
完全没接触过智能体的人应该从哪里开始？从第 1 章 'From LLMs to Agents: The Foundational Blueprint' 开始，然后看第 2 章的笔记本（CoT、ToT、ReAct、HITL、智能体团队、群体智能）——各章节是按阅读顺序循序渐进的。
What are similar projects?ai-system-design, agents-towards-production, adk-python, GenAI_Agents, spring-ai-alibaba, PocketFlow, Agentlas-OS, all-agentic-architectures
Which topics is it in?benchmarks, production, evaluation-framework, pydantic, cost-optimization, owasp, a2a, tracing, langgraph, llm-evaluation, ai-security, reasoning
Creator
Nicolepcx
Size
1.8 MB
Stars
2.8K
Updated
CommitAug 01
Age
1y
Commits · 90 Days