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 与文档入口 查看 GitHub 仓库 →

为什么值得关注

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

来源:官方 README 与文档入口

核心功能

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

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

来源:官方 README 与文档入口
每个模式配多框架可运行 notebook

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

来源:官方仓库
完整书稿 PDF + 7 个工程附录

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

来源:官方 README 与文档入口
覆盖前沿协议与安全主题

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

来源:官方仓库

技术架构

仓库不是软件工程项目,而是教学资料的组织结构:根目录放完整书 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 安装。

来源:官方 README 与文档入口

项目知识图谱

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

技术栈

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

快速上手

需 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 与文档入口

使用场景

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

来源:官方 README 与文档入口

优势与局限

优势

  • 体系化强:把零散的 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 与文档入口

最新版本

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

来源:官方 Releases

总结评价

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

来源:官方 README 与文档入口
资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-05-22 17:33.

参考材料:README、GitHub API、依赖文件