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

병렬 도구 호출: 한 번의 왕복

왜 중요한가 "파리, 도쿄, 리마의 날씨가 어때?"라고 물으면 현재 모델은 한 응답에서 도구 세 개를 모두 요청해요. 잘못 답하면 모델이 갈피를 잃거나 도구를 병렬로 부르기를 멈춰요.

돌려보내는 응답의 규칙:

  • 콘텐츠가 tool_result 블록의 리스트인 user 메시지 하나, 모든 tool_use 블록마다 하나씩, 같은 순서로. 여러 메시지로 나누면 모델에게 병렬로 묻기를 그만두라고 가르치는 셈이에요.
  • 각 결과는 그 호출의 id를 tool_use_id로 되울려요.
  • 실패한 도구도 결과를 받아요: is_error: true와 짧은 메시지로, 모델이 설명하거나 다른 방법을 시도할 수 있게요. 결코 빼먹지 말고, 실패한 도구 하나가 차례 전체를 멈추게 하지 마세요.
  • 모델이 지어낸 도구(레지스트리에 없는)도 오류 결과이고, 실행해 볼 대상이 결코 아니에요.

(이 메시지가 돌아가기 전에, thinking을 포함한 모든 블록이 있는 모델 자신의 응답이 대화에 그대로 덧붙여져요.)

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

내 차례

tools가 이름을 함수에 대응시키는 tool_results(reply, tools)를 쓰세요. tool_use 블록마다 블록 하나씩, 순서대로 {"role": "user", "content": [...]}를 돌려주세요: 도구가 실행되면 {"type": "tool_result", "tool_use_id": ..., "content": str(result), "is_error": False}, 실행되지 않았으면 is_error: True와 콘텐츠 "unknown tool: NAME" 또는 "error: MESSAGE"(예외의 메시지). 시작 코드의 REPLIES와 TOOLS는 그대로 두세요: 확인이 그것을 읽어요.

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

이 연습은 곧 열려요

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