12 Factor Agents

不活跃
GitHub TypeScript NOASSERTION

简介

探讨构建生产级 LLM 驱动软件的核心原则，总结出使智能体应用达到生产可用标准的十二个关键要素。

核心特性

  • 12 条核心原则体系 — 从自然语言到工具调用、上下文窗口管理、状态无 Reducer 等系统性最佳实践
  • 上下文窗口自主管理（Factor 3）— 自行构建和管理 LLM 上下文，而非依赖框架黑盒
  • 工具即结构化输出（Factor 4）— 将工具调用视为结构化输出，简化 Agent 交互模式
  • 无状态 Reducer 模式（Factor 12）— 将 Agent 设计为纯函数 Reducer，提升可测试性和可维护性
  • 人工介入工具调用（Factor 7）— 通过工具调用联系人类，实现 Human-in-the-loop 协作
  • 错误压缩到上下文窗口（Factor 9）— 将错误信息精炼后注入上下文，让 Agent 自主恢复

适用场景

💡 评估和改进现有 Agent 框架的架构设计
💡 从零构建生产级 LLM 驱动应用的架构参考
💡 理解为什么大多数 Agent 框架不适合生产环境
💡 设计可测试、可维护、可扩展的 Agent 系统
💡 实现 Human-in-the-loop 的企业级 Agent 工作流

标签

agent framework evaluation observability tools

分类

📊 可观测性

快速开始

git clone https://github.com/humanlayer/12-factor-agents.git
cd 12-factor-agents

# 阅读核心原则
cat content/factor-01-natural-language-to-tool-calls.md
cat content/factor-03-own-your-context-window.md
cat content/factor-12-stateless-reducer.md

# 跟随原则构建自己的 Agent
# 1. 使用自然语言到工具调用模式
# 2. 自行管理上下文窗口
# 3. 将 Agent 设计为无状态 Reducer
访问 GitHub

相关项目