---
title: "Apakah itu tool_choice? Memaksa atau menyekat panggilan alat"
description: "tool_choice mengawal sama ada model boleh, mesti atau tidak boleh memanggil alat, atau alat mana yang wajib dipanggil. Pilihan OpenAI, Anthropic, dan bila memaksa."
url: https://broadrouter.com/ms/glossary/tool-choice/
lang: ms
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan daripada bahasa Inggeris dengan bantuan AI. [Baca versi asal dalam bahasa Inggeris](https://broadrouter.com/glossary/tool-choice/) (dikemas kini 2026-11-15).

# tool\_choice

Dikemas kini 2026-11-15

tool\_choice ialah parameter permintaan yang mengawal penggunaan alatan. Dalam Chat Completions OpenAI, nilainya boleh auto (model membuat keputusan), required (model mesti memanggil satu atau lebih alat), none (tiada alat), atau fungsi bernama untuk dipaksa. Pilihan setara Anthropic ialah auto, any, tool dan none.

Juga dikenali sebagai: pilihan alat, panggilan alat paksa, tool choice, forced tool call, forced function call

[Tool calling](https://broadrouter.com/ms/glossary/tool-calling/) membolehkan model meminta kod anda menjalankan fungsi. tool\_choice menentukan sama ada itu pilihan, wajib atau dimatikan.

## Cara ia berfungsi

Anda menghantar `tools` (nama fungsi, penerangan dan parameter [JSON Schema](https://broadrouter.com/ms/glossary/json-schema/)) dan, jika mahu, `tool_choice`.

| Nilai OpenAI | Maksud | Setara Anthropic |
| --- | --- | --- |
| `"auto"` | Model memilih mesej atau satu atau lebih panggilan; lalai apabila alat dihantar | `{"type": "auto"}` |
| `"required"` | “The model must call one or more tools” (Terjemahan BroadRouter: model mesti memanggil satu atau lebih alat) | `{"type": "any"}` |
| `{"type": "function", "function": {"name": "get_weather"}}` | Memaksa alat yang satu itu | `{"type": "tool", "name": "get_weather"}` |
| `"none"` | Tiada panggilan alat; lalai apabila tiada alat | `{"type": "none"}` |

Panduan function calling OpenAI juga menerangkan pilihan allowed-tools yang mengehadkan panggilan kepada subset sambil mengekalkan senarai alat penuh tanpa perubahan, yang dicadangkannya 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 menyatakan bahawa dengan `any` atau `tool`, API mengisi awal (prefill) balasan, jadi model tidak menulis teks sebelum panggilan, dan sesetengah model Claude menolak penggunaan alat secara paksa dan memulangkan ralat 400.

## Mengapa ia penting

-   **Saluran paip yang boleh dipercayai.** Langkah pengekstrakan yang mesti berakhir dengan panggilan tidak patut menerima balasan teks yang meleret. Memaksa panggilan membuang cabang itu.
-   **Giliran yang selamat.** Menetapkan `none` untuk giliran ringkasan terakhir menghalang model daripada memulakan pusingan alat baharu sambil mengekalkan senarai alat yang sama.
-   **Caching.** Anthropic menyatakan mengubah `tool_choice` membatalkan blok mesej yang dicache, jadi kekalkannya stabil merentas giliran jika boleh.

## Di BroadNet Inference

[Rujukan API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-glossary-tool-choice&utm_content=body) BroadNet mendokumenkan tool calling untuk [GLM 5.3](https://broadrouter.com/ms/models/glm-5.3/) dan [Qwen3.8 27B](https://broadrouter.com/ms/models/qwen3.8-27b/) sahaja, dan tidak mendokumenkan `tool_choice`. Uji setiap nilai yang anda rancang untuk guna: hantar `required` atau fungsi bernama dan sahkan balasan mengandungi `tool_calls`. Jika paksaan tidak berfungsi, gunakan `auto` dengan arahan yang jelas dan sahkan hasilnya, atau gunakan [output berstruktur](https://broadrouter.com/ms/glossary/structured-output/) pada model yang sama. [Hantaran tool calling model terbuka](https://broadrouter.com/ms/blog/tool-calling-open-models/) mempunyai gelung sahkan-dan-cuba-semula.

## Kesilapan biasa

-   Memaksa alat pada setiap giliran gelung ejen, sehingga ia tidak pernah dapat memberi jawapan akhir.
-   Menganggap `required` bermaksud alat tertentu. Ia bermaksud mana-mana alat.

## Soalan lazim

### Apakah nilai lalai tool\_choice?

Dalam API OpenAI, none apabila tiada alat dihantar dan auto apabila ada alat. Anthropic menggunakan nilai lalai yang sama.

### Bilakah saya patut memaksa panggilan alat?

Apabila satu-satunya jawapan yang boleh diterima ialah panggilan, seperti pengelas yang mesti memanggil submit\_label. Untuk balasan JSON yang tetap, output berstruktur selalunya lebih mudah.

### Adakah BroadNet Inference menyokong tool\_choice?

BroadNet mendokumenkan tool calling untuk GLM 5.3 dan Qwen3.8 27B, tetapi rujukan API-nya tidak mendokumenkan tool\_choice. Uji setiap nilai sebelum bergantung padanya.

## Lihat juga

-   [Tool calling (panggilan alatan)](https://broadrouter.com/ms/glossary/tool-calling/) (istilah)
-   [Panggilan alatan selari (parallel tool calls)](https://broadrouter.com/ms/glossary/parallel-tool-calls/) (istilah)
-   [Output berstruktur (structured output)](https://broadrouter.com/ms/glossary/structured-output/) (istilah)
-   [JSON Schema (skema JSON)](https://broadrouter.com/ms/glossary/json-schema/) (istilah)
-   [Ejen AI (AI agent)](https://broadrouter.com/ms/glossary/agent/) (istilah)
-   [ReAct (reason and act)](https://broadrouter.com/ms/glossary/react-agent/) (istilah)
-   [Tool calling pada model terbuka: skema, panggilan selari, cuba semula](https://broadrouter.com/ms/blog/tool-calling-open-models/) (artikel)
-   [Cara menyusun prompt supaya prefix di-cache](https://broadrouter.com/ms/blog/prompt-structure-for-caching/) (artikel)

Cuba dengan beban kerja sebenar anda. Akaun baharu bermula dengan kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM dan Qwen3.8 memerlukan tambah nilai.

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

**Sumber**

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