구조화된 출력(Structured output)
구조화된 출력(structured output)은 언어 모델의 응답이 직접 정의한 형식, 보통 JSON schema를 따르게 하는 API 기능입니다. 그래서 코드가 자유 텍스트를 긁어내는 대신 응답을 안정적으로 파싱할 수 있습니다.
다른 이름: JSON mode, JSON schema output, structured outputs
작성 Divya Sharma · 2026년 11월 15일 확인 · 리뷰 방식
모델의 답이 코드로 들어간다면 자유 텍스트는 깨지기 쉽습니다. 괄호 하나가 빠지거나, 문장 하나가 더 붙거나, 필드 이름이 바뀌면 파서가 망가집니다. 구조화된 출력은 모델에 스키마를 주고 API가 그에 맞는 응답만 돌려주게 해 이 문제를 해결합니다.
작동 방식
요청과 함께 필드, 타입, 필수 여부를 나열한 JSON schema를 보냅니다. 엄격한 구조화된 출력을 지원하는 제공업체는 제약 디코딩을 씁니다. 각 단계에서 모델은 응답이 스키마에 대해 유효하도록 유지하는 토큰만 만들 수 있습니다. Anthropic 문서는 이것이 스키마를 준수하는 응답을 보장하며, JSON 파싱 오류가 없고 필수 필드가 항상 존재한다고 설명합니다.
JSON 모드와 스키마 출력
단순한 "JSON 모드"는 문법적으로 유효한 JSON만 요구합니다. 응답은 파싱되지만 필드가 빠지거나 타입이 틀릴 수 있습니다. 스키마 기반 구조화된 출력은 형태까지 확인합니다. 둘 다 없으면 프롬프트 엔지니어링, 검증, 재시도에 기대야 합니다.
예시
송장 추출기라면 공급업체, 날짜, 합계, 통화 필드를 정의할 수 있습니다. 모델은 정확히 그 키를 가진 객체를 돌려주며, 이는 검증을 거쳐 바로 데이터베이스에 들어갈 수 있습니다.
함수 호출과의 차이
함수 호출은 모델에게 도구를 고르고 인수를 채우도록 요청합니다. 구조화된 출력은 최종 답 자체의 형태를 잡습니다. 둘 다 스키마를 쓰며, 일 부 제공업체는 도구 인수에도 엄격 모드를 제공합니다.
한계
형태가 유효하다고 답이 맞는 것은 아닙니다. 모델은 형식이 올바른 필드에 여전히 틀린 값이나 환각을 넣을 수 있으므로, 형식뿐 아니라 내용도 확인하십시오. 제공업체마다 JSON Schema의 지원 범위가 다르니, 쓰는 제공업체가 어떤 키워드를 받아들이는지 확인하십시오.
관련 용어
- 도구 호출
- 도구 호출(tool calling)은 함수 호출(function calling)이라고도 하며, 스키마로 함수를 설명하면 모델이 그중 하나를 호출하겠다는 구조화된 요청으로 답하고, 코드가 이를 실행해 결과를 돌려주는 모델 API 기능입니다.
- 프롬프트 엔지니어링(Prompt engineering)
- 프롬프트 엔지니어링(prompt engineering)은 모델의 가중치를 바꾸지 않고, 애플리케이션에 필요한 출력을 내도록 언어 모델에 주는 지시와 예시를 작성하고, 구성하고, 테스트하는 일입니다.
- 환각(AI)
- 환각(hallucination)은 AI 모델의 출력이 유창하고 자신감 있게 들리지만 거짓이거나, 출처의 뒷받침이 없거나, 지어낸 것인 경우를 말합니다. 꾸며 낸 인용, 발언, 통계, API 함수 등이 그 예입니다.
- 가드레일(AI)
- 가드레일(guardrails)은 언어 모델 주변에 두는 실행 시점 점검 장치로, 입력과 출력을 검사해 막거나, 다시 쓰거나, 다른 곳으로 돌립니다. 애플리케이션이 주제를 벗어나지 않고, 해로운 콘텐츠를 피하고, 모델만으로는 꾸준히 지키지 못할 규칙을 따르게 합니다.