Gemini JSON, 값까지 검증하는 법

Gemini가 JSON을 반환해도 바로 저장하지 말고, 스키마 검사 뒤에 실제 값과 원문을 대조하세요. 구조화된 출력은 응답 형식을 맞추는 기능이지, 내용의 정확성을 대신 확인하는 기능은 아닙니다.

JSON 형식 검사와 값 검증을 나눈 AI 생성 개념도입니다. 실제 서비스 화면이 아닙니다.

요청에는 필드의 뜻을 적습니다

예를 들어 일정 문장에서 날짜를 추출한다면 date는 날짜, evidence는 그 날짜가 나온 원문 구절로 나눌 수 있습니다. 날짜가 없는 경우의 처리도 정하세요. 임의 날짜로 채우지 않고 null을 반환하도록 스키마와 설명을 함께 설계하는 방식입니다.

가상 입력: ‘교육은 2026년 10월 30일에 시작합니다.’
가상 출력: date = 2026-10-30, evidence = 교육은 2026년 10월 30일에 시작합니다.

이 값은 API 실행 결과가 아니라 검증 방식을 설명하는 예시입니다.

저장 전에 두 번 확인합니다

먼저 date가 허용한 자료형인지, 필요한 필드가 빠지지 않았는지 검사합니다. 그다음 날짜가 실제 달력에 존재하는지, evidence가 입력 원문에 있는지, 그 문장이 같은 날짜를 가리키는지 확인합니다. 문자열 형식이 맞아도 다른 날짜를 추출했다면 저장 대상에서 제외해야 합니다.

검증에 실패한 결과는 자동 일정 등록이나 후속 실행으로 넘기지 말고, 원문과 실패 이유를 확인할 수 있게 보류하세요. 반복 호출만으로 정답이 보장되지는 않습니다.

Google 공식 문서의 ‘검증’과 ‘오류 처리’ 항목입니다. 본문 부분 크롭, 내용 변경 없음. 2026-10-23 확인.

Google 공식 원문 · CC BY 4.0

스키마의 모든 조건이 강제되지는 않습니다

Google의 현재 문서는 minLength·maxLength와 uniqueItems 등 일부 조건이 서버에서 무시된다고 안내합니다. 길이 제한이나 배열 중복 제거가 필요하면 애플리케이션에서 별도로 검사해야 합니다.

공식 문서의 Best practices와 Limitations를 함께 확인하세요. 이 글은 2026년 10월 23일 공식 문서를 확인해 정리한 적용 방법입니다.

필드 자체가 누락된다면 JSON 필수 항목 검사 방법부터 확인하세요.