https://blog.margrop.net/tag/12-factor-agents/ Recent content in 12-Factor Agents on 魔都水滴 Hugo -- gohugo.io zh-CN Sat, 23 May 2026 14:50:00 +0800 https://blog.margrop.net/post/12-factor-agents-agent-principles/ Sat, 23 May 2026 14:50:00 +0800 https://blog.margrop.net/post/12-factor-agents-agent-principles/ <blockquote> <p><strong>先说结论</strong></p> <p><code>12-Factor Agents</code> 不是一个让你安装后直接开箱即用的 Agent 框架，也不是某种 Codex / Claude / Cursor 里的 Skill。它更像 AI 时代写 Agent 的工程原则清单：当你发现“把大模型、工具列表和一个 while loop 拼起来”只能做到 70% 到 80% 可用，却迟迟过不了生产质量线时，这套原则会提醒你把提示词、上下文、工具调用、状态、人类审批、错误压缩和控制流重新收回到软件工程手里。</p> <p>我最喜欢它的一点，是它没有把 Agent 神化。相反，它反复强调：可靠的 Agent 并不是“让模型自由发挥”，而是把 LLM 放在一个可观察、可恢复、可审计、可中断、可复现的系统里。真正值得学习的不是某个框架 API，而是这背后的工程姿势。</p> </blockquote> <p>本文所有示例都使用公开项目、公开链接和占位符，不包含真实服务器地址、账号、Token、业务配置或任何内网信息。文中配图来自 HumanLayer 开源项目 <code>12-factor-agents</code> 的官方仓库，内容按其 CC BY-SA 4.0 授权引用；代码授权信息以原仓库为准。</p>