강의 계획 레슨 250개 중 136번째 · 구조화된 출력과 함수/도구 호출
구조화된 출력과 함수/도구 호출

JSON 모드: 해석하고 스키마에 대해 검증하기

LLM이 그 뒤의 시스템 -> 데이터베이스, API, 결제 작업 -> 에 데이터를 넘기길 원하는 순간, 자유로운 산문은 쓸모가 없어요. 구조화된 출력이 필요해요: 모델이 JSON을 돌려주고, 내 코드가 그 JSON을 믿을 수 있는 타입 있는 객체로 바꿔요. 대부분의 모델 API에는 모델이 JSON 문자열을 내게 하는 "JSON 모드"가 있어요. 하지만 "올바른 JSON이다"와 "내가 요청한 객체다"는 서로 다른 거예요. 모델과 내 코드 사이의 경계가 검증하는 곳이에요.

실제 코드에서 모델 호출은 이렇게 생겼어요(보여 주기만 해요 -> 여기서는 어떤 모델도 부르지 않아요):

resp = client.messages.create(model="...", messages=[...])
text = resp.content[0].text          # a JSON string, hopefully
record = parse_and_validate(text, {"name": str, "age": int})

parse_and_validate(text, schema)를 만들어요. schema는 {"name": str, "age": int}처럼 각 필수 필드를 그 Python 타입에 대응시키는 dict예요. 함수는:

  • 글을 Python 객체로 json.loads 해요.
  • 그것이 dict인지 확인해요 -> JSON 배열이나 맨 숫자는 요청한 기록이 아니에요.
  • 스키마의 모든 필드에 대해: 있는지(빠지면 오류) 그리고 올바른 타입인지(어긋나면 오류) 확인해요.
  • 그 필드들만 담은 타입 있는 dict를 돌려줘요.

bool이 int인 함정. Python에서 bool은 int의 하위 클래스라서 isinstance(True, int)가 True예요. JSON true는 Python True로 디코딩돼요. 스키마가 age에 int를 원하는데 모델이 "age": true를 보내면, 순진한 isinstance 확인은 그냥 통과시킬 거예요. 막으세요: 기대하는 타입이 int면 bool 값을 명시적으로 거부하세요.

if expected is int and isinstance(value, bool):
    raise ValueError("age must be int, got bool")

호출하는 쪽이 모델이 무엇을 틀렸는지 정확히 기록할 수 있도록, 분명한 예외(잘못된 필드를 이름 댄 메시지가 있는 ValueError)를 일으키세요. 잘 만들어진 서로 다른 두 페이로드가 둘 다 통과하고, 빠진 필드, 틀린 타입, 슬쩍 들어온 bool이 각각 오류를 일으키도록 만드세요.

내 차례

schema가 {field: type} dict인 parse_and_validate(text, schema)를 쓰세요. 글을 json.loads 하고, dict인지 확인한 다음, 각 스키마 필드가 있고 올바른 타입인지 확인해 타입 있는 dict를 돌려주세요. 빠진 필드와 틀린 타입은 오류를 일으켜야 해요. int가 필요한 곳의 JSON true는 거부하세요(bool이 int인 함정).

이 레슨에서 문제를 발견했나요? 알려 주세요 · 이 레슨에 대해 묻기

이 연습은 곧 열려요

앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.