---
title: "Apa itu tool_choice? Memaksa atau memblokir tool call LLM"
description: "tool_choice mengatur apakah model boleh, wajib, atau dilarang memanggil tool, atau tool mana yang wajib dipanggil. Opsi OpenAI dan Anthropic, dan kapan memaksa call."
url: https://broadrouter.com/id/glossary/tool-choice/
lang: id
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan dari bahasa Inggris dengan bantuan AI. [Baca versi asli bahasa Inggris](https://broadrouter.com/glossary/tool-choice/) (diperbarui 2026-11-15).

# tool\_choice

Diperbarui 2026-11-15

tool\_choice adalah parameter permintaan yang mengatur penggunaan tool. Di Chat Completions OpenAI, nilainya bisa auto (model yang memutuskan), required (wajib memanggil satu tool atau lebih), none (tanpa tool), atau nama fungsi tertentu yang dipaksakan. Opsi padanannya di Anthropic adalah auto, any, tool, dan none.

Disebut juga: tool\_choice, tool choice, pilihan tool, memaksa tool call, forced tool call, forced function call

[Tool calling](https://broadrouter.com/id/glossary/tool-calling/) memungkinkan model meminta kode Anda menjalankan sebuah fungsi. tool\_choice menentukan apakah itu opsional, wajib, atau dimatikan.

## Cara kerjanya

Anda mengirim `tools` (nama fungsi, deskripsi, dan parameter [JSON Schema](https://broadrouter.com/id/glossary/json-schema/)) dan, jika perlu, `tool_choice`.

| Nilai OpenAI | Arti | Padanan Anthropic |
| --- | --- | --- |
| `"auto"` | Model memilih membalas dengan pesan atau satu call atau lebih; default jika ada tool | `{"type": "auto"}` |
| `"required"` | “The model must call one or more tools” (terjemahan: model wajib memanggil satu tool atau lebih) | `{"type": "any"}` |
| `{"type": "function", "function": {"name": "get_weather"}}` | Memaksa satu tool itu | `{"type": "tool", "name": "get_weather"}` |
| `"none"` | Tanpa tool call; default jika tidak ada tool | `{"type": "none"}` |

Panduan function calling OpenAI juga menjelaskan opsi allowed-tools yang membatasi call ke sebagian tool sambil tetap mempertahankan daftar tool lengkap, yang disarankan untuk prompt caching.

```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"}}}
```

Dokumentasi Anthropic mencatat bahwa dengan `any` atau `tool`, API melakukan prefill pada balasan sehingga model tidak menulis teks apa pun sebelum call, dan beberapa model Claude menolak penggunaan tool yang dipaksa dan mengembalikan error 400.

## Mengapa penting

-   **Pipeline yang andal.** Langkah ekstraksi yang harus berakhir dengan call tidak boleh mendapat balasan teks yang bertele-tele. Memaksa call menghilangkan cabang itu.
-   **Giliran yang aman.** Mengatur `none` di giliran ringkasan terakhir mencegah model memulai putaran tool baru, sambil tetap memakai daftar tool yang sama.
-   **Caching.** Anthropic menyebut mengubah `tool_choice` membatalkan blok pesan yang sudah di-cache, jadi usahakan nilainya tetap stabil antar-giliran.

## Di BroadNet Inference

[Referensi API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-glossary-tool-choice&utm_content=body) BroadNet mendokumentasikan tool calling hanya untuk [GLM 5.3](https://broadrouter.com/id/models/glm-5.3/) dan [Qwen3.8 27B](https://broadrouter.com/id/models/qwen3.8-27b/), dan tidak mendokumentasikan `tool_choice`. Uji setiap nilai yang ingin Anda pakai: kirim `required` atau nama fungsi tertentu, lalu pastikan balasannya berisi `tool_calls`. Jika pemaksaan tidak bekerja sesuai harapan, pakai `auto` dengan instruksi yang jelas lalu validasi hasilnya, atau pakai [output terstruktur](https://broadrouter.com/id/glossary/structured-output/) di model yang sama. [Artikel tool calling dengan model open](https://broadrouter.com/id/blog/tool-calling-open-models/) berisi loop validasi dan retry.

## Kesalahan umum

-   Memaksa tool di setiap giliran loop agen, sehingga agen tidak pernah bisa memberi jawaban akhir.
-   Mengira `required` berarti tool tertentu. Artinya tool apa saja.

## Pertanyaan umum

### Apa nilai default tool\_choice?

Di API OpenAI, none jika tidak ada tool yang dikirim dan auto jika ada tool. Anthropic memakai default yang sama.

### Kapan saya sebaiknya memaksa tool call?

Saat satu-satunya jawaban yang bisa diterima adalah sebuah call, misalnya classifier yang harus memanggil submit\_label. Untuk balasan JSON yang tetap, output terstruktur sering lebih sederhana.

### Apakah BroadNet Inference mendukung tool\_choice?

BroadNet mendokumentasikan tool calling untuk GLM 5.3 dan Qwen3.8 27B, tetapi referensi API-nya tidak mendokumentasikan tool\_choice. Uji setiap nilai sebelum mengandalkannya.

## Lihat juga

-   [Tool calling (function calling)](https://broadrouter.com/id/glossary/tool-calling/) (istilah)
-   [Parallel tool calls (pemanggilan tool paralel)](https://broadrouter.com/id/glossary/parallel-tool-calls/) (istilah)
-   [Output terstruktur (structured output)](https://broadrouter.com/id/glossary/structured-output/) (istilah)
-   [JSON Schema (skema JSON)](https://broadrouter.com/id/glossary/json-schema/) (istilah)
-   [Agen AI (AI agent)](https://broadrouter.com/id/glossary/agent/) (istilah)
-   [ReAct (reason and act)](https://broadrouter.com/id/glossary/react-agent/) (istilah)
-   [Tool calling dengan model terbuka: skema, panggilan paralel, retry](https://broadrouter.com/id/blog/tool-calling-open-models/) (artikel)
-   [Cara menyusun prompt agar prefiksnya ter-cache](https://broadrouter.com/id/blog/prompt-structure-for-caching/) (artikel)

Coba dengan beban kerja Anda yang sebenarnya. Akun baru mendapat kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM, dan Qwen3.8 memerlukan top up.

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

**Sumber**

-   [Referensi API OpenAI, create chat completion (tool\_choice) (diperiksa 2026-11-15)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [OpenAI, panduan function calling (tool\_choice) (diperiksa 2026-11-15)](https://developers.openai.com/api/docs/guides/function-calling)
-   [Dokumentasi Anthropic, define tools: memaksa penggunaan tool (diperiksa 2026-11-15)](https://platform.claude.com/docs/en/agents-and-tools/tool-use/define-tools)
