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
noneper 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_choiceinvalida 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
requiredindichi uno strumento specifico. Indica uno strumento qualsiasi.