心 智 七 篇 · Seven Mental Models
← Knowledge Atlas · 源头

Building Effective AI Agents

Anthropic 官方 agent 构建指南,workflows vs agents 分类,五种 workflow 模式,ACI 设计原则
来源 · BUILDING EFFECTIVE AGENTS · Schluntz & Zhang · Anthropic 2024

Building Effective AI Agents

Schluntz & Zhang(Anthropic,2024-12-20)——基于数十个客户团队的 agent 工程经验总结

核心论点:最成功的实现不依赖复杂框架,而是用简单、可组合的模式构建。基础构建块是「增强型 LLM」——检索 + 工具 + 记忆,通过 MCP 等协议标准化接口。单次 LLM 调用 + 检索 + 上下文示例通常已经够用——只在有证据表明复杂度能改善结果时才增加复杂度。

五种 Workflow + 一种 Agent 模式
Prompt Chaining任务分解为顺序步骤,中间可加检查门(gate)
Routing输入分类后导向专门化处理——语义路由
Parallelization分段并行(sectioning)+ 投票集成(voting)
Orchestrator-Workers中央 LLM 动态分解任务、分发给工作模型、综合结果
Evaluator-Optimizer生成-评估循环迭代——反馈驱动改进
Agent(自主决策)LLM 动态指挥自身流程——开放式问题、步骤数不可预测
ACI 设计原则
ACI 与 HCI 同等重要
工具定义要像写给初级开发者的文档一样清晰——agent 是工具的主要用户
→ Prompt Chaining · Orchestrator-Workers · Augmented LLM · ACIAnthropic (2024-12-20)

Building Effective AI Agents

摘要

Anthropic 基于与数十个客户团队合作构建 LLM agent 的经验总结。核心论点:最成功的实现不依赖复杂框架,而是用简单、可组合的模式构建。文章区分了 workflows(预定义代码路径编排 LLM)和 agents(LLM 动态指挥自身流程),并系统梳理了五种 workflow 模式和一种 agent 模式。

关键要点

  1. 从简单开始。只在有证据表明复杂度能改善结果时才增加复杂度。单次 LLM 调用 + 检索 + 上下文示例通常已经够用。
  2. 基础构建块是增强型 LLM(augmented LLM):检索、工具、记忆三项增强能力,通过 MCP 等协议标准化接口。
  3. 五种 workflow 模式
  4. Agent 适用场景:开放式问题、步骤数不可预测、需要自主决策。代价是更高成本和错误累积风险。
  5. ACI(Agent-Computer Interface)设计与 HCI 同等重要。工具定义要像写给初级开发者的文档一样清晰。

与其他 source 的关联

  • 本文是 Anthropic 官方 agent 架构模式总览,后续的 harness 系列文章 深入讨论了长时运行场景下的 harness 设计。
  • Claude Agent SDK 是本文推荐的实现框架。

References

  • sources/anthropic_official/building-effective-agents.md