Schema 설계

/extract에 전달하는 schema는 프롬프트이기도 합니다. 모든 필드명, description, 타입 힌트를 모델이 읽습니다. 잘 다듬어진 schema는 정확도를 극적으로 끌어올립니다.

필드 네이밍

영어처럼 읽히는 이름을 사용하세요. 모델은 pn이나 name1보다 productName을 훨씬 잘 다룹니다.

{ "type": "object", "properties": {
  "productName": { "type": "string" },
  "currentPrice": { "type": "number" }
} }

필드 description

모호한 모든 항목에 description을 추가하세요. "price"는 MSRP일 수도, 현재가일 수도, 단가일 수도 있습니다 —— 명시적으로 작성하세요:

{ "currentPrice": {
  "type": "number",
  "description": "Final price after discount, in USD"
} }

Required vs optional

정말 필요한 필드만 표시하세요. Required 필드는 모델이 찾지 못하면 추출 전체를 실패시키므로 —— 신중하게 사용하세요.

중첩

유용한 곳에서는 한 단계 중첩이 좋습니다(address.city). 더 깊은 중첩(3단계 이상)은 추출 품질을 해치는 경향이 있습니다.

흔한 함정

• 모호한 타입 사용("$19.99" 같은 숫자에 string 사용) —— number를 선호하고 모델이 파싱하게 두세요
• description 없는 모호한 enum
• 모든 페이지에 실제로는 존재하지 않는 required 필드

이 페이지는 schema 쿡북으로 확장 중입니다 —— 곧 다시 확인하세요.