telexed ~ c / 8fa26e01-088radar:60 · agent_toolLIVE
← 피드로
NO.
#8fa26e01
분야
에이전트·도구
출처
GitHub Trending Weekly
게재
2026-05-22 03:13:38
중요도
★ 6/10 — radar 60
`12-factor-agents`, 프로덕션 LLM 앱 설계 원칙 정리
FIG-0081:1

`12-factor-agents`, 프로덕션 LLM 앱 설계 원칙 정리

`12-factor-agents`: production patterns for reliable LLM apps

프레임워크보다 prompt, 컨텍스트, 상태, 제어 흐름을 직접 소유하라는 체크리스트에 가깝다. 에이전트 기능을 제품에 넣기 전 설계 기준으로 바로 쓸 만함.

[ 요점 ]
  1. 핵심 전제는 좋은 에이전트가 대부분 결정적 소프트웨어이고, LLM은 필요한 지점에만 끼운다는 것.
  2. tool call을 별도 마법이 아니라 구조화 출력으로 본다. Next.js API나 Supabase 작업 큐와 엮기 쉽다.
  3. 컨텍스트 윈도우와 프롬프트를 직접 관리하라고 못박음. 프레임워크 교체보다 운영 디버깅 비용을 줄이는 쪽.
  4. launch/pause/resume API와 사람 호출용 tool call을 분리한다. 결제·메일·배포처럼 승인 필요한 흐름에 맞다.
  5. 작고 집중된 에이전트, stateless reducer 구조를 권장. 한 방에 만능 비서를 만드는 접근보다 장애 범위가 작다.
원문github.com/humanlayer/12-factor-agents원문 보기 →

// related