강의 계획 레슨 250개 중 245번째 · 모델 응답 다루기
모델 응답 다루기

진짜 응답 읽기: 블록과 멈춘 이유

왜 중요한가 이 모듈의 모든 버그는 같은 식으로 시작해요: reply["content"][0]["text"]를 읽고 그게 답이라고 여기는 코드. 현재 모델에서는 첫 블록이 아예 글이 아닌 경우가 많아요.

Claude Messages API의 응답은 dict예요. 답은 블록의 리스트인 content에 있고, 각 블록에는 type이 있어요:

  • "thinking": 모델이 답하기 전에 추론했어요. 현재 모델에서는 이 블록이 흔히 먼저 오고, 기본적으로 그 thinking 글은 비어 있어요(추론은 일어났지만 보이지 않아요).
  • "text": 사용자를 위한 말. 글 블록이 여러 개일 수 있고, 답은 그 전부를 이은 거예요.
  • "tool_use": 모델이 도구를 실행해 달라고 해요(뒤의 레슨들).

콘텐츠 옆에는 모델이 왜 멈췄는지 말하는 stop_reason이 있어요: "end_turn"(끝냄), "max_tokens"(길이 한도에 닿아서, 답이 잘렸거나 아예 없을 수 있음), "tool_use"(도구 결과를 기다림), "refusal"(거절). "stop_sequence"와 "pause_turn" 같은 몇 가지가 더 있으니, "end_turn"이 아닌 건 모두 끝나지 않은 것으로 다루세요. 콘텐츠를 믿기 전에 늘 확인하세요.

{'id': 'msg_01',
 'type': 'message',
 'role': 'assistant',
 'model': 'claude-opus-5-5',
 'content': [{'type': 'thinking', 'thinking': '', 'signature': 'EuYBCkQYAiJA...'},
             {'type': 'text',
              'text': 'A context window is the amount of text a model can read at once.'}],
 'stop_reason': 'end_turn',
 'stop_sequence': None,
 'usage': {'input_tokens': 412, 'output_tokens': 60}}

이 응답들에 대해: 시뮬레이션이에요. 각각은 Claude Messages API가 돌려주는 정확한 모양(콘텐츠 블록, stop_reason, usage)으로 이 강좌를 위해 썼고, 각각 실제 모델이 하는 무언가를 본떴어요. 살아 있는 모델의 녹화가 아니라서 정확한 문구는 우리가 쓴 것이지만, 모양과 문제는 내 코드가 만날 진짜예요.

내 차례

다른 모든 블록 타입은 건너뛰고 글 블록을 전부 순서대로 이어 돌려주는(없으면 빈 문자열) reply_text(reply)를 쓰세요. stop_reason이 "end_turn"일 때만 True를 돌려주는 finished(reply)를 쓰세요. 시작 코드의 REPLIES는 그대로 두세요: 확인이 그것을 읽어요.

이 레슨에서 문제를 발견했나요? 알려 주세요 · 이 레슨에 대해 묻기

이 연습은 곧 열려요

앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.