사람도 기계도 읽는 규약: 예측 가능한 AI 제품 만들기
AI
사람도 기계도 읽는 규약: 예측 가능한 AI 제품 만들기
두줄요약
AI 출력은 설명만으로는 통제되지 않아 스키마와 런타임 강제가 필요했습니다.\nStructured Outputs와 검증 한 지점화로 예측 가능한 AI 제품을 만들었습니다.
핵심 내용
- AI 출력은 프롬프트 설명만으로는 스키마 밖 값이 나올 수 있어 예측 가능성 보장이 어려움
- 사람이 읽는 문서와 기계가 강제하는 스키마를 함께 두어야 출력 규약이 실제로 지켜짐
- Zod 스키마를 JSON Schema로 바꿔 OpenAI Structured Outputs(strict)로 넘기고, 런타임에서는 한 지점에서만 parse 검증
- 분류 기준과 경로 선택을 스키마와 프롬프트로 나눠 비용과 호출 수를 줄이고, 재생성 대신 crop·로컬 처리도 활용
적용해볼 점
- 프롬프트 설명과 별개로 런타임 강제 지점을 두기
- AI가 내는 JSON을 신뢰 경계에서 한 번만 검증하기
- 생성 가능한 값 목록을 스키마에 고정해 예측 불가능한 출력을 차단하기
