12 Factor 方法论合并知识图谱 / 分组目录 / 12 Factor Agent 体系 / 小而专注的 Agent

小而专注的 Agent

Agent 体系高级方法原则GB · 12 Factor Agent 体系

What · 是什么

用多个小 Agent 而非一个巨型 Agent 解决问题
与其构建想包办一切的单体 Agent,不如构建小而专注、一件事做到位的 Agent——Agent 只是更大的、基本确定性系统中的构件。
关键洞见在于 LLM 的局限:任务越大越复杂,步骤越多,上下文就越长;随着上下文增长,LLM 更容易迷失或失去焦点。
把 Agent 保持在特定领域、3-10 步(最多 20 步)的规模,就能让上下文窗口可控、LLM 性能保持高位。
核心原则是『随着上下文增长,LLM 更容易迷失或失去焦点』,这是把 Agent 控制在小规模的根本理由。
收益:可控的上下文(小窗口=更好性能)、清晰的职责(每 Agent 范围明确)、更高的可靠性(复杂流程中不易迷路)、更易测试、更易调试。
关于『如果 LLM 变聪明了呢』:即使模型能处理 100+ 步工作流,答案依然是『要』——该做法让你今天就能交付成果,同时为将来逐步扩展范围做准备。
这就像重构大型确定性代码库:有意识地拆分与逐步扩展是保持质量的关键,重构经验可平移复用。,属于该因子的基础原则,应在设计中显式落实。
原文引用 NotebookLM 团队的话:『最神奇的 AI 构建时刻,总是发生在我极度贴近模型能力边界的时候』。
不管边界在哪里,只要你能稳定地找到它并做对,就能构建出魔法般的体验;可以建立很多护城河,但它们都需要工程严谨性。
brief-history 补充:长上下文问题让多数构建者把『工具调用循环』推到一边——超过 10-20 轮就成一团乱,90% 正确率也远不够交付给客户。

Why · 为什么

原理 · Principle

上下文可控:小上下文窗口意味着更好的 LLM 性能与更低的失败率,输出质量有保障,成本也更低。,属于该因子的基础原则,应在设计中显式落实。

职责清晰:每个 Agent 有明确定义的范围与目的,系统整体易推理、易演进,边界一目了然。,属于该因子的基础原则,应在设计中显式落实。

更可靠:在复杂工作流中不易迷失,错误不易在长链条里传播放大,单点失败影响面小。,属于该因子的基础原则,应在设计中显式落实。

更易测试/调试:单 Agent 功能边界小,测试用例与问题定位都简单直接,验证成本大幅降低。,属于该因子的基础原则,应在设计中显式落实。

防止错误空转:短上下文里错误不累积,是 factor 9 防 spin-out 的头号手段,自愈更有效。

即便模型更强,小 Agent 方式保证今天可交付,同时为未来扩范围留好结构,与重构大代码库同理。,属于该因子的基础原则,应在设计中显式落实。

How · 怎么做

把任务按领域拆成多个小 Agent,每个只管一件事,由确定性 DAG 编排(micro-agent DAG 模式)。
限制每 Agent 的步骤规模在 3-10 步,硬上限 20 步,超出就继续拆分,规模纪律明确。,属于该因子的基础原则,应在设计中显式落实。
隔离任务与上下文:让 LLM 只关注一个小的 5-10 步工作流(如 deploybot 的做法)。
用确定性代码处理结构化流程,只在『解析人类反馈、提出更新行动方案』等关键点引入 LLM,物尽其用。,属于该因子的基础原则,应在设计中显式落实。
配合 factor 7 把人类反馈翻译成工作流步骤,避免在长上下文里错误循环,反馈落地更稳。,属于该因子的基础原则,应在设计中显式落实。
保持循环三件套(prompt/switch/context 累积)在每个小 Agent 内小而齐整,职责单一。
随着模型上下文可靠性提升,再逐步扩大 Agent 范围(agent-scope-grow 动画),而非一步到位。
reducer 视角收束:每个小 Agent 就是一个 reducer,输入历史事件输出下一步,职责单一便于推理。

案例 · Cases

代表性案例
原文 5 条收益清单:Manageable Context / Clear Responsibilities / Better Reliability / Easier Testing / Improved Debugging。
NotebookLM 团队名言:紧贴模型能力边界的时刻最神奇(引用 swyx 的 substack 文章)。
deploybot 实例(got-agents/agents repo):确定性代码部署 staging、跑 e2e、把『deploy SHA 4af9ec0 to production』交给 Agent。
deploybot 收束:『We isolate tasks and contexts as much as possible to keep the LLM focused on a small, 5-10 step workflow』。
agent-scope-grow GIF(1a5-agent-scope-grow.gif)演示 Agent 范围随能力提升渐进扩展。
brief-history 的 micro-agent DAG 图与『10-20 轮后一团乱』的行业观察。
chainlit 的 support/chatbot 演示(更多经典案例),作为社区佐证小 Agent 模式的有效性。
『Even as models support longer context windows, you'll ALWAYS get better results with a small, focused prompt and context』的论断。

反模式 · Anti-patterns

相关边

实践资源 · 源码引用

路径说明
08-source/agent-content/factor-10-small-focused-agents.md原文完整内容:小而专注的 Agent、收益、LLM 变聪明了怎么办
08-source/agent-content/brief-history-of-software.md背景:长上下文问题、micro-agent DAG、deploybot 实例
08-source/agent-content/factor-09-compact-errors.md关联:防错误空转的头号手段是小而专注的 Agent