agentic-design-patterns-cn:基于 AI 技术的智能体设计模式中英文对照翻译项目

《智能体设计模式:构建智能系统的实践指南》中文翻译版

Branch9Tags0
FilesLast commitLast update
1 year ago
11 months ago
1 year ago
11 months ago
1 year ago
1 year ago
1 year ago
1 year ago
11 months ago
11 months ago
11 months ago
1 year ago
11 months ago
11 months ago
11 months ago
1 year ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
1 year ago
1 year ago
11 months ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
11 months ago
1 year ago
1 year ago
11 months ago
1 year ago

MseeP.ai Security Assessment Badge

Agentic Design Patterns | 智能体设计模式

A Hands-On Guide to Building Intelligent Systems | 构建智能系统的实践指南

License: CC BY-NC 4.0 GitHub stars GitHub forks

原书作者 (Author): Antonio Gulli

原书链接 (Original Book): Amazon

原始文档链接 (Original Book Link): Google Docs


📖 项目简介 | Project Description

本项目是对 Antonio Gulli 所著《Agentic Design Patterns: A Hands-On Guide to Building Intelligent Systems》的中英文对照翻译。该书是一部全面的技术指南,涵盖了现代人工智能系统中智能体 (Agent) 设计的核心概念和实践方法。

This project is a bilingual Chinese-English translation of "Agentic Design Patterns: A Hands-On Guide to Building Intelligent Systems" by Antonio Gulli. The book is a comprehensive technical guide covering core concepts and practical approaches to agent design in modern AI systems.


🎯 项目特色 | Key Features

  • 📚 中英文对照 - 完整的双语对照翻译
  • 🎨 高亮显示 - 中文内容使用黄色高亮,易于区分
  • 📝 格式规范 - 严格遵循 Markdown 标准和翻译规范
  • 🔗 代码链接 - 保留所有原书代码示例链接
  • ⚡ 持续更新 - 逐章翻译,持续更新进度

📋 翻译进度 | Translation Progress

总页数:424 页 | Total: 424 Pages

前置内容 | Front Matter

章节 概述 负责人 AI 翻译 人工评审 交叉评审
献辞 作者的献辞与致敬 @ginobefun ✅ ✅ ✅
致谢 致谢与感谢名单 @ginobefun ✅ ✅ ✅
序言 本书的序言与背景介绍 @ginobefun ✅ ✅ ✅
思想领袖的洞见 权力与责任的深度思考 @ginobefun ✅ ✅ ✅
介绍 全书引言与核心概念 @ginobefun ✅ ✅ ⏳
什么是"智能体"? 定义 AI 系统的"智能体"特征 @ginobefun ✅ ✅ ⏳

第一部分:核心设计模式 | Part One: Core Patterns (103 页)

章节 设计模式概述 负责人 AI 翻译 人工评审 交叉评审
第 1 章:提示链 分而治之的任务分解模式,将复杂任务分解为处理流水线 @ginobefun ✅ ✅ ✅
第 2 章:路由 智能决策与动态分发,根据情境选择最佳行动路径 @ginobefun ✅ ✅ ✅
第 3 章:并行化 并发执行与性能提升,同时执行多个独立任务 @ginobefun ✅ ✅ ✅
第 4 章:反思 自我评估和迭代改进,通过反馈循环优化输出质量 @ginobefun ✅ ✅ ✅
第 5 章:工具使用 外部工具与 API 集成,扩展智能体能力边界 @ginobefun ✅ ✅ ✅
第 6 章:规划 多步骤计划制定与执行,实现复杂目标分解 @ginobefun ✅ ✅ ✅
第 7 章:多智能体协作 协同工作架构,多个智能体配合完成任务 @ginobefun ✅ ✅ ✅

第二部分:高级设计模式 | Part Two: Advanced Patterns (61 页)

章节 设计模式概述 负责人 AI 翻译 人工评审 交叉评审
第 8 章:记忆管理 短期和长期记忆管理,维持上下文连续性 @郑涛 ✅ ✅ ✅
第 9 章:学习与适应 从经验中学习,持续优化智能体行为 @陈诗中 ⏳ ❌ ❌
第 10 章:模型上下文协议 标准化交互协议,规范智能体通信方式 @郑涛 ⏳ ❌ ❌
第 11 章:目标设定与监控 动态目标管理,实时追踪任务进展 @李浪溪 ✅ ✅ ⏳

第三部分:集成设计模式 | Part Three: Integration Patterns (34 页)

章节 设计模式概述 负责人 AI 翻译 人工评审 交叉评审
第 12 章:异常处理与恢复 优雅错误处理,确保系统稳定性 @EE ✅ ✅ ⏳
第 13 章:人机协作 人机协作决策,融合人类智慧与 AI 能力 @曾汉 ✅ ✅ ⏳
第 14 章:知识检索 (RAG) 检索增强生成技术,结合外部知识库 @EE ✅ ✅ ⏳

第四部分:生产设计模式 | Part Four: Production Patterns (114 页)

章节 设计模式概述 负责人 AI 翻译 人工评审 交叉评审
第 15 章:智能体间通信 (A2A) 智能体通信协议,实现智能体间高效交互 @朵朵肥 ✅ ✅ ❌
第 16 章:资源感知优化 资源优化管理,平衡性能与成本 @IsaacZhaoo ✅ ✅ ⏳
第 17 章:推理技术 增强推理能力,提升决策质量 @Diqing ❌ ❌ ❌
第 18 章:护栏/安全模式 安全保障机制,防止不当行为 @IsaacZhaoo ⏳ ❌ ❌
第 19 章:评估与监控 性能评估体系,量化智能体表现 @朵朵肥 ❌ ❌ ❌
第 20 章:优先级排序 任务优先级管理,优化资源分配 @IsaacZhaoo ✅ ✅ ⏳
第 21 章:探索与发现 自主探索机制,发现新解决方案 @IsaacZhaoo ✅ ✅ ⏳

附录 | Appendix (74 页)

章节 概述 负责人 AI 翻译 人工评审 交叉评审
附录 A:高级提示技术 高级提示工程方法与技巧 待定 ❌ ❌ ❌
附录 B:从 GUI 到真实世界 AI 智能体在不同环境中的应用 待定 ❌ ❌ ❌
附录 C:智能体框架概览 主流智能体框架快速入门 @庄才家 ❌ ❌ ❌
附录 D:AgentSpace 实践 使用 AgentSpace 构建智能体(在线版本) @庄才家 ❌ ❌ ❌
附录 E:命令行智能体 CLI 环境下的 AI 智能体(在线版本) 待定 ❌ ❌ ❌
附录 F:推理引擎内幕 深入剖析智能体推理引擎机制 @EE ✅ ✅ ⏳
附录 G:编程智能体 代码生成与编程辅助智能体 待定 ❌ ❌ ❌

结尾内容 | Back Matter

章节 概述 负责人 AI 翻译 人工评审 交叉评审
结论 全书总结与未来展望 待定 ❌ ❌ ❌
术语表 重要术语汇总与解释 待定 ❌ ❌ ❌
术语索引 关键术语快速查找索引 待定 ❌ ❌ ❌

状态说明:

  • ✅ 已完成
  • ⏳ 进行中
  • ❌ 未开始

完成标准:只有当 AI 翻译、人工评审、交叉评审三个状态都标记为 ✅ 时,该章节才算正式完成。


📖 如何使用本项目 | How to Use This Project

🎯 适合读者 | Target Audience

  • AI 工程师 - 构建智能、可靠的 AI 系统
  • 软件架构师 - 设计智能体组件系统
  • 产品经理 - 了解智能体技术能力与局限
  • 研究人员 - 学习最新智能体设计方法
  • 学生 - 学习人工智能和智能体系统

📚 阅读建议 | Reading Tips

  1. 顺序阅读 - 建议按章节顺序,后续章节基于前面基础
  2. 动手实践 - 每章都有代码示例,建议实际运行
  3. 参考查阅 - 可作为设计模式参考手册使用
  4. 社区参与 - 欢迎参与讨论和贡献

💻 运行代码示例 | Running Code Examples

本项目在 codes/ 目录中提供了各章节的代码示例。以下是运行代码的步骤:

1. 环境准备 | Environment Setup

# 克隆仓库
git clone https://github.com/ginobefun/agentic-design-patterns-cn.git
cd agentic-design-patterns-cn

# 创建虚拟环境(推荐)
python3 -m venv venv
source venv/bin/activate  # macOS/Linux
# 或 Windows 系统: venv\Scripts\activate

# 安装依赖(根据需要运行的代码示例安装相应依赖)
pip install langchain langchain-community langchain-openai langgraph

2. 配置 API 密钥 | Configure API Key

创建 .env 文件并配置你的 API 密钥:

# 在项目根目录创建 .env 文件
touch .env

在 .env 文件中添加以下内容:

# OpenAI API 密钥
OPENAI_API_KEY=your-openai-api-key-here

# 或使用 OpenRouter(兼容 OpenAI API)
OPENAI_API_KEY=your-openrouter-api-key-here
OPENAI_API_BASE=https://openrouter.ai/api/v1

3. 运行代码 | Run Code

# 确保虚拟环境已激活
source venv/bin/activate

# 运行第一章示例:提示链
python codes/Chapter-01-Prompt-Chaining-Example.py

# 运行其他章节的代码示例(待添加)
# python codes/Chapter-XX-Example.py

4. 在线运行 | Run Online

每个代码示例文件中都包含了 Google Colab 链接,可以直接在线运行,无需本地配置:

注意事项 | Notes

  • 🔑 API 密钥安全: 切勿将包含真实 API 密钥的 .env 文件提交到版本控制系统
  • 💰 API 费用: 运行代码会产生 API 调用费用,请注意使用量
  • 🌐 网络连接: 代码需要网络连接才能访问 LLM API 服务
  • 🔄 兼容性: 代码示例支持 OpenAI API 和兼容 OpenAI API 的服务(如 OpenRouter)

🛠️ 翻译规范 | Translation Standards

📝 格式规范

  • 高亮标记: 中文内容使用 <mark>文本</mark> 黄色高亮
  • 双语对照: 英文段落后紧跟中文翻译
  • 术语处理: 重要术语保留英文,括号注明中文
  • 空格规则: 中英文、数字间添加空格

🎯 质量标准

  • 准确性: 100% 忠实原文含义
  • 流畅性: 符合中文表达习惯
  • 专业性: 保持技术文档严谨性
  • 一致性: 术语翻译前后统一

详细翻译规范请参考 rules.md 文档。


🤝 贡献指南 | Contributing

欢迎社区贡献!你可以通过以下方式参与:

🔍 如何贡献

  1. 错误报告 - 发现翻译错误或格式问题
  2. 翻译改进 - 提供更优的翻译建议
  3. 章节翻译 - 参与未完成章节的翻译
  4. 校对审阅 - 帮助校对已翻译章节

📋 贡献步骤

  1. Fork 本仓库
  2. 创建特性分支 (git checkout -b feature/your-contribution)
  3. 提交更改 (git commit -m 'Add: your contribution')
  4. 推送到分支 (git push origin feature/your-contribution)
  5. 创建 Pull Request

💬 交流社区 | Community

欢迎加入我们的微信交流群,无论你是想一起阅读、交流心得,还是对翻译提出宝贵建议,都欢迎你的加入。后续我们还会组织交流或直播活动哦!

微信交流群

📝 加群说明:

  • 🚫 微信群已满,不再接受新成员

📖 原书版权

  • 作者: Antonio Gulli
  • 出版社: Springer
  • 版权: 原书版权归作者和出版社所有
  • 公益性质: 原书所有版税将捐赠给救助儿童会 (Save the Children)

🌏 翻译版权

  • 翻译: 本翻译项目基于 CC BY-NC 4.0 协议开源
  • 目的: 仅用于学习交流,促进中文 AI 社区发展
  • 使用限制:
    • ✅ 允许:自由复制、分发、展示和演绎作品(需署名译者)
    • ❌ 禁止:任何形式的商业使用
    • 📧 商业合作:如需商业使用,请联系译者和原书版权方

⭐ 支持项目 | Support the Project

如果这个项目对你有帮助,请考虑:

  • 🌟 给项目加 Star
  • 🍴 Fork 并参与贡献
  • 📢 分享给更多需要的人
  • 💝 支持原书作者的公益事业

让我们一起构建更智能的未来! | Let's build a smarter future together!

Introduction

《智能体设计模式:构建智能系统的实践指南》中文翻译版

Customize your domain