12-Factor Agents는 LLM 기반 소프트웨어를 실제 프로덕션 환경에서 안정적으로 운영하기 위한 12가지 원칙을 정리한 오픈소스 가이드 프로젝트입니다. 12 Factor App 방법론에서 영감을 받아, 자연어를 도구 호출로 변환하고, 프롬프트와 컨텍스트 윈도우를 명시적으로 제어하며, 도구를 구조화된 출력으로 다루는 등 에이전트 설계에 필요한 핵심 패턴을 체계적으로 제시합니다. 일시정지/재개, 사람과의 상호작용을 도구 호출로 처리하는 방법, 작고 집중된 에이전트 설계, 상태가 없는 리듀서 패턴 등 실전 운영에서 검증된 원칙들을 다루며, AI 백그라운드가 없는 엔지니어도 모듈식으로 적용할 수 있도록 구성되어 있습니다.