Agentic Design Patterns（中文翻译项目）

👨‍💻 关于xindoo

xindoo - 本翻译项目的发起者和主要维护者

• GitHub: xindoo
• 个人网站: zxs.io
• 博客：xindoo
• 个人简介: 热衷于技术分享和开源贡献的开发者，专注于 AI 技术、系统架构、职业发展。

📚 项目简介

本项目是《Agentic Design Patterns》一书的中文翻译项目。该书系统介绍了 AI Agent 系统的各种设计模式，涵盖从基础到高级的 21 个核心模式，以及多个附录章节。

🎯 关于本书

《Agentic Design Patterns》探讨了构建智能 AI Agent 系统的核心设计模式，包括：

• 提示链、路由、并行化等基础模式
• 反思、工具使用、规划等进阶模式
• 多智能体协作、记忆管理、知识检索等高级模式
• 安全防护、评估监控等实践模式

📖 目录结构

核心章节

1. 第1章：提示链（Prompt Chaining）
2. 第2章：路由（Routing）
3. 第3章：并行化（Parallelization）
4. 第4章：反思（Reflection）
5. 第5章：工具使用（Tool Use）
6. 第6章：规划（Planning）
7. 第7章：多智能体协作（Multi-Agent Collaboration）
8. 第8章：记忆管理（Memory Management）
9. 第9章：学习与适应（Learning and Adaptation）
10. 第10章：模型上下文协议（Model Context Protocol）
11. 第11章：目标设定与监控（Goal Setting and Monitoring）
12. 第12章：异常处理与恢复（Exception Handling and Recovery）
13. 第13章：人机协同（Human-in-the-Loop）
14. 第14章：知识检索（Knowledge Retrieval - RAG）
15. 第15章：智能体间通信（Inter-Agent Communication - A2A）
16. 第16章：资源感知优化（Resource-Aware Optimization）
17. 第17章：推理技术（Reasoning Techniques）
18. 第18章：安全防护模式（Guardrails/Safety Patterns）
19. 第19章：评估与监控（Evaluation and Monitoring）
20. 第20章：优先级排序（Prioritization）
21. 第21章：探索与发现（Exploration and Discovery）

附录章节

• 附录A：高级提示技术
• 附录B：AI 智能体交互：从 GUI 到真实世界环境
• 附录C：智能体框架快速概览
• 附录D：使用 AgentSpace 构建智能体（仅在线）
• 附录E：命令行上的 AI 智能体
• 附录F：深入探究：智能体推理引擎内部机制
• 附录G：编程智能体

其他内容

• 常见问题解答
• 术语表
• 术语索引
• 总结

📁 项目结构

agentic-design-patterns/
├── README.md                    # 项目说明文档（本文件）
├── SUMMARY.md                   # GitBook 目录文件
├── CONTRIBUTING.md              # 贡献指南
├── translation-guide.md         # 翻译规范指南
├── progress.md                  # 翻译进度追踪
├── glossary.md                  # 术语对照表
├── PROJECT_STRUCTURE.md         # 项目结构说明
├── _config.yml                  # Jekyll 配置文件
├── Gemfile                      # Ruby 依赖管理
├── CNAME                        # 自定义域名配置
├── chapters/                    # 翻译后的章节目录
│   ├── README.md                # 章节说明
│   ├── Agentic Design Patterns.md
│   ├── Chapter 1_ Prompt Chaining.md
│   ├── Chapter 2_ Routing.md
│   └ой ...                      # 其他章节和附录
├── original/                    # 原文备份目录
│   ├── Agentic Design Patterns.md
│   ├── Chapter 1_ Prompt Chaining.md
│   ├── Chapter 2_ Routing.md
│   └ой ...                      # 其他原文章节
├── images/                      # 图片资源目录
│   ├── README.md                # 图片目录说明
│   ├── cover.png                # 封面图片
│   ├── chapter-1/               # 第1章图片
│   ├── chapter-2/               # 第2章图片
│   └ой ...                      # 其他章节图片
├── _includes/                   # Jekyll 包含文件
│   ├── navigation.html          # 导航菜单
│   └oy navigation-en.html       # 英文导航菜单
└oy _layouts/                    # Jekyll 布局文件
    └ой default.html             # 默认布局模板

🌐 在线访问

本项目已部署到 GitHub Pages，可以在线阅读：

访问地址： https://adp.xindoo.xyz/

📊 翻译进度

根据 progress.md 的统计，所有 32 个文件（21个核心章节 + 7个附录 + 4个其他内容）已经完成初步翻译，目前处于待审核状态。

当前状态：

• ✅ 已完成翻译：32/32
• 🔄 待审核：32/32
• 📝 已审核完成：0/32

查看详细翻译进度请参考 progress.md

🤝 如何贡献

我们欢迎任何形式的贡献！参与方式：

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/translate-chapter-xx)
3. 提交更改 (git commit -am '完成第XX章翻译')
4. 推送分支 (git push origin feature/translate-chapter-xx)
5. 创建 Pull Request

详细贡献指南请参阅 CONTRIBUTING.md

📝 翻译规范

在开始翻译前，请仔细阅读 translation-guide.md，主要规范包括：

• 保持原文结构：段落、标题层级保持一致
• 术语统一：参考 glossary.md 中的术语对照表
• 代码保持原样：代码示例、命令行等保持英文
• 图片路径：确保图片引用路径正确指向 images/ 目录
• 格式规范：遵循 Markdown 格式规范
• 校对审核：提交前进行自我校对

注意：所有翻译文件已初步完成，当前主要任务是进行二次审核和质量检查。

📚 相关资源

• 术语对照表 - 统一的技术术语翻译
• 翻译指南 - 详细的翻译规范和注意事项
• 项目结构说明 - 项目文件组织说明
• GitBook 目录 - 在线书籍的完整目录结构
• Jekyll 配置 - GitHub Pages 网站配置
• 翻译进度追踪 - 实时更新翻译状态

Star History

📄 许可证

本翻译项目遵循原书的许可证条款。翻译内容仅供学习交流使用。

联系我们

邮箱: ixindoo@gmail.com
个人网站: https://zxs.io/

---

注意：本项目为学习交流目的的翻译项目，如有版权问题请联系处理。

Agentic Design Patterns 中文快速上手指南

本指南旨在帮助开发者快速搭建本地阅读环境，浏览《Agentic Design Patterns》的中文翻译内容。本项目基于 Jekyll 构建，部署于 GitHub Pages。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux, macOS 或 Windows (推荐 WSL2)
• Git：用于克隆代码仓库
• Ruby：版本建议 2.5.0 及以上 (Jekyll 运行依赖)
• Bundler：Ruby 包管理工具 (通常随 Ruby 安装，若未安装需手动执行 gem install bundler)

国内加速建议： 若在国内网络环境下安装 Ruby 依赖较慢，建议切换至国内镜像源（如清华源或阿里源）：

gem sources --add https://mirrors.tuna.tsinghua.edu.cn/rubygems/ --remove https://rubygems.org/
gem sources -l # 确认列表只包含国内源

安装步骤

1. 克隆项目仓库 将项目代码拉取到本地：

   git clone https://github.com/xindoo/agentic-design-patterns.git
   cd agentic-design-patterns
   

2. 安装依赖 使用 Bundler 安装项目所需的 Ruby gems：

   bundle install
   

   注：若遇到权限问题，可尝试 bundle config set --local path 'vendor/bundle' 后再执行安装。

3. 启动本地服务 运行 Jekyll 开发服务器：

   bundle exec jekyll serve
   

基本使用

服务启动成功后，终端将显示类似以下信息：

Server address: http://127.0.0.1:4000/
Server running... press ctrl-c to stop.

1. 访问文档 打开浏览器，访问 http://127.0.0.1:4000/ 即可在线阅读完整的中文目录和章节内容。

2. 浏览核心内容 网站首页提供了完整的导航菜单，您可以直接点击阅读核心设计模式，例如：

   • 基础模式：提示链 (Prompt Chaining)、路由 (Routing)
   • 进阶模式：反思 (Reflection)、工具使用 (Tool Use)、规划 (Planning)
   • 高级模式：多智能体协作、记忆管理、RAG 知识检索

3. 离线查阅 若无需启动 Web 服务，也可直接在 chapters/ 目录下通过 Markdown 阅读器查看具体的 .md 文件，例如：

   cat chapters/Chapter\ 1_\ Prompt\ Chaining.md
   

4. 在线访问（免安装） 如果仅需阅读无需本地修改，可直接访问已部署的站点： https://adp.xindoo.xyz/