Pydantic·Zod 스키마가 계약이야

스키마 하나를 여러 소비자가 나눠 써

출력 스키마는 JSON Schema로 내보내 프롬프트에 들어가고, Pydantic이나 Zod 검증기가 읽으며, TypeScript·Python 코드의 형식과 시험 자료, API 문서에도 쓰여. 기준은 하나만 두고 나머지는 모두 거기서 만들어야 해.

한 줄기로 연결하는 법

Python이면 Pydantic, TypeScript면 Zod에서 원본 스키마를 작성해.
model_json_schema()나 zodToJsonSchema로 JSON Schema를 만들어.
그 JSON Schema를 구조화 출력 명세로 프롬프트에 넣어.
응답도 같은 Pydantic이나 Zod 모델로 검증해.
소비자 코드의 형식 역시 같은 원본에서 만들어.

어긋남이 장애가 아니라 빌드 오류가 돼

스키마를 바꾸면 의존하는 계층이 컴파일 단계에서 깨져 무엇을 고쳐야 하는지 보여줘. 단일 기준이 없으면 프롬프트는 옛 모양을 요구하고 코드는 새 모양을 기다리는 불일치가 조용히 쌓이다 실행 중 장애로 터져.

Code

Pydantic → JSON Schema → 프롬프트·python

from pydantic import BaseModel, Field
from typing import Literal

class Verdict(BaseModel):
    verdict: Literal["approve", "reject", "hold"]
    reason_codes: list[Literal["low_confidence", "missing_evidence", "policy_block", "ok"]] = Field(min_length=1, max_length=3)

schema = Verdict.model_json_schema()
response_format = {"type": "json_schema", "json_schema": {"name": "verdict", "strict": True, "schema": schema}}

resp = client.chat.completions.create(model="gpt-5.5", messages=msgs, response_format=response_format)
parsed = Verdict.model_validate_json(resp.choices[0].message.content)

스키마 하나를 여러 소비자가 나눠 써

한 줄기로 연결하는 법

어긋남이 장애가 아니라 빌드 오류가 돼

Code

External links

Exercise

Progress

댓글 0