Agentic-Design-Patterns 是什么?

这是 Antonio Gulli 所著《Agentic Design Patterns: A Hands-On Guide to Building Intelligent Systems》一书的官方配套仓库,本质是「书 + 可运行代码」的教学资料,而非一个软件产品。仓库收录全书完整 PDF(424 页)以及按章节组织的 Jupyter Notebook,系统讲解构建智能体系统的 21 种设计模式 + 7 个附录,从提示链、路由、并行、反思、工具调用、规划、多智能体,到记忆、MCP、A2A、护栏、评测等。作者将版税全部捐给 Save the Children。许可证标注为 Educational(教育用途),非标准开源协议。

⭐ 1,429 Stars 🍴 255 Forks Jupyter Notebook 作者: evoiz 商业引流:中
来源:README About/Table of Contents/License badge;仓库为 PDF + chapter_notebooks/*.ipynb 查看 GitHub 仓库 →

为什么值得关注

约半年累计 1.5k 星、273 fork,热度来自「权威作者 + 体系化 + 可直接跑」三点叠加:作者 Antonio Gulli 在 AI 工程圈有知名度,把分散的 agent 工程经验整理成 21 章成体系的「设计模式」,并对每个模式给出多框架(Google ADK、LangChain/LangGraph、CrewAI、OpenRouter、FastMCP、A2A)的可运行 notebook,恰好命中 2025-2026 年开发者急需一份「agent 工程方法论」的需求。版税捐慈善也提升了口碑传播。

来源:GitHub 1,509 stars / 273 forks,created 2025-09-21;README 作者/慈善说明

核心功能

21 种 agent 设计模式的体系化梳理

按四部分组织:核心模式(提示链/路由/并行/反思/工具调用/规划/多智能体)、进阶模式(记忆/学习适应/MCP/目标设定)、生产模式(异常恢复/人在回路/RAG)、企业模式(A2A 通信/资源优化/推理/护栏/评测/优先级/探索发现),形成可查阅的模式目录。

来源:README Table of Contents(Part One~Four,21 章)
每个模式配多框架可运行 notebook

同一模式常给出多种框架实现以便对比,例如路由章有 Google ADK / LangGraph / OpenRouter 三个 notebook,多智能体章有 ADK 的 Coordinator/Loop/Parallel/Sequential 与 CrewAI 版本,记忆章覆盖 ADK 多种状态管理与 LangGraph 版。

来源:tree(Chapter_02_Routing_*、Chapter_07_Multi_Agent_*、Chapter_08_Memory_* 等多实现)
完整书稿 PDF + 7 个工程附录

随仓库提供 424 页完整 PDF;附录覆盖高级提示技巧、从 GUI 到真实环境、Agentic 框架速览、AgentSpace 建 agent、CLI 上的 agent、推理引擎原理、编码 agent 等实战主题。

来源:README Repository Structure / Appendices;Agentic_Design_Patterns_Complete.pdf、Appendix_A~G.ipynb
覆盖前沿协议与安全主题

不止基础模式,还包含 MCP(含 FastMCP Server/Client 实现)、A2A 智能体间通信(AgentCard、同步/流式请求)、Guardrails 护栏(ADK 校验工具、LLM-as-Guardrail)、Evaluation(LLM-as-Judge)等较新的工程实践。

来源:tree(Chapter_10_MCP_*、Chapter_15_Inter_Agent_*、Chapter_18_Guardrails_*、Chapter_19_Evaluation_*)

技术架构

仓库不是软件工程项目,而是教学资料的组织结构:根目录放完整书 PDF(Agentic_Design_Patterns_Complete.pdf)与 README;chapter_notebooks/ 目录按「Chapter_NN_模式名_(框架/变体).ipynb」命名,一个模式对应一到多个 notebook,文件名即标注了所用框架(ADK/LangChain/LangGraph/CrewAI/OpenRouter)或实现变体(如 Reflection 的 Iterative_Loop / LangChain / ADK 三版)。附录以 Appendix_A~G 命名并列其中。这种「模式 → 多框架平行实现」的命名约定本身就是它的可用性设计:读者可按模式横向比较不同框架的写法。没有统一的 requirements/包结构,依赖在各 notebook 内按需 pip 安装。

来源:tree(根 PDF + chapter_notebooks 命名约定);README Repository Structure

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Google ADK LangChain / LangGraphLangChain / La… CrewAI OpenRouter FastMCP (MCP)FastMCP 21 种 agent 设计模式的体系化梳理21 种 agent 设计模式… 每个模式配多框架可运行 notebook每个模式配多框架可运行… 完整书稿 PDF + 7 个工程附录完整书稿 PDF + 7 个… 覆盖前沿协议与安全主题 Agentic-Design-Patte… 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言Jupyter Notebook (Python 3.8+)框架教学覆盖多套 agent 框架(非单一技术栈)
Google ADKLangChain / LangGraphCrewAIOpenRouterFastMCP (MCP)A2AOpenAI / Gemini / Vertex AIPydanticjupyter notebook
本地 Jupyter 运行;各 notebook 按需调用相应云模型 API(OpenAI/Google 等),无统一服务部署
来源:README Prerequisites/Installation;notebook 文件名标注的框架

快速上手

需 Python 3.8+。`git clone https://github.com/evoiz/Agentic-Design-Patterns.git && cd Agentic-Design-Patterns` → 建议建虚拟环境 `python -m venv venv && source venv/bin/activate` → `pip install jupyter notebook` 及各章所需库(如 openai、langchain 等,依 notebook 而定)→ `jupyter notebook` 后进入 chapter_notebooks/ 打开目标章节。注意各 notebook 大多需要对应的云模型 API key(OpenAI/Google/Vertex/OpenRouter),且仓库没有统一 requirements,依赖需按章自行补齐。也可直接阅读根目录的完整 PDF。
来源:README Getting Started / Running the Code

使用场景

适合:①想系统学习 agent 工程方法论、需要一份「设计模式速查表」的开发者;②在选型阶段想横向对比 ADK / LangChain / LangGraph / CrewAI 同一模式不同写法的工程师;③做 agent 教学、内训或读书会的讲师,可直接用书 + notebook 作教材。不适合:找开箱即用框架或生产级库的人——这是教学资料而非可依赖的运行时;也不适合对许可证有严格商用要求的团队(标注 Educational,非标准 OSS)。

来源:README What You'll Learn / License,结合资料性质推断

优势与局限

优势

  • 体系化强:把零散的 agent 工程经验整理成 21 章四大部分的模式目录,结构清晰、便于查阅
  • 可运行:每个模式都有 Jupyter notebook,且常给多框架平行实现,能直接跑、便于横向对比
  • 覆盖面广且较新:从基础模式到 MCP、A2A、Guardrails、LLM-as-Judge 评测等前沿工程主题都有
  • 权威 + 公益:作者业内知名,全书 PDF 随附,版税捐 Save the Children,口碑与可信度较高
  • 学习友好:以模式为单位组织,初学者可按需切入,不必读完全书

局限

  • 是教学资料而非软件:没有可安装的包、没有统一 requirements,依赖需按 notebook 自行补齐,工程上不可直接复用
  • 许可证为非标准的 Educational,仅限教育用途,商用/二次分发边界不清晰
  • 随附完整书 PDF 的版权处置较特殊(书在 Amazon 预售),引用/再分发需谨慎
  • 多 notebook 依赖云模型 API key 且偏向 Google 生态(ADK/Gemini/Vertex 出现频繁),跑通有一定成本和门槛
  • 更新节奏偏慢(最近 push 2026-02),框架迭代快,部分 notebook 可能与最新 SDK 版本脱节
来源:README License/结构;tree;pushed_at 2026-02-12

最新版本

仓库无正式 GitHub Release,以书稿章节和 notebook 形式维护;最近一次更新在 2026-02-12。书本身在 Amazon 处于预售状态(README 顶部 Pre-order 徽章),仓库内容随书定稿同步。

来源:GitHub 无 releases;pushed_at 2026-02-12;README Pre-order 徽章

总结评价

这是一份质量和体系都相当扎实的 agent 工程「教科书 + 代码」,把当下分散的智能体设计经验归纳成 21 种模式并配多框架可运行示例,对想建立 agent 工程方法论的开发者价值很高,配合捐慈善的定位也容易获得好感。但要分清它的性质:它是学习资料而非可依赖的库,许可证仅限教育用途,且不少示例偏 Google 生态、需要付费 API。把它当作「系统学习与选型对照的参考书」非常合适,但不要期望从中直接拿走可上生产的代码。

来源:综合 README 定位/许可证、tree 结构、更新状态的事实判断

常见问题

Agentic-Design-Patterns 是什么?

这是 Antonio Gulli 所著《Agentic Design Patterns: A Hands-On Guide to Building Intelligent Systems》一书的官方配套仓库,本质是「书 + 可运行代码」的教学资料,而非一个软件产品。

Agentic-Design-Patterns 有哪些核心功能?

Agentic-Design-Patterns 的核心功能包括:21 种 agent 设计模式的体系化梳理、每个模式配多框架可运行 notebook、完整书稿 PDF + 7 个工程附录、覆盖前沿协议与安全主题。

Agentic-Design-Patterns 为什么最近很受关注?

约半年累计 1.5k 星、273 fork,热度来自「权威作者 + 体系化 + 可直接跑」三点叠加:作者 Antonio Gulli 在 AI 工程圈有知名度,把分散的 agent 工程经验整理成 21 章成体系的「设计模式」,并对每个模式给出多框架(Google ADK、LangChain/LangGraph、CrewAI、OpenRouter、FastMCP、A2A)的可运行 notebook,恰好命中 2025-2026…

Agentic-Design-Patterns 适合哪些使用场景?

适合:①想系统学习 agent 工程方法论、需要一份「设计模式速查表」的开发者;②在选型阶段想横向对比 ADK / LangChain / LangGraph / CrewAI 同一模式不同写法的工程师;③做 agent 教学、内训或读书会的讲师,可直接用书 + notebook 作教材。

透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-22 17:33. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件