사람도 기계도 읽는 규약: 예측 가능한 AI 제품 만들기

핵심 내용

• AI 출력은 프롬프트 설명만으로는 스키마 밖 값이 나올 수 있어 예측 가능성 보장이 어려움
• 사람이 읽는 문서와 기계가 강제하는 스키마를 함께 두어야 출력 규약이 실제로 지켜짐
• Zod 스키마를 JSON Schema로 바꿔 OpenAI Structured Outputs(strict)로 넘기고, 런타임에서는 한 지점에서만 parse 검증
• 분류 기준과 경로 선택을 스키마와 프롬프트로 나눠 비용과 호출 수를 줄이고, 재생성 대신 crop·로컬 처리도 활용

적용해볼 점

• 프롬프트 설명과 별개로 런타임 강제 지점을 두기
• AI가 내는 JSON을 신뢰 경계에서 한 번만 검증하기
• 생성 가능한 값 목록을 스키마에 고정해 예측 불가능한 출력을 차단하기