로드 중
로드 중

Claude가 JSON, Python 코드, 또는 글머리 기호 목록과 같은 구조화된 데이터를 생성하도록 해야 할 때, 자주 흔한 문제에 부딪히게 됩니다. Claude는 도움이 되고자 콘텐츠 주변에 설명 텍스트를 추가하고 싶어합니다. 대부분의 경우 이는 훌륭하지만, 때로는 다른 것 없이 원시 데이터만 필요할 때가 있습니다.

EventBridge Rule Generator 앱: "EC2 인스턴스를 모니터링하는 규칙"이라는 입력, Generate 버튼, 그리고 복사 버튼이 있는 깔끔한 JSON.

AWS EventBridge 규칙을 생성하는 웹 앱을 만든다고 가정해 보겠습니다. 사용자가 설명을 입력하고 generate를 클릭하면, 즉시 복사하여 사용할 수 있는 깔끔한 JSON을 보게 될 것으로 기대합니다. Claude가 설명적인 헤더와 푸터가 포함된 마크다운 코드 블록으로 감싸진 JSON을 반환하면, 사용자는 단순히 "모두 복사"를 누를 수 없고 JSON 부분만 수동으로 선택해야 합니다.

Claude에게 JSON 형식의 사용자 프로필, 작업의 글머리 기호 목록, 데이터 분석을 위한 Python을 요청하면 해당 내용만 반환합니다.

이 패턴은 구조화된 데이터를 생성할 때마다 나타납니다. Claude는 자연스럽게 자신의 작업을 설명하고 싶어하지만, 많은 경우 요청한 콘텐츠만 원하고 그 외에는 아무것도 원하지 않습니다.

Claude에게 JSON 형식의 사용자 프로필, 작업의 글머리 기호 목록, 데이터 분석을 위한 Python을 요청하면 해당 내용만 반환합니다.

Stop Sequence와 Assistant 메시지 프리필링 결합하기

이 해결책은 우리가 다뤘던 두 가지 기법, 즉 stop sequence와 assistant 메시지 프리필링을 결합합니다. 실제로 어떻게 작동하는지 살펴보겠습니다:

python
messages = []

add_user_message(messages, "Generate a very short event bridge rule as json")
add_assistant_message(messages, "```json")

text = chat(messages, stop_sequences=["```"])

이 코드를 실행하면, 마크다운 형식이나 추가 설명 없이 순수한 JSON 콘텐츠만 반환받게 됩니다.

내부적으로 작동하는 방식

Stop sequence와 json 블록을 여는 프리필된 assistant 메시지는 Claude가 설명이 아닌 JSON만 작성하도록 만듭니다.

Claude가 요청을 처리할 때 일어나는 일은 다음과 같습니다:

  1. Claude는 사용자 메시지를 읽고 "전체 규칙을 작성하고 아마 그것을 설명해야겠다"라고 생각합니다
  2. 프리필된 assistant 메시지를 보고 이미 JSON 마크다운 블록을 작성하기 시작했다고 가정합니다
  3. Claude는 "아, 이미 JSON 부분을 시작했으니, 실제 JSON 콘텐츠만 작성하면 되겠다"라고 생각합니다
  4. JSON 콘텐츠를 생성합니다
  5. Claude가 마크다운 블록을 ```로 닫으려고 할 때, stop sequence에 도달하여 생성이 즉시 중단됩니다

결과적으로 프리필된 시작 부분과 stop sequence 사이의 모든 내용, 즉 원하던 콘텐츠 그대로를 얻게 됩니다.

출력 정리하기

반환된 텍스트에는 약간의 추가 줄바꿈이 있을 수 있지만, 쉽게 정리할 수 있습니다:

python
import json

# JSON으로 파싱하여 유효성 검사 및 포맷 적용
parsed_json = json.loads(text.strip())

이 기법은 JSON뿐만 아니라 모든 구조화된 데이터 형식에 적용됩니다. Python 코드, 글머리 기호 목록, 또는 다른 특정 콘텐츠 형식을 생성하든, assistant 메시지 프리필링을 사용하여 응답을 시작하고 stop sequence를 사용하여 원하는 정확한 지점에서 끝낼 수 있습니다.

이 접근 방식은 Claude의 출력 형식을 정밀하게 제어할 수 있게 해주어, 후속 처리에 방해가 될 수 있는 추가 형식이나 설명 없이 애플리케이션이 깔끔하고 사용 가능한 데이터를 얻을 수 있도록 보장합니다.