로드 중
로드 중

Claude가 JSON, Python 코드, 또는 글머리 기호 목록과 같은 구조화된 데이터를 생성하도록 해야 할 때, 흔히 겪는 문제가 있습니다. 바로 Claude가 도움을 주려는 마음에 콘텐츠 주변에 설명 텍스트를 추가하려고 한다는 점입니다. 대부분의 경우 이는 훌륭하지만, 때로는 다른 것 없이 순수한 데이터만 필요할 때가 있습니다.

AWS EventBridge 규칙을 생성하는 웹 앱을 만든다고 생각해 보세요. 사용자는 설명을 입력하고 생성 버튼을 클릭하여 즉시 복사해 사용할 수 있는 깔끔한 JSON을 기대합니다. Claude가 설명 텍스트와 함께 마크다운 코드 블록으로 감싼 JSON을 반환하면, 사용자는 전체 응답을 그냥 복사할 수 없습니다. JSON 부분만 수동으로 선택해야 합니다.

EventBridge Rule Generator 앱: "Rule to monitor EC2 instances"라는 입력, Generate 버튼, 복사 버튼이 있는 깔끔한 JSON.

기본 응답의 문제점

기본적으로 Claude에게 JSON을 생성하도록 요청하면 다음과 같은 결과를 얻게 될 수 있습니다.

markdown
```json
{
  "source": ["aws.ec2"],
  "detail-type": ["EC2 Instance State-change Notification"],
  "detail": {
    "state": ["running"]
  }
}
```

This rule captures EC2 instance state changes when instances start running.

JSON 자체는 올바르지만, 마크다운 서식으로 감싸져 있고 설명 텍스트가 포함되어 있습니다. 사용자가 순수한 JSON을 복사해야 하는 웹 앱의 경우, 이는 사용자 경험에 마찰을 일으킵니다.

해결책: 어시스턴트 메시지 사전 입력 + 정지 시퀀스

어시스턴트 메시지 사전 입력과 정지 시퀀스를 결합하면 원하는 콘텐츠만 정확히 얻을 수 있습니다. 정지 시퀀스란 Claude가 그것을 생성하는 즉시 응답을 종료시키는 문자열입니다. 먼저 chat 함수가 정지 시퀀스의 목록을 받도록 해 보겠습니다.

python
def chat(messages, system=None, temperature=1.0, stop_sequences=[]):
    params = {
        "model": model,
        "max_tokens": 1000,
        "messages": messages,
        "temperature": temperature
    }
    if system:
        params["system"] = system
    if stop_sequences:
        params["stop_sequences"] = stop_sequences

    message = client.messages.create(**params)
    return message.content[0].text

두 가지가 함께 작동하는 방식은 다음과 같습니다.

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=["```"])

이 기법은 다음과 같이 작동합니다.

  1. 사용자 메시지가 Claude에게 무엇을 생성할지 알려줍니다
  2. 사전 입력된 어시스턴트 메시지는 Claude가 이미 마크다운 코드 블록을 시작했다고 생각하게 만듭니다
  3. Claude는 이어서 JSON 콘텐츠만 작성합니다
  4. Claude가 코드 블록을 ```로 닫으려고 하는 순간, 정지 시퀀스가 즉시 생성을 종료합니다

json 블록을 여는 정지 시퀀스와 사전 입력된 어시스턴트 메시지로 인해 Claude가 설명 없이 JSON만 작성합니다.

결과는 추가 서식이 없는 깔끔한 JSON입니다.

json
{
  "source": ["aws.ec2"],
  "detail-type": ["EC2 Instance State-change Notification"],
  "detail": {
    "state": ["running"]
  }
}

응답 처리하기

응답에서 불필요한 줄바꿈 문자가 몇 개 보일 수 있습니다. 이는 쉽게 처리할 수 있습니다.

python
import json

# JSON을 정리하고 파싱합니다
clean_json = json.loads(text.strip())

JSON을 넘어서

이 기법은 JSON 생성에만 국한되지 않습니다. 설명 없이 구조화된 데이터가 필요할 때마다 언제든지 사용하세요.

  • Python 코드 스니펫
  • 글머리 기호 목록
  • CSV 데이터
  • 콘텐츠 자체만 원하고 설명은 필요 없는 모든 형식의 콘텐츠

핵심은 Claude가 자연스럽게 콘텐츠를 감싸려고 하는 방식이 무엇인지 파악한 다음, 그것을 사전 입력과 정지 시퀀스로 사용하는 것입니다. 코드의 경우 보통 마크다운 코드 블록입니다. 목록의 경우 다른 서식 마커일 수 있습니다.

이 접근 방식을 사용하면 Claude의 출력 형식을 정밀하게 제어할 수 있어, 깔끔하고 구조화된 데이터가 필수적인 애플리케이션에 AI가 생성한 콘텐츠를 훨씬 더 쉽게 통합할 수 있습니다.