12-Factor Agents：让 Agent 走向生产

是什么 这是一个受12 Factor Apps启发的LLM应用工程方法论仓库，不是完整的Agent框架。README试图回答：怎样构建真正足以交付给生产客户的LLM软件。它反对简单的“目标+工具+循环”模型，主张让确定性软件重新承担边界、状态和流程控制。

核心设计 12条原则覆盖从自然语言到工具调用、提示词与上下文管理，到结构化输出、执行状态、暂停恢复、人工介入、控制流、错误压缩、小型Agent、多入口触发和无状态Reducer。整体架构强调让模型负责有限决策，让代码负责可验证、可恢复的执行。

关键洞察 最值得借鉴的是“拥有自己的边界”：自己构建上下文、自己定义提示词、自己编排控制流，并把Agent拆成职责单一的模块。这能降低隐式行为带来的复杂度，也更利于组合、调试和渐进式上线。

边界与风险 它提供的是原则、图解和案例方向，不会替代具体模型、工具、存储、评测与安全方案。落地时仍需结合业务风险决定哪些步骤交给模型，哪些步骤必须由确定性代码和人工审批兜底。