Tool overview
구조화 출력 생성기이란?
구조화 출력 생성기은(는) 예제 페이로드에서 JSON Schema 추론 위한 개발자 도구입니다.
왜 구조화 출력 생성기을(를) 사용하나요?
예제 페이로드에서 JSON Schema 추론할 때 가독성과 작업 속도를 높이며 서버로 데이터를 보내지 않습니다.
주요 기능
클라이언트 사이드 프라이버시, 즉시 결과, 원클릭 복사. 예제 페이로드에서 JSON Schema 추론
사용 방법
위 도구에서 정확한 결과를 얻기 위한 단계입니다.
- LLM 응답 또는 도구 인자의 대표 JSON 예제를 왼쪽 패널에 붙여넣습니다.
- 선택 키는 생략 — 예제에 있는 키만 required가 됩니다.
- Strict objects를 켜 모든 객체에 additionalProperties: false를 출력 — OpenAI에 권장.
- 선택적으로 OpenAPI나 도구 레지스트리용 Schema 제목을 설정합니다.
- 오른쪽 패널의 JSON Schema draft 2020-12를 검토합니다.
- 배열이 items: {}이면 대표 요소를 하나 이상 추가하고 다시 생성합니다.
- 스키마를 response_format, 도구 매개변수 또는 에이전트 구성에 복사합니다.
- 유형이 틀리면 예제를 반복하고, 필요하면 생성 후 enum이나 oneOf를 수동 편집합니다.
구조화 출력 생성기 — 완전 가이드 및 사용 사례
권위 있는 안내: draft 2020-12 추론, strict additionalProperties, OpenAI 및 도구 매개변수, 빈 배열 수정, 생략으로 선택성.
구조화 출력 생성기 가이드
이 가이드는 브라우저에서 예제 JSON으로 JSON Schema draft 2020-12를 추론하는 방법을 설명합니다.
생성기가 하는 일
생성기는 예제 JSON을 JSON Schema로 변환하고 additionalProperties: false로 객체를 닫을 수 있습니다.
제공되는 항목
- JSON Schema draft 2020-12
- 제공되는 항목: additionalProperties: false
- 제공되는 항목: required
- 제공되는 항목: integer / number / null
- 제공되는 항목: items
- schema를 다음에 복사합니다: response_format
schema 추론이 필요할 때 사용
- schema 추론이 필요할 때 사용
- schema 추론이 필요할 때 사용: OpenAI
- schema 추론이 필요할 때 사용: JSON Schema
- schema 추론이 필요할 때 사용: strict
관련 도구 사용
- 관련 도구 사용: AI Agent Builder
- 관련 도구 사용: MCP Validator
- 관련 도구 사용: LLM Token Counter
예제 JSON이 스키마 유형으로 매핑되는 방식
추론은 JSON 트리를 순회하며 입력은 엄격한 JSON이어야 합니다.
추론은 JSON 트리를 순회하며 입력은 엄격한 JSON이어야 합니다.
| 예제 값 | 추론 유형 | 참고 |
|---|---|---|
| "ok" | string | 제공되는 항목 |
| 42 | integer | 제공되는 항목 |
| 42.5 | number | 제공되는 항목 |
| true | boolean | 제공되는 항목 |
| null | null | 선택 키를 생략합니다: |
| [] | array + items: {} | 빈 배열은 items 유형을 알 수 없습니다. |
| { "a": 1 } | object | required + additionalProperties: false |
배열은 첫 요소의 유형을 사용합니다. 혼합 유형은 oneOf를 직접 편집하세요.
단계별: 예제 → draft 2020-12 스키마
OpenAI용 schema를 위한 첫 단계입니다.
- 대표 예제를 붙여넣습니다: JSON.
- 선택 키를 생략합니다: required.
- 활성화합니다: strict additionalProperties: false.
- 검토합니다: JSON Schema draft 2020-12.
- 빈 배열은 items 유형을 알 수 없습니다. items: {}.
- schema를 다음에 복사합니다: response_format.
- oneOf, enum.
- 검토합니다: OpenAI.
사용 사례: OpenAI 구조화 출력
OpenAI: 생성기는 예제 JSON을 JSON Schema로 변환하고 additionalProperties: false로 객체를 닫을 수 있습니다.
이 도구가 돕는 방법
- 대표 예제를 붙여넣습니다: OpenAI JSON.
- 활성화합니다: strict.
- schema를 다음에 복사합니다: response_format.
- 검토합니다: OpenAI.
결과: JSON Schema, OpenAI.
사용 사례: 도구 매개변수
생성기는 예제 JSON을 JSON Schema로 변환하고 additionalProperties: false로 객체를 닫을 수 있습니다.
이 도구가 돕는 방법
- 대표 예제를 붙여넣습니다: tools[].function.parameters.
- 활성화합니다: strict.
- schema를 다음에 복사합니다: tools[].function.parameters.
- 검토합니다: JSON Schema.
결과: tools[].function.parameters.
사용 사례: 생략으로 선택 필드 지정
생성기는 예제 JSON을 JSON Schema로 변환하고 additionalProperties: false로 객체를 닫을 수 있습니다.
이 도구가 돕는 방법
- 선택 키를 생략합니다: required.
- 검토합니다: required.
- null.
- schema를 다음에 복사합니다: required.
결과: required.
사용 사례: 구조화 JSON 분류기
생성기는 예제 JSON을 JSON Schema로 변환하고 additionalProperties: false로 객체를 닫을 수 있습니다.
이 도구가 돕는 방법
- 대표 예제를 붙여넣습니다: JSON.
- 활성화합니다: strict.
- schema를 다음에 복사합니다: JSON Schema.
- enum.
결과: JSON Schema, strict.
strict 모드와 additionalProperties: false
strict 모드는 모든 객체에 additionalProperties: false를 설정합니다.
- 활성화합니다: strict.
- 검토합니다: JSON Schema.
- strict 모드는 모든 객체에 additionalProperties: false를 설정합니다.
- 검토합니다: additionalProperties: false.
빈 배열 함정 — items: {}
빈 배열은 items 유형을 알 수 없습니다.
- 대표 예제를 붙여넣습니다: items.
- 빈 배열은 items 유형을 알 수 없습니다.
- oneOf.
- 검토합니다: items.
수정: 잘못된 JSON 입력
JSON.
발생 이유
발생 이유
진단
진단
수정
- 검토합니다: JSON.
- 대표 예제를 붙여넣습니다: JSON.
- 검토합니다: JSON Schema.
수정: 배열 items가 {}로 추론됨
items: {}.
발생 이유
빈 배열은 items 유형을 알 수 없습니다.
진단
진단
수정
- 대표 예제를 붙여넣습니다: items.
- 검토합니다: JSON Schema.
- 검토합니다: items.
oneOf.
수정: 선택 필드가 required로 표시됨
required.
발생 이유
발생 이유
진단
진단
수정
- 선택 키를 생략합니다: required.
- 검토합니다: JSON Schema.
- null.
스키마 추론 모범 사례
- OpenAI용 schema를 위한 첫 단계입니다.
- 활성화합니다: strict, OpenAI.
- 선택 키를 생략합니다: required.
- 대표 예제를 붙여넣습니다: items.
- enum, oneOf.
- 검토합니다: JSON Schema.
- 관련 도구 사용: AI Agent Builder.
자주 묻는 질문
일반적인 문제와 데이터 프라이버시에 대한 답변입니다.
관련 도구
이 도구를 보완하는 관련 유틸리티를 살펴보세요.
공식 문서 및 참고 자료
이 유틸리티의 공식 사양 및 플랫폼 문서입니다.