用途
本项目是 Google《Agentic Design Patterns》一书的中文翻译，面向希望系统学习 AI 智能体（Agent）设计模式的中文读者。它把原书内容整理为可在线阅读、可本地部署的文档，覆盖从基础到高级的 21 个核心模式，并附有 7 个附录及额外资源。
主要能力
内容按由浅入深组织：
- 基础模式：提示链（Prompt Chaining）、路由（Routing）、并行化（Parallelization）
- 进阶模式：反思（Reflection）、工具使用（Tool Use）、规划（Planning）
- 高级模式：多智能体协作（Multi-Agent Collaboration）、记忆管理（Memory Management）、RAG（检索增强生成）
- 实践模式：安全/护栏（Safety/Guardrails）、评估与监控（Evaluation & Monitoring）
项目结构包含：
- chapters/：翻译后的章节（32 个文件）
- original/：英文原文章节
- images/：按章节整理的图片资源
- glossary.md：术语参考
- progress.md：翻译进度追踪
- translation-guide.md：翻译规范
正文中给出了多个模式的代码示例，例如提示链的文档分析链、基于意图的路由、函数调用形式的工具使用、研究团队式的多智能体协作、基于 SentenceTransformer 与 faiss 的 RAG 实现，以及对话记忆管理等。
使用方式
在线阅读：访问部署好的 GitHub Pages 站点 https://adp.xindoo.xyz/
本地搭建（克隆仓库）：
git clone https://github.com/xindoo/agentic-design-patterns.git cd agentic-design-patterns
本地 Jekyll 服务器（GitHub Pages 风格）：
bundle install bundle exec jekyll serve
访问 http://localhost:4000
GitBook 格式：
npm install -g gitbook-cli gitbook install gitbook serve
访问 http://localhost:4001
内容检索与代码提取：
查找所有提到 "RAG" 的位置
grep -r "RAG" chapters/
查找特定模式实现
grep -r "def.*agent" chapters/
中文检索
grep -r "多智能体" chapters/
提取某章所有 Python 代码块
sed -n '/python/,//p' chapters/Chapter\ 5_\ Tool\ Use.md
生成 PDF/EPUB：
gitbook pdf ./ ./agentic-patterns-zh.pdf gitbook epub ./ ./agentic-patterns-zh.epub
适用场景
- 中文开发者系统学习 AI 智能体设计模式
- 作为构建智能体系统时的模式参考与代码示例来源
- 参与翻译与审校，按 translation-guide.md 与 glossary.md 统一术语
- 通过 grep 检索特定模式或术语，快速定位章节内容
限制与注意事项
- 项目为书籍翻译与文档集合，本身不是可直接运行的智能体框架或库。
- 文中代码示例为模式演示，具体运行依赖（如 llm.generate、execute_tool 等）未在资料中给出完整实现。
- 翻译进度方面，资料显示当前所有章节均处于 review（审核）状态。
- 常见问题包括：图片路径错误（应使用相对 images/ 的路径）、术语不一致（需先查 glossary.md）、Jekyll 构建因无效日期失败、缺少依赖（需安装 bundler 或 gitbook-cli）。
- 关于收费、价格、平台支持范围等，资料未提供，暂未提供。
资源
- 在线书籍：https://adp.xindoo.xyz/
- GitHub 仓库：https://github.com/xindoo/agentic-design-patterns
- 作者：xindoo（https://zxs.io）
- 翻译规范：translation-guide.md
- 术语表：glossary.md
- 进度追踪：progress.md