Agentic-Design-Patterns 是一本关于构建智能AI智能体系统的实践指南，包含了完整的PDF书籍和配套的Jupyter代码笔记本，用于学习和实践各种智能体设计模式。

以下是一份详细的部署和使用教程。

📋 部署前准备

  1. 核心依赖:
    • Python: 版本 3.8 或更高。
    • Git: 用于克隆仓库。
  2. Python包:
    • Jupyter Notebook: 用于运行和交互代码示例。
    • 基础数据科学库: 如 pandas, numpy, matplotlib 等。
    • AI/LLM框架: 如 openai, langchain，具体取决于章节。

🚀 第一步：获取代码与设置环境

  1. 克隆仓库

    1
    2
    git clone https://github.com/evoiz/Agentic-Design-Patterns.git
    cd Agentic-Design-Patterns

  2. 创建并激活虚拟环境 (推荐)

    1
    2
    3
    python -m venv venv
    source venv/bin/activate  # Linux/macOS
    # .\venv\Scripts\activate  # Windows

  3. 安装核心依赖
    你需要安装Jupyter以及各章节可能用到的通用库。项目根目录下可能包含 requirements.txt，如果没有，可以手动安装基础包：

    1
    pip install jupyter notebook pandas numpy matplotlib openai langchain

📚 第二步：浏览仓库内容

仓库结构清晰，主要包含两部分：

  • Agentic_Design_Patterns_Complete.pdf: 完整的书籍PDF文件（共424页），涵盖所有章节和附录，是学习的主要理论材料。
  • chapter_notebooks/: 包含每个章节对应的Jupyter笔记本（.ipynb文件），用于动手实践。

💻 第三步：运行示例代码

  1. 启动 Jupyter Notebook
    在项目根目录下执行：

    1
    jupyter notebook

    这会在你的浏览器中打开Jupyter主页。

  2. 导航到示例笔记本

    • 在Jupyter文件浏览器中，进入 chapter_notebooks/ 目录。
    • 你会看到按章节命名的文件，例如 Chapter_01_Prompt_Chaining.ipynb, Chapter_02_Routing.ipynb 等。

  3. 运行和实验

    • 点击你想要学习的章节笔记本。
    • 在打开的笔记本中，从上到下依次运行每个代码单元格（可以通过点击单元格后按 Shift + Enter）。
    • 仔细阅读每个单元格前的文本说明，理解代码的目的和工作原理。
    • 尝试修改代码中的参数或输入，观察输出变化，进行实验。

🧠 第四步：如何高效学习

根据README的建议，你可以按以下路径循序渐进：

  1. 初学者: 从 第1-7章 (核心模式) 开始，涵盖提示链、路由、并行、反射、工具使用、规划和多智能体系统。
  2. 中级: 学习 第8-14章 (高级与生产模式)，包括记忆管理、适应、MCP、异常处理、人在回路和RAG。
  3. 高级: 深入研究 第15-21章 (企业模式)，涉及智能体间通信、资源优化、推理技术、护栏和评估。
  4. 专家: 探索 附录A-G，了解高级提示、从GUI到真实环境、框架概览、构建智能体等尖端技术。

建议学习方式: 先阅读PDF中对应章节的理论，理解设计模式的动机、结构和适用场景，然后打开并运行对应的Jupyter笔记本，通过代码实践加深理解。

⚙️ 配置与故障排查

  • API密钥: 许多章节的代码（如使用OpenAI、LangChain的）需要你提供自己的API密钥。通常需要在代码中设置环境变量或直接在笔记本中配置，例如：

    1
    2
    import os
    os.environ["OPENAI_API_KEY"] = "你的密钥"

  • 依赖缺失: 如果运行某个笔记本时提示 ModuleNotFoundError，你需要使用 pip install 模块名 安装对应的Python包。

  • 内核问题: 确保Jupyter使用的是你创建并安装了依赖的虚拟环境内核。如果无法自动识别，你可能需要在Jupyter中手动添加内核。

🔧 贡献与资源

  • 贡献: 欢迎通过Fork和Pull Request来报告Bug、建议新特性或改进文档。
  • 相关框架: 本书涉及的智能体框架包括LangChain、AutoGPT、Microsoft AutoGen、CrewAI等，你可以自行查阅这些项目的官方文档。
  • 作者: 安东尼奥·古利 (Antonio Gulli)，所有作者版税将捐赠给“救助儿童会”。

至此，您已经完成了Agentic-Design-Patterns仓库的部署和学习环境配置。这是一个教育性质的学习资源，不涉及复杂的服务部署，重点在于通过理论和实践相结合的方式，掌握设计和构建AI智能体系统的核心模式。建议从第一章开始，循序渐进地完成所有章节的学习和实验。