Heroku社が提唱したWebアプリ開発のベストプラクティス「The Twelve-Factor App」のAIエージェント版「12-Factor Agents」
LLMエージェントは「プロンプト+ツール+ループ」だけでは本番品質に届かない。信頼性/拡張性/保守性のための12原則(ツール呼び出し、文脈管理、制御フロー等)を整理
1. 自然言語からツール呼び出しへ(Natural Language to Tool Calls)
2. プロンプトを自分で持つ(Own your prompts)
3. コンテキストウィンドウを自分で持つ(Own your context window)
4. ツールは構造化された出力として扱う(Tools are just structured outputs)
5. 実行状態とビジネス状態を統一する(Unify execution state and business state)
6. 単純なAPIで起動/一時停止/再開(Launch/Pause/Resume with simple APIs)
7. ツール呼び出しで人に連絡する(Contact humans with tool calls)
8. コントロールフローを自分で持つ(Own your control flow)
9. エラーをコンテキストウィンドウに圧縮して戻す(Compact Errors into Context Window)
10. 小さく焦点を絞ったエージェント(Small, Focused Agents)
11. どこからでも起動し、ユーザーのいる場所に合わせる(Trigger from anywhere, meet users where they are)
12. エージェントをステートレスなリデューサにする(Make your agent a stateless reducer)
https://t.co/nrKLj0nWea