병렬 도구 호출: 한 번의 왕복
왜 중요한가 "파리, 도쿄, 리마의 날씨가 어때?"라고 물으면 현재 모델은 한 응답에서 도구 세 개를 모두 요청해요. 잘못 답하면 모델이 갈피를 잃거나 도구를 병렬로 부르기를 멈춰요.
돌려보내는 응답의 규칙:
- 콘텐츠가
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는 그대로 두세요: 확인이 그것을 읽어요.
이 연습은 곧 열려요
앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.
이 브라우저가 learn.floati.life의 쿠키를 막고 있어서, 여기서 마친 레슨들이 순서대로 열리지 않아요. 이 사이트의 쿠키를 허용하고 새로고침하세요.