블로그

사용 가이드

GLM 5.3 구조화 추출 실전: 모든 JSON 필드에 원문 근거를 부여하기

JSON 객체 모드로 필드 추출하기 — 결측값, 인용, 비즈니스 검증으로 오류를 저장 전에 차단

Nov 18, 2026
진한 파란색 바탕 위에 구리색의 촘촘한 평행 새김선이 밀도가 점차 변하며 겹쳐지고 기하학적 그리드가 더해진, 이 가이드 문서의 커버 이미지
이 페이지에서

구조화 출력에 왜 "원문 근거"가 필요한가

JSON 객체 모드(response_format: {"type": "json_object"})가 해결하는 것은 「출력 형식이 JSON 객체인가」라는 문제이지, 「이번 요청이 반드시 성공하고, 내용이 반드시 완전하며, 파싱이 반드시 예외를 던지지 않는다」는 문제가 아니다. 요청이 실패할 수 있고, 모델이 응답을 거부할 수 있으며, 출력이 길이 제한으로 잘릴 수 있고, 스트리밍 전송이 중단될 수 있으며, 반환 내용이 불완전하거나 잘못된 형식일 수도 있다. 클라이언트는 이러한 상황과 json.loads의 파싱 예외를 반드시 처리해야 한다. 먼저 응답이 정상적으로 완료되었고 내용이 완전한지 확인한 뒤에 파싱에 들어가야 한다. 파싱이 된다고 해서 사용할 수 있는 것도 아니다. 형식이 올바르다는 것이 사실이 올바르다는 것을 의미하지는 않는다. 필드 값이 원문에서 추출된 것인지, 모델이 슬쩍 보완해 넣은 것은 아닌지, 어떤 필드가 「원문에 없음」인지 아니면 「원문에 빈 값으로 적힘」인지는 형식 제약이 커버하는 범위 밖이다.

필드 템플릿을 프롬프트에 적는 것은 본질적으로 모델에게 「양식 작성 템플릿」을 주는 것이지 「증거 목록」을 주는 것이 아니다. 필드에 원문 근거가 없을 때 모델은 그럴듯해 보이는 값을 내놓는 경향이 있는데, 이것이 추출 작업에서 가장 위험한 실패 모드다. 오류를 내지 않고 조용히 하위 데이터를 오염시키기 때문이다.

따라서 이 글의 추출 계약은 세 부분으로 구성된다. 필드와 타입 정의, 각 값에 딸린 원문 인용, 그리고 명시적인 결측값 모델링이다. 이 셋을 합치면 「이 문장이 어디서 왔는가」가 사후 추측이 아니라 출력의 일부가 된다.

개념 도해: 형식의 정돈됨과 의미의 근거는 별개의 문제이며, 추출은 구조화 결과와 원문 지지 조각을 동시에 출력해야 한다.

추출 계약 설계: 필드, 타입, 널 허용 규약

계약은 필드 목록에서 시작한다. 과제가 한 편의 채용/협업 설명에서 구조화 정보를 추출하는 것이라고 가정하고, 먼저 목표 필드를 고정한다.

  • title: 문자열, 필수
  • budget: 숫자, 널 허용
  • deadline: 문자열(ISO 날짜), 널 허용
  • contact: 문자열, 널 허용
  • skills: 문자열 배열, 빈 배열 허용

핵심은 「널 허용」이 「생략 가능」과 같지 않다는 점이다. 모든 필드는 출력에 반드시 등장해야 하며, 알 수 없을 때는 null 또는 빈 배열을 명시적으로 주고 키를 생략해서는 안 된다고 규약한다. 키를 생략하면 하위 시스템이 「모델이 비어 있다고 판단함」과 「모델이 이 필드를 아예 처리하지 않음」을 구분할 수 없게 된다.

타입도 기계가 판정할 수 있는 입자로 좁혀야 한다. budget은 숫자만 받고 "협의 가능" 같은 문자열은 받지 않는다. deadline은 YYYY-MM-DD 형식으로 규약한다. skills는 반드시 문자열 배열이어야 하며 쉼표로 이어 붙인 단일 문자열로 얼버무려서는 안 된다. 타입이 구체적일수록 뒤에 나오는 검증 계층이 문제를 더 잘 막아낼 수 있다.

아래는 프롬프트에 적는 필드 설명이며, 요청 파라미터가 아니다. 요청 파라미터는 JSON 객체 모드를 켜는 역할만 한다.

다음 키를 포함하고 오직 이 키들만 포함하는 JSON 객체를 출력하십시오:
- title: string
- budget: number | null
- deadline: string (YYYY-MM-DD) | null
- contact: string | null
- skills: string[]
모든 키가 반드시 등장해야 합니다. 원문에서 확정할 수 없으면 null(배열은 빈 배열)을 채우고 추측하지 마십시오.

각 필드에 인용 조각을 붙이기

값만 주고 출처를 주지 않는 것은 추적 가능성을 포기하는 것과 같다. 방법은 추출 가능한 각 필드를 값과 인용이 함께 나오는 쌍 구조로 바꾸는 것이다.

{
  "title": {"value": "데이터 분석 인턴", "evidence": "데이터 분석 인턴 2명 채용"},
  "budget": {"value": 300, "evidence": "일급 300위안"},
  "deadline": {"value": null, "evidence": null},
  "contact": {"value": "hr@example.com", "evidence": "이력서는 hr@example.com으로 제출"},
  "skills": [
    {"value": "SQL", "evidence": "SQL 숙련 요구"},
    {"value": "Python", "evidence": "Python 보유자 우대"}
  ]
}

몇 가지 요점이 있다. 첫째, evidence는 원문의 연속 조각이어야 하며 모델의 바꿔 말하기나 요약이 아니어야 한다. 바꿔 말하면 인용이 비교 가치를 잃는다. 둘째, 값이 null이면 evidence도 반드시 null이어야 하며, 이 제약 자체가 어느 정도의 날조를 억제한다. 모델이 값을 지어냈다면 대응하는 원문 조각을 대개 지어낼 수 없어 형식상 모순이 생긴다. 셋째, 배열 필드는 배열 전체에 인용 하나를 주지 말고 요소별로 인용을 주어야 한다. 그렇지 않으면 잘못된 요소 하나가 그룹 전체의 신뢰도를 오염시킨다. 넷째, 인용 조각은 가능한 한 짧게, 해당 값을 지지하는 최소 텍스트만 덮어 이후 문자열 포함 비교를 쉽게 해야 한다.

이렇게 하면 출력 부피는 커지지만, 그 대가로 모든 저장 레코드가 「이 필드는 원문의 어느 문장에 근거하는가」에 답할 수 있게 된다.

개념 도해: 각 값 필드마다 원문 고강조 조각을 되가리키는 인용선이 붙어, 필드와 근거가 일대일로 대응한다.

결측값과 불확실성을 명시적으로 처리하기

추출 작업에서 모델이 가장 자주 저지르는 실수는 잘못 추출하는 것이 아니라 「보완」하는 것이다. 계약 차원에서 세 가지 상황을 분리해 모델링해야 한다.

결측. 원문에 관련 정보가 전혀 없으면 필드에 null을 채운다. 이 의미는 「값이 빈 문자열」과 반드시 구분되어야 한다. 빈 문자열은 추출된 값이고, null은 추출하지 못한 것이다. 상위에서 규약이 명확해야 하위에서 건너뛸지 경고할지 결정할 수 있다.

모호. 원문에 관련 표현이 있지만 확정하기에 부족하다. 예를 들어 「급여 협의 가능」만 적혀 있다면 이때 budget은 null이어야 하며, 프롬프트에 정성적 설명을 숫자로 바꾸지 말고 「협의 가능」을 0으로 매핑하지도 말라고 명시한다.

다중 후보. 원문에 연락처가 두 개 또는 날짜가 두 개 나오는데 계약은 단일 값만 받는다. 이때 선택할 수 있는 방법은 필드 구조가 후보 목록을 지원하게 하거나, 프롬프트에 우선순위(예: 처음 등장한 것 선택)를 규정하는 것이다. 어느 쪽을 택하든 계약에 적어야 한다. 그렇지 않으면 모델이 매번 다른 선택 전략을 써서 결과를 안정적으로 재현하기 어려워진다.

여기에 안전장치를 하나 더한다. 모델이 어떤 필드에도 귀속시키지 못한 핵심 정보를 나열하는 unresolved 배열 출력을 허용하는 것이다. 억지로 어떤 필드에 밀어 넣는 것보다 훨씬 안전하고, 모델의 실패 패턴을 관찰할 수 있는 입구도 열어 준다.

저장 전 세 계층 비즈니스 검증

JSON 객체 모드는 출력 형식만 제약할 뿐 파싱은 여전히 실패할 수 있다. 검증은 순서대로 수행한다. 먼저 응답 완전성을 확인하고, 그다음 클라이언트 구조 검증과 비즈니스 검증을 하고, 마지막으로 근거 대조를 한다. 앞 계층을 통과하지 못하면 다음 계층으로 넘어가지 않는다.

파싱 전에 먼저 확인한다. 요청이 성공적으로 반환되었는지, 응답 거부가 있었는지, 종료 사유가 길이로 인한 절단을 보여주는지, 스트리밍 응답이 정상 종료되었는지, 내용이 비어 있지 않은지. 응답이 정상 완료되고 내용이 완전하다고 확인한 뒤에 json.loads를 실행하며, 파싱 예외는 곧바로 실패 처리로 넘어가고 반쯤 잘린 내용을 이후 검증에 보내지 않는다. 파싱이 성공한 뒤에야 아래 세 계층 검증으로 들어간다.

1계층: 타입과 구조

키가 모두 있는지, 타입이 맞는지, deadline이 날짜 형식을 만족하는지, budget이 유한한 숫자인지. 이 계층은 일반 코드로 충분하고 비용이 낮으며 차단율이 가장 높다.

2계층: 열거와 값 영역

비즈니스상 불가능한 값을 막는다. 금액이 음수인지, 날짜가 오늘보다 이른지, skills에 빈 문자열이나 중복 항목이 있는지, 문자열 길이가 필드 상한을 넘는지. 필드 자체에 통제 어휘(예: 업종, 직급)가 있다면 여기서 화이트리스트 매칭을 하고 동의어 정규화 자리를 마련해 둔다.

3계층: 교차 필드 일관성

단일 필드가 합법이라고 해서 레코드 전체가 성립하는 것은 아니다. 전형적인 검사에는 budget이 비어 있지 않을 때 deadline도 비어 있지 않은지(많은 비즈니스 시나리오에서 둘이 묶여 있음), contact가 skills가 암시하는 직무 유형과 모순되는지, 같은 배치 안에서 같은 title 레코드의 필드 분포가 비정상적으로 몰려 있는지 등이 포함된다. 이 계층은 비즈니스 의미에 가장 가깝고 테스트를 가장 많이 작성해야 하는 곳이다.

evidence에 대한 기계적 검증도 잊지 말자. 값이 비어 있지 않으면 evidence도 비어 있지 않아야 하며, 입력 원문에서 문자열 포함 또는 fuzzy 매칭으로 적중해야 한다. 적중에 실패했다고 해서 반드시 바로 버릴 필요는 없지만, 최소한 낮은 신뢰 표시를 붙여 수동 검토 큐로 보내야 한다.

개념 도해: 세 검증 게이트가 차례로 배치되고, 거부된 조각은 환류 통로를 따라 되돌아가며, 타입, 값 영역, 교차 필드 일관성 검증의 실행 순서에 대응한다.

검증 실패를 다음 라운드 프롬프트로 바꾸기

검증 실패 후 가장 나쁜 방법은 요청을 그대로 다시 보내 이번에는 맞게 추출하기를 기대하는 것이다. 더 좋은 방법은 실패 원인을 구조화해 다시 넣는 것이다.

이전 출력이 검증을 통과하지 못했습니다:
- deadline의 값 "최대한 빨리"가 YYYY-MM-DD 형식에 맞지 않습니다
- skills[2]의 evidence를 원문에서 찾을 수 없습니다
위 문제만 수정하고 나머지 필드는 그대로 유지하여 전체 JSON을 다시 출력하십시오.

세 가지 세부 사항에 주목할 만하다. 첫째, 오류 정보는 구체적인 필드 경로를 가리켜 모델이 전체를 다시 하지 않고 국소 수정을 할 수 있게 해야 한다. 둘째, 「나머지 필드는 그대로 유지」를 명확히 요구해야 한다. 그렇지 않으면 새로운 오류가 끼어들어 하나를 고치면 하나가 망가지는 진동이 생기기 쉽다. 셋째, 재시도 상한(예: 두 라운드)을 정하고 상한을 넘으면 무한 루프 대신 수동 검토 큐로 떨어뜨려야 한다. 무한 재시도는 지연을 늘릴 뿐 아니라 비용도 밀어 올린다.

같은 유형의 오류가 재시도에서 반복된다면 대개 모델의 문제가 아니라 계약이 모호하게 쓰인 탓이다. 이때는 프롬프트를 계속 덧붙이지 말고 필드 정의와 예시를 되돌아봐야 한다.

호출 방식과 이 글의 경계

HiAPI에서 glm-5.3은 OpenAI Chat Completions 호환 프로토콜로 호출하며, JSON 객체 모드를 켜는 방법은 요청에 response_format을 객체 타입으로 설정하는 것이다. 구체적인 파라미터와 필드명은 모델 페이지의 인터페이스 설명을 기준으로 한다. 능력 플래그 jsonObject=true는 모델이 JSON 객체 모드를 지원한다는 뜻이며, 인터페이스가 JSON Schema 응답 모드를 지원한다거나 서버 측 Schema 검증에 의존할 수 있다는 의미는 아니다. 이 글의 필드 구조, 타입, 비즈니스 제약은 모두 클라이언트가 파싱한 뒤 로컬에서 검증한다. 추출 로직, 인용 필드, 검증 계층은 모두 여러분의 서버 측에 작성하며, 모델은 계약에 따라 텍스트를 산출하는 역할만 한다.

이 글은 계약 설계와 검증 흐름만 다루며 과금 수치와 성능 약속은 다루지 않는다. 실시간 가격과 할당량은 사이트 가격 패널을 기준으로 한다. 필드 정의, 인용 검증, 재시도 전략 이 세 가지를 마쳐야 「형식 합법」에서 「의미 사용 가능」으로 나아갈 수 있다. 형식이 올바른 것이 사실이 올바른 것을 의미하지 않고, seed 고정도 완전한 재현을 보장하지 않으므로 재시도 전략에는 여전히 상한과 수동 검토 큐를 함께 두어야 한다.

영구 AI 아티팩트로 빌드 시작하기

API 키를 받아 태스크 기반의 하나의 API로 이미지, 비디오, 오디오 모델을 호출하세요.

API 문서 보기