BroadRouter
Inizia

tool_choice

Aggiornato

tool_choice è un parametro della richiesta che controlla l’uso degli strumenti. In Chat Completions di OpenAI può valere auto (decide il modello), required (deve chiamare uno o più strumenti), none (nessuno strumento) o una funzione specifica da forzare. Le opzioni equivalenti di Anthropic sono auto, any, tool e none.

Detto anche: scelta dello strumento, chiamata forzata a uno strumento, function call forzata, tool choice, forced tool call, forced function call

Il tool calling permette a un modello di chiedere al tuo codice di eseguire una funzione. tool_choice decide se questo è facoltativo, obbligatorio o disattivato.

Come funziona

Invii tools (nomi delle funzioni, descrizioni e parametri in JSON Schema) e, se vuoi, tool_choice.

Valore OpenAI Significato Equivalente Anthropic
"auto" Il modello sceglie tra un messaggio e una o più chiamate; predefinito quando invii strumenti {"type": "auto"}
"required" “The model must call one or more tools” (traduzione: il modello deve chiamare uno o più strumenti) {"type": "any"}
{"type": "function", "function": {"name": "get_weather"}} Forza quell’unico strumento {"type": "tool", "name": "get_weather"}
"none" Nessuna chiamata a strumenti; predefinito senza strumenti {"type": "none"}

La guida al function calling di OpenAI descrive anche un’opzione di allowed tools che limita le chiamate a un sottoinsieme lasciando invariato l’elenco completo degli strumenti, e la suggerisce per il prompt caching.

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

La documentazione di Anthropic osserva che con any o tool l’API precompila la risposta, quindi il modello non scrive testo prima della chiamata, e che alcuni modelli Claude rifiutano l’uso forzato degli strumenti e restituiscono un errore 400.

Perché è importante

  • Pipeline affidabili. Un passaggio di estrazione che deve finire con una chiamata non dovrebbe ricevere una risposta testuale chiacchierona. Forzare la chiamata elimina quel ramo.
  • Turni sicuri. Impostare none per un turno finale di riepilogo impedisce al modello di avviare un altro giro di strumenti, mantenendo lo stesso elenco di strumenti.
  • Caching. Anthropic dice che cambiare tool_choice invalida i blocchi di messaggi in cache, quindi tienilo stabile tra i turni quando puoi.

Su BroadNet Inference

Il riferimento API di BroadNet documenta il tool calling solo per GLM 5.3 e Qwen3.8 27B, e non documenta tool_choice. Prova ogni valore che intendi usare: invia required o una funzione specifica e verifica che la risposta contenga tool_calls. Se la forzatura non funziona, usa auto con un’istruzione chiara e valida il risultato, oppure usa l’output strutturato sugli stessi modelli. L’articolo sul tool calling con i modelli open contiene un ciclo di validazione e retry.

Errori comuni

  • Forzare uno strumento a ogni turno di un ciclo agentico, così il modello non può mai dare una risposta finale.
  • Credere che required indichi uno strumento specifico. Indica uno strumento qualsiasi.

Domande frequenti

Qual è il valore predefinito di tool_choice?

Nell’API di OpenAI, none quando non invii strumenti e auto quando ci sono strumenti. Anthropic usa gli stessi valori predefiniti.

Quando conviene forzare una chiamata a uno strumento?

Quando l’unica risposta accettabile è una chiamata, come un classificatore che deve chiamare submit_label. Per una risposta JSON fissa, spesso l’output strutturato è più semplice.

BroadNet Inference supporta tool_choice?

BroadNet documenta il tool calling per GLM 5.3 e Qwen3.8 27B, ma il suo riferimento API non documenta tool_choice. Prova ogni valore prima di farci affidamento.

Leggi in MarkdownChiedi a ChatGPTChiedi a ClaudeChiedi a Perplexity