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

도구 호출을 실행하기 전에 확인하기

왜 중요한가 도구 호출은 모델이 내 코드에게 행동해 달라고 하는 거예요: 예약하고, 결제하고, 지우고. 모델은 대화에서 인자를 채우는데, 그걸 틀릴 수 있어요. "Friday"로, 또는 12명이 앉는 식당에 20명으로 예약을 실행하면 진짜 대가가 따르는 진짜 버그예요.

모델에게 주어진 도구:

{"name": "book_table",
 "input_schema": {"type": "object", "required": ["date", "time", "party_size"],
   "properties": {"date": {"type": "string", "description": "YYYY-MM-DD"},
                  "time": {"type": "string", "description": "HH:MM, 24-hour"},
                  "party_size": {"type": "integer", "description": "1 to 12"}}}}

응답 여섯 개, 각각 실제 모델이 만드는 패턴이에요: 올바른 호출. 날짜가 필요한 곳에 "Friday"가 들어간 호출. 문자열 "2"인 party_size. time을 빠뜨린 호출. 20명 일행(설명은 1에서 12라고 하고, 설명은 부탁이지 보장이 아니에요). 그리고 모델이 먼저 사용자에게 질문해서 도구 호출이 전혀 없는 응답, 이게 올바른 움직임일 때가 많아요.

내 일은 관문이에요: 도구를 실행할지, 모델이 고칠 수 있도록 문제를 돌려보낼지, 질문을 사용자에게 넘길지 정하는 거예요. (도구 정의에 strict: true를 두면 API가 타입과 필수 필드를 보장하지만, 값이 말이 되는지는 보장하지 않아요. 범위와 실제 날짜는 언제나 내가 확인할 몫이에요.)

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

내 차례

gate_booking(reply)를 쓰세요. 응답에 tool_use 블록이 없으면 이은 글과 함께 {"action": "ask_user", "text": ...}를 돌려주세요. 있으면 첫 book_table 호출을 가져와 입력을 확인하세요: 모든 필수 키가 있음. date는 YYYY-MM-DD로 쓴 실제 날짜. time은 시 00에서 23, 분 00에서 59인 HH:MM. party_size는 1에서 12인 진짜 int(문자열도, True도 아님). 모두 통과하면 {"action": "run", "input": ...}를, 아니면 문제마다 메시지 하나씩, 각 메시지가 해당 필드를 말하는 {"action": "fix", "errors": [...]}를 돌려주세요. 시작 코드의 REPLIES는 그대로 두세요: 확인이 그것을 읽어요.

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

이 연습은 곧 열려요

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