Wiki
Structured Output
LLM 응답을 자유 텍스트가 아니라 검증 가능한 데이터 계약으로 받는 패턴입니다.
Definition
Structured Output은 JSON Schema나 도구 호출 스키마를 통해 모델 응답을 API가 처리할 수 있는 구조로 제한하고, validation과 fallback을 함께 설계하는 방법입니다.
When to use
- LLM 응답을 DB 저장, 후속 API 호출, UI 상태로 연결해야 할 때
- 출력 형식이 흔들릴 때마다 사람이 복구하는 운영 비용을 줄이고 싶을 때
Related posts
Structured Outputs 실전
LLM 응답을 자유 텍스트가 아니라 JSON Schema 기반 API 계약으로 다루기 위해 Structured Outputs, validation, schema version, fallback을 설계하는 방법을 정리합니다.
Provider API를 제품 로직에서 분리하는 법
Claude Code CLI 분석을 바탕으로 model provider API 요청, streaming 응답, tool schema, usage/cost 처리를 runtime boundary로 분리하는 방법을 설명합니다.
XML 태그와 출력 형식으로 Claude 응답을 안정화하는 법
Claude 프롬프트가 길어질수록 가장 먼저 무너지는 것은 정보의 경계입니다. 지시문, 참고자료, 예시, 사용자 입력, 출력 형식이 한 덩어리로 섞이면 Claude가 어느 문장이 명령이고 어느 문장이 데이터인지 헷갈릴 수 있습니다.