agent-patterns-catalog

Agent Patterns Catalog

AI Agent 架构模式目录，为 Agent 设计提供框架无关的参考架构。

何时激活

• agent-dev-workshop Phase 2 自动调用
• 用户询问 Agent 架构模式选择
• 需要对比不同 Agent 架构方案时

模式索引

| 模式 | 核心思想 | 适用场景 | Reference |

|------|---------|---------|-----------|

| ReAct Agent | 思考→行动→观察循环 | 通用任务、搜索+操作 | references/react-agent.md |

| Multi-Agent Conversation | 多角色自由对话 | 辩论、评审、头脑风暴 | references/multi-agent-conversation.md |

| Multi-Agent Workflow | DAG/Pipeline 编排 | 阶段式处理、内容生产 | references/multi-agent-workflow.md |

| RAG Agent | 检索增强生成 | 知识问答、文档分析 | references/rag-agent.md |

| Tool-Use Agent | 工具调用链 | API 集成、数据处理 | references/tool-use-agent.md |

| Autonomous Agent | 自主规划+执行+反思 | 开放式任务、自主研究 | references/autonomous-agent.md |

模式选择决策树

Q1: Agent 需要自主分解复杂任务吗？
  ├─ Yes → Autonomous Agent
  └─ No → Q2

Q2: 涉及多个不同角色协作吗？
  ├─ Yes → Q3
  └─ No → Q4

Q3: 角色之间需要自由对话还是固定流程？
  ├─ 自由对话 → Multi-Agent Conversation
  └─ 固定流程 → Multi-Agent Workflow

Q4: 核心能力是知识检索吗？
  ├─ Yes → RAG Agent
  └─ No → Q5

Q5: 需要推理+多步操作还是简单工具调用？
  ├─ 推理+多步 → ReAct Agent
  └─ 简单调用 → Tool-Use Agent

混合模式

真实项目中常出现混合模式，常见组合：

| 组合 | 场景 | 设计要点 |

|------|------|---------|

| RAG + ReAct | 基于知识库的推理和操作 | 检索作为一种 Tool 嵌入 ReAct 循环 |

| RAG + Tool-Use | 知识问答 + 数据操作 | 检索和工具并列 |

| Workflow + ReAct | 流水线中某阶段需要推理 | 流水线节点内部嵌入 ReAct loop |

| Autonomous + Tool-Use | 自主规划 + 工具执行 | Plan 产出的子任务由 Tool Agent 执行 |

使用方式

# 在 agent-dev-workshop Phase 2 中
1. 根据 Phase 1 确认的 Agent 类型，读取对应 reference 文件
2. 从 reference 中提取参考架构图
3. 根据实际 spec 调整组件拓扑
4. 记录设计决策