한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
모델·API · 판정 관망
그림을 글로 풀면
형식 확인 다음에는 값 대조
JSON 구조가 맞아도 원문과 업무 규칙에 맞는 값인지 따로 확인합니다.
- 대상
- 문서에서 정보를 추출해 저장하는 API 개발자
- 무엇이 바뀜
- Gemini 공식 문서는 구조화 출력의 값 검증과 오류 처리를 함께 요구합니다.
- 왜 중요한가
- 정해진 칸을 채웠다는 사실만으로 그 안의 값까지 믿으면 잘못 저장할 수 있습니다.
- 지금 할 일
- 저장 직전에 원문 대조와 업무 규칙 검사를 연결하고 불일치는 보류합니다.
- 한계·미확인
- 가상 예시이며 API 실행·오류율·모든 스키마 기능의 지원 여부를 시험하지 않았습니다.
- 확인일
- 2026-09-18
포장 칸 검사와 내용물 검사는 다른 질문
그림에서 칸의 형식은 통과했지만 주문한 과일과 내용물이 다릅니다. JSON도 필드와 자료형이 맞는지, 값이 원문과 맞는지를 나눠 볼 필요가 있습니다. Google은 구조화 출력에서도 앱이 값을 검증하고 의미가 틀린 결과를 처리하도록 안내합니다.
저장 직전에 원문을 다시 만나는 단계 만들기
가상의 물품 접수 앱이라면 품목 이름이 문자열인지만 검사하지 않고 원문 주문과 같은지 대조할 수 있습니다. 불일치는 저장 대기 상태로 보내는 흐름을 제안합니다. 이는 이 글의 설계 예시이며 Google 제품의 실제 화면이나 관측한 오류를 재현한 것이 아닙니다.
스키마로 정할 조건과 앱에서 볼 조건 나누기
필수 필드와 허용 값 등 표현 가능한 조건은 스키마에 적고, 원문 일치 여부 같은 검사는 앱에서 보완합니다. Gemini는 JSON Schema의 일부를 지원하므로 복잡한 규칙이 그대로 적용된다고 가정하지 않습니다. 실제 API 호출과 추출 정확도 시험은 수행하지 않았습니다.
참고 원문: Google Gemini 구조화 출력 공식 문서 · 원문 게시일 상시 문서(게시일 미표기) · 확인일 2026-09-18
AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.
이 글의 검증 카드
- 자료 버전
- Gemini structured outputs 문서, 최종 갱신 2026-09-17 UTC; 2026-09-18 확인; API 실행 미검증
- 확인일
- 2026-09-18
- 검증 상태
- 개발자 주장
- 한계·주의
- 가상 예시이며 API 실행·오류율·모든 스키마 기능의 지원 여부를 시험하지 않았습니다.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.