---
title: "tool_choice란? LLM 도구 호출을 강제하거나 막는 방법 | BroadRouter"
description: "tool_choice는 모델이 도구를 호출해도 되는지, 꼭 호출해야 하는지, 호출하면 안 되는지, 어떤 도구를 호출할지를 정합니다. OpenAI와 Anthropic의 옵션과 강제 호출이 유용한 경우를 정리했습니다."
url: https://broadrouter.com/ko/glossary/tool-choice/
lang: ko
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# tool\_choice(도구 선택 파라미터)

업데이트 2026-11-15

tool\_choice는 도구 사용을 제어하는 요청 파라미터입니다. OpenAI Chat Completions에서는 auto(모델이 결정), required(도구를 하나 이상 반드시 호출), none(도구 사용 안 함), 또는 강제할 함수 이름을 지정할 수 있습니다. Anthropic의 대응 옵션은 auto, any, tool, none입니다.

다른 이름: 툴 초이스, 도구 선택, 강제 도구 호출, 함수 호출 강제, tool\_choice, tool choice, forced tool call, forced function call

[도구 호출](https://broadrouter.com/ko/glossary/tool-calling/)은 모델이 내 코드에 함수 실행을 요청하게 해 줍니다. tool\_choice는 그 호출이 선택인지, 필수인지, 꺼져 있는지를 정합니다.

## 작동 방식

`tools`(함수 이름, 설명, [JSON Schema](https://broadrouter.com/ko/glossary/json-schema/) 파라미터)를 보내고, 필요하면 `tool_choice`도 함께 보냅니다.

| OpenAI 값 | 의미 | Anthropic 대응 값 |
| --- | --- | --- |
| `"auto"` | 모델이 메시지나 하나 이상의 호출을 선택. 도구를 보내면 기본값 | `{"type": "auto"}` |
| `"required"` | “The model must call one or more tools”(번역: 모델은 도구를 하나 이상 호출해야 함) | `{"type": "any"}` |
| `{"type": "function", "function": {"name": "get_weather"}}` | 해당 도구 하나를 강제 | `{"type": "tool", "name": "get_weather"}` |
| `"none"` | 도구 호출 없음. 도구가 없으면 기본값 | `{"type": "none"}` |

OpenAI의 함수 호출 가이드는 전체 도구 목록은 그대로 두면서 호출을 일부 도구로 제한하는 allowed-tools 옵션도 설명하며, 프롬프트 캐싱을 위해 이 방식을 권합니다.

```json
{"model": "broadnet/glm-5.3",
 "messages": [{"role": "user", "content": "Weather in Riyadh?"}],
 "tools": [{"type": "function", "function": {"name": "get_weather",
   "parameters": {"type": "object", "properties": {"city": {"type": "string"}},
                  "required": ["city"]}}}],
 "tool_choice": {"type": "function", "function": {"name": "get_weather"}}}
```

Anthropic 문서에 따르면 `any`나 `tool`을 쓰면 API가 답변을 미리 채우기(prefill) 때문에 모델은 호출 전에 텍스트를 쓰지 않으며, 일부 Claude 모델은 도구 사용 강제를 거부하고 400 오류를 반환합니다.

## 왜 중요한가

-   **안정적인 파이프라인.** 반드시 호출로 끝나야 하는 추출 단계에 수다스러운 텍스트 답변이 와서는 안 됩니다. 호출을 강제하면 그 분기 자체가 사라집니다.
-   **안전한 턴.** 마지막 요약 턴에 `none`을 지정하면 같은 도구 목록을 유지하면서도 모델이 도구 호출을 한 번 더 시작하지 못하게 막을 수 있습니다.
-   **캐싱.** Anthropic은 `tool_choice`를 바꾸면 캐시된 메시지 블록이 무효화된다고 말하므로, 가능하면 턴 사이에 일정하게 유지하세요.

## BroadNet Inference에서는

BroadNet의 [API 레퍼런스](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-glossary-tool-choice&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/)의 도구 호출만 문서화하며, `tool_choice`는 다루지 않습니다. 사용할 값은 모두 테스트하세요. `required`나 함수 이름을 보내고 답변에 `tool_calls`가 들어 있는지 확인하면 됩니다. 강제가 제대로 동작하지 않으면 `auto`와 명확한 지시를 함께 쓰고 결과를 검증하거나, 같은 모델에서 [구조화된 출력](https://broadrouter.com/ko/glossary/structured-output/)을 쓰세요. [오픈 모델 도구 호출 글](https://broadrouter.com/ko/blog/tool-calling-open-models/)에 검증 후 재시도하는 루프가 있습니다.

## 흔한 실수

-   에이전트 루프의 모든 턴에서 도구를 강제해서 최종 답변을 영영 못 내게 만드는 것.
-   `required`가 특정 도구를 뜻한다고 가정하는 것. 어떤 도구든 상관없다는 뜻입니다.

## 자주 묻는 질문

### tool\_choice의 기본값은 무엇인가요?

OpenAI API에서는 도구를 보내지 않으면 none, 도구가 있으면 auto입니다. Anthropic도 같은 기본값을 씁니다.

### 도구 호출은 언제 강제해야 하나요?

호출만이 유일하게 허용되는 답일 때입니다. 예를 들어 반드시 submit\_label을 호출해야 하는 분류기가 그렇습니다. 고정된 JSON 답변이 필요하다면 구조화된 출력이 더 간단한 경우가 많습니다.

### BroadNet Inference는 tool\_choice를 지원하나요?

BroadNet은 GLM 5.3과 Qwen3.8 27B의 도구 호출을 문서화하지만, API 레퍼런스에 tool\_choice는 나와 있지 않습니다. 의존하기 전에 각 값을 테스트하세요.

## 함께 보기

-   [도구 호출(tool calling)](https://broadrouter.com/ko/glossary/tool-calling/) (용어)
-   [병렬 도구 호출(parallel tool calls)](https://broadrouter.com/ko/glossary/parallel-tool-calls/) (용어)
-   [구조화된 출력(Structured output)](https://broadrouter.com/ko/glossary/structured-output/) (용어)
-   [JSON Schema(JSON 스키마)](https://broadrouter.com/ko/glossary/json-schema/) (용어)
-   [AI 에이전트(AI agent)](https://broadrouter.com/ko/glossary/agent/) (용어)
-   [ReAct(추론과 행동, reason and act)](https://broadrouter.com/ko/glossary/react-agent/) (용어)
-   [오픈 모델 도구 호출: 스키마, 병렬 호출, 재시도](https://broadrouter.com/ko/blog/tool-calling-open-models/) (글)
-   [접두부가 캐시되도록 프롬프트를 구성하는 방법](https://broadrouter.com/ko/blog/prompt-structure-for-caching/) (글)

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

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

**출처**

-   [OpenAI API 레퍼런스, 채팅 완성 생성(tool\_choice)(2026-11-15 확인)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [OpenAI, 함수 호출 가이드(tool\_choice)(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/define-tools)
