로드 중
로드 중

구조화된 데이터 추출을 위해 상세한 JSON 스키마를 작성하는 것은 AI 도구를 다룰 때 실제로 번거로운 문제가 될 수 있습니다. 복잡한 스키마를 만드는 대신 원하는 데이터 구조를 프롬프트에 직접 지정할 수 있는 영리한 우회 방법이 있습니다.

유연한 스키마 접근 방식

모든 데이터 추출 작업마다 상세한 스키마를 작성하는 대신, 어떤 객체 구조든 받아들이는 to_json이라는 범용 도구 하나를 만들 수 있습니다. 핵심은 입력 스키마가 추가 속성을 허용하도록 설정한 다음, 정확한 요구사항을 프롬프트 자체에 지정하는 것입니다.

to_json의 도구 스펙으로, 입력 스키마에서 "json"의 타입을 "object"로, "additionalProperties"를 True로 설정하여 어떤 JSON이든 받아들입니다.

이 접근 방식은 크고 복잡한 JSON 스키마를 지속적으로 작성하고 관리해야 하는 주요 골칫거리를 없애 줍니다. 전용 스키마만큼 결과가 완벽하지는 않겠지만, 훨씬 적은 설정 작업으로도 여전히 고품질의 JSON 출력을 얻을 수 있습니다.

작동 방식

프로세스는 간단합니다:

  • 어떤 객체 구조든 받아들이는 단일 유연한 스키마를 만듭니다
  • 프롬프트에서 원하는 데이터 구조를 정확히 지정합니다
  • Claude에게 지정한 구조로 to_json 도구를 호출하도록 지시합니다
  • tool_choice를 사용해 Claude가 해당 도구를 사용하도록 강제합니다

프롬프트 설정하기

프롬프트를 작성할 때는 원하는 구조를 매우 명확하게 지정해야 합니다. 다음은 요청을 구성하는 방법의 예시입니다:

Analyze the article below and extract key data. Then call the to_json tool.

<article_text>
{result["text"]}
</article_text>

When you call to_json, pass in the following structure:
{{
    "title": str # title of the article,
    "author": str # author of the article,
    "topics": List[str] # List of topics mentioned in the article
}}

API 호출하기

API 호출은 유연한 스키마를 사용하고 도구 사용을 강제합니다:

python
flexible_result = chat(messages, tools=[to_json_schema], tool_choice="to_json")

손쉬운 구조 변경

데이터 구조를 수정해야 할 때 이 방식의 진정한 장점이 드러납니다. 전체 스키마를 다시 작성하는 대신, 단순히 프롬프트를 업데이트하면 됩니다. 주제 개수를 나타내는 필드를 추가하고 싶으신가요? 한 줄만 추가하면 됩니다:

python
"num_topics": int # Number of topics mentioned

그게 전부입니다 - 스키마 수정이 필요 없습니다.

각 접근 방식을 사용해야 할 때

유연한 스키마 접근 방식은 다음과 같은 경우에 유용합니다:

  • 빠른 프로토타이핑과 실험
  • 단순한 데이터 추출 작업
  • 데이터 요구사항을 자주 변경하는 상황

다음과 같은 경우에는 전용 스키마를 고수하세요:

  • 중요한 프로덕션 데이터 추출 작업
  • 복잡한 중첩 데이터 구조
  • 최대한 높은 정확도가 필요한 경우

유연한 접근 방식은 설정 작업의 10%만으로 약 90%의 품질을 제공하므로, 스키마 관리 부담 없이 구조화된 데이터 추출이 필요한 대부분의 사용 사례에 안성맞춤입니다.