---
title: "병렬 도구 호출이란? 한 번의 응답에 여러 함수 호출 | BroadRouter"
description: "병렬 도구 호출은 모델이 한 번의 응답에서 여러 함수를 요청하게 합니다. parallel_tool_calls의 동작, 결과를 돌려보내는 방법, 끄는 방법을 정리했습니다."
url: https://broadrouter.com/ko/glossary/parallel-tool-calls/
lang: ko
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

이 페이지는 영어 원문을 AI의 도움을 받아 번역했습니다. [영어 원문 읽기](https://broadrouter.com/glossary/parallel-tool-calls/) (2026-11-15 업데이트).

# 병렬 도구 호출(parallel tool calls)

업데이트 2026-11-15

병렬 도구 호출(parallel tool calls)은 모델이 한 번의 응답에서 도구 호출을 둘 이상 반환하는 것입니다. 예를 들어 파일 세 개를 한꺼번에 읽습니다. OpenAI 형식에서는 tool\_calls의 여러 항목으로 오며, parallel\_tool\_calls를 false로 설정하면 턴당 호출이 0개나 1개로 제한됩니다.

다른 이름: 병렬 함수 호출, 병렬 툴 호출, 다중 도구 호출, 여러 도구 동시 호출, parallel tool calling, parallel function calling, parallel\_tool\_calls, multiple tool calls

파일 세 개가 필요한 에이전트가 왕복 한 번에 하나씩 요청할 필요는 없습니다. 병렬 도구 호출을 쓰면 모델이 세 개를 한꺼번에 요청합니다.

## 작동 방식

[도구 호출](https://broadrouter.com/ko/glossary/tool-calling/) 응답에서 `message.tool_calls`는 리스트입니다. 병렬 호출에서는 항목이 둘 이상이며, 각 항목에 고유한 `id`, 함수 이름, JSON 인수가 있습니다.

```json
"tool_calls": [
  {"id": "call_1", "type": "function", "function": {"name": "read_file", "arguments": "{\"path\": \"a.py\"}"}},
  {"id": "call_2", "type": "function", "function": {"name": "read_file", "arguments": "{\"path\": \"b.py\"}"}}
]
```

내 코드가 호출을 실행하고, 호출마다 해당 `tool_call_id`를 담은 `tool` 메시지를 하나씩 추가한 뒤 모델을 다시 호출합니다.

-   **OpenAI:** `parallel_tool_calls`의 기본값은 `true`입니다. `false`로 설정하면 “ensures exactly zero or one tool is called.”(번역: 정확히 0개 또는 1개의 도구만 호출되도록 보장합니다) 가이드는 특정 모델 스냅샷이 같은 도구를 반복 호출하는 경우가 있었다며, 그 모델에서는 이 기능을 끄라고 권합니다.
-   **Anthropic:** 병렬 사용이 기본으로 켜져 있습니다. [tool\_choice](https://broadrouter.com/ko/glossary/tool-choice/) 객체 안에서 `disable_parallel_tool_use: true`로 끕니다. Anthropic은 API가 “doesn’t prescribe an execution order”(번역: 실행 순서를 규정하지 않는다)고 하며, 병렬 처리가 계속 동작하려면 모든 도구 결과를 하나의 사용자 메시지로 돌려보내야 한다고 설명합니다.

## 왜 중요한가

-   **지연 시간.** 모델과의 왕복이 줄어듭니다. 서로 독립적인 읽기 전용 도구는 내 쪽에서 동시에 실행할 수 있습니다.
-   **순서.** 쓰기 후 읽기처럼 부수 효과가 있는 호출은 서로 의존할 수 있습니다. Anthropic은 이런 호출을 순차적으로 실행하라고 제안합니다. 아니면 기능을 끄세요.
-   **관리.** 모든 호출에는 올바른 ID의 결과가 있어야 합니다. 결과가 하나 빠지면 다음 요청이 실패하는 경우가 많습니다.

## BroadNet Inference에서는

BroadNet [API 레퍼런스](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-glossary-parallel-tool-calls&utm_content=body)는 [GLM 5.3](https://broadrouter.com/ko/models/glm-5.3/)과 [Qwen3.8 27B](https://broadrouter.com/ko/models/qwen3.8-27b/)의 도구 호출을 문서화하지만 `parallel_tool_calls`는 문서화하지 않습니다. 내 프롬프트에 여러 호출이 반환되는지, `false`가 반영되는지 테스트하세요. 병렬 호출은 한 번의 응답으로 오므로 요청 수에 더해지지 않습니다. 도구 실행은 내 쪽에서 합니다. 참고로 BroadNet 무제한 [플랜](https://broadrouter.com/ko/plans/) 세션은 한 번에 요청 하나만 허용하며 DeepSeek V4.1 Flash 전용입니다. 종량제 키의 [동시 처리](https://broadrouter.com/ko/glossary/concurrency/) 한도는 동시 처리 요청 4개입니다. 동작하는 루프는 [오픈 모델 도구 호출 글](https://broadrouter.com/ko/blog/tool-calling-open-models/)에 있습니다.

## 흔한 실수

-   호출마다 다른 메시지 형식으로 결과를 돌려보내거나, 결과 하나를 빠뜨리는 것.
-   모델이 함께 나열했다는 이유로 서로 의존하는 도구를 동시에 실행하는 것.

## 자주 묻는 질문

### 병렬 도구 호출은 병렬 API 요청을 뜻하나요?

아닙니다. 모델은 한 번의 응답에서 여러 호출을 반환합니다. 내 코드가 이를 동시에 또는 하나씩 실행하고, 다음 요청에서 모든 결과를 돌려보냅니다.

### 병렬 도구 호출은 어떻게 끄나요?

OpenAI 형식에서는 parallel\_tool\_calls를 false로 설정하세요. OpenAI는 이 설정이 "ensures exactly zero or one tool is called"(번역: 정확히 0개 또는 1개의 도구만 호출되도록 보장한다)고 설명합니다. Anthropic API에서는 tool\_choice 안에서 disable\_parallel\_tool\_use를 true로 설정하세요.

### BroadNet Inference는 parallel\_tool\_calls를 지원하나요?

BroadNet API 레퍼런스에는 parallel\_tool\_calls가 문서화되어 있지 않습니다. 도구 호출은 GLM 5.3과 Qwen3.8 27B에 문서화되어 있으니, 여러 호출을 반환하는지와 이 플래그가 반영되는지 테스트하세요.

## 함께 보기

-   [도구 호출(tool calling)](https://broadrouter.com/ko/glossary/tool-calling/) (용어)
-   [tool\_choice(도구 선택 파라미터)](https://broadrouter.com/ko/glossary/tool-choice/) (용어)
-   [AI 에이전트(AI agent)](https://broadrouter.com/ko/glossary/agent/) (용어)
-   [동시 처리(concurrency)](https://broadrouter.com/ko/glossary/concurrency/) (용어)
-   [지연 시간(latency)](https://broadrouter.com/ko/glossary/latency/) (용어)
-   [ReAct(추론과 행동, reason and act)](https://broadrouter.com/ko/glossary/react-agent/) (용어)
-   [요청 타임아웃(request timeout)](https://broadrouter.com/ko/glossary/request-timeout/) (용어)
-   [오픈 모델 도구 호출: 스키마, 병렬 호출, 재시도](https://broadrouter.com/ko/blog/tool-calling-open-models/) (글)
-   [멀티 에이전트 구성의 실제 비용: 토큰당 과금 vs 정액 세션](https://broadrouter.com/ko/blog/multi-agent-cost/) (글)

실제 워크로드로 테스트해 보세요. 신규 계정에는 US$5 상당의 초기 크레딧이 제공되며 Gemma 및 음성 전사에 사용할 수 있습니다. DeepSeek, GLM 및 Qwen3.8 모델은 충전이 필요합니다.

[시작하기](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-glossary-parallel-tool-calls&utm_content=page-cta) ·

**출처**

-   [OpenAI API 레퍼런스, create chat completion(parallel\_tool\_calls)(2026-11-15 확인)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [OpenAI, 함수 호출 가이드(병렬 함수 호출)(2026-11-15 확인)](https://developers.openai.com/api/docs/guides/function-calling)
-   [Anthropic 문서, 병렬 도구 사용(2026-11-15 확인)](https://platform.claude.com/docs/en/agents-and-tools/tool-use/parallel-tool-use)
