Claude가 도구를 여러 개 요청했다면 결과도 다음 메시지에 함께 모으기

한 장의 그림으로 이해하기

개념 비유다. 왼쪽 담당자는 삼각형 표시 자료만 쟁반에 담고 원형 표시 자료는 책상에 남겨 둔다. 로봇 앞 두 표식은 요청했던 두 자료를 나타낸다. 오른쪽 담당자는 두 종류 자료를 한 쟁반에 모아 전달한다. 표식은 각각의 호출 식별자, 자료는 도구 결과, 한 쟁반은 다음 user 메시지에 담은 결과 묶음에 대응한다. 물리적인 폴더나 쟁반을 쓰는 제품 기능은 아니다. 그림은 모두 성공한 가상 상황을 단순화하며 실패·미실행도 해당 호출의 오류 결과로 반환해야 한다. 함께 반환한다는 규칙은 동시 실행 의무나 최종 답의 정확성 보장이 아니다.
내용의 흐름을 표현한 설명용 그림입니다. 실제 제품 화면이나 실행 결과가 아닙니다.
그림 크게 보기 ↗ (새 탭)

업무·자동화 · 판정 관망

그림을 글로 풀면

요청별 결과를 한 메시지에

여러 도구 호출의 결과를 빠짐없이 모아 다음 응답으로 돌려줍니다.

대상
Claude 도구 연결 자동화를 만드는 개발자
무엇이 바뀜
각 결과는 tool_use_id로 해당 요청과 연결합니다.
왜 중요한가
먼저 끝난 하나만 보내면 다른 결과를 빠뜨릴 수 있습니다.
지금 할 일
호출 목록과 결과 목록을 대조하고 한 묶음으로 반환합니다.
한계·미확인
클라이언트 도구 기준 개념 비유입니다. 동시 실행 의무·API 시험 없음.
공식 출처
platform.claude.com
확인일
2026-09-24

먼저 끝난 조회 하나만 넘기지 않기

가상의 업무 도우미가 재고와 배송 상태를 각각 요청했다고 생각해 봅니다. 재고 조회가 먼저 끝났다는 이유만으로 다음 대화를 시작하면 배송 결과가 빠질 수 있습니다. 그림의 한 쟁반은 실행 속도를 뜻하지 않습니다. 다음 메시지를 만들기 전에 요청된 결과를 모두 연결했는지 확인하는 지점입니다.

실행 순서와 반환 형식을 분리하기

Claude 공식 문서에 따르면 한 응답에는 여러 tool_use 블록이 들어갈 수 있습니다. 실행을 동시에 할지 순서대로 할지는 연결한 도구의 특성에 맞게 정합니다. 반환할 때는 각 호출에 해당하는 tool_result를 모두 다음 user 메시지에 넣고, tool_use_id로 연결해야 합니다. 그 메시지에 설명 텍스트도 넣는다면 결과 블록들 뒤에 둡니다. 이 글은 클라이언트 도구 결과를 설명하며 서버 도구의 별도 흐름은 다루지 않습니다.

실패하거나 실행하지 않은 요청도 빠뜨리지 않기

공식 문서는 실행하지 않은 호출에도 이유를 담고 is_error를 참으로 설정한 결과를 반환하도록 설명합니다. 이 글에서는 호출 식별자 목록과 결과 식별자 목록을 대조해 누락·중복을 찾는 검증을 제안합니다. 부작용이나 순서 의존성이 있는 작업은 한꺼번에 실행해도 된다는 뜻으로 읽지 마세요. 이번 제작에서는 실제 도구나 API를 실행하지 않았고, 모든 결과를 모았다는 사실도 최종 답의 정확성을 보장하지 않습니다.

참고 원문: Anthropic Claude 공식 문서 — 여러 도구 호출의 실행과 결과 메시지 · 원문 게시일 상시 문서(게시일 별도 미표기) · 확인일 2026-09-24

AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.

이 글의 검증 카드

자료 버전
Claude Messages API Parallel tool use 상시 문서·2026-09-24 확인. tool_use_id 연결 및 next user message의 결과 묶음. API 실행 없음
확인일
2026-09-24
검증 상태
개발자 주장
한계·주의
클라이언트 도구 기준 개념 비유입니다. 동시 실행 의무·API 시험 없음.

함께 더 정확하게

질문·오류 제보

그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.

공개된 질문·제보

    아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.