Agentic Design Patterns | 智能体设计模式

原书作者 (Author): Antonio Gulli

原书链接 (Original Book): Amazon

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

本项目是对 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.

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

总页数：424 页 | Total: 424 Pages

状态说明：

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

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

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

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

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

# 克隆仓库
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

创建 .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

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

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

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

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

• 📔 第一章：提示链示例 - Colab

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

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

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