L’appel d’outils permet à un modèle de demander à votre code d’exécuter une fonction. tool_choice décide si c’est facultatif, obligatoire ou désactivé.
Comment ça marche
Vous envoyez tools (noms de fonctions, descriptions et paramètres en JSON Schema) et, en option, tool_choice.
| Valeur OpenAI | Signification | Équivalent Anthropic |
|---|---|---|
"auto" |
Le modèle choisit un message ou un ou plusieurs appels ; valeur par défaut quand des outils sont envoyés | {"type": "auto"} |
"required" |
« The model must call one or more tools » (traduction : « le modèle doit appeler un ou plusieurs outils ») | {"type": "any"} |
{"type": "function", "function": {"name": "get_weather"}} |
Force cet outil précis | {"type": "tool", "name": "get_weather"} |
"none" |
Aucun appel d’outil ; valeur par défaut sans outils | {"type": "none"} |
Le guide du function calling d’OpenAI décrit aussi une option allowed tools qui restreint les appels à un sous-ensemble tout en gardant la liste complète d’outils inchangée, ce qu’il conseille pour le 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 documentation d’Anthropic note qu’avec any ou tool l’API préremplit la réponse, si bien que le modèle n’écrit aucun texte avant l’appel, et que certains modèles Claude refusent l’usage forcé d’outils et renvoient une erreur 400.
Pourquoi c’est important
- Pipelines fiables. Une étape d’extraction qui doit se terminer par un appel ne devrait pas recevoir une réponse textuelle bavarde. Forcer l’appel supprime cette branche.
- Tours sûrs. Mettre
nonepour un dernier tour de synthèse empêche le modèle de lancer une nouvelle série d’appels d’outils, tout en gardant la même liste d’outils. - Cache. Selon Anthropic, modifier
tool_choiceinvalide les blocs de messages en cache : gardez-le stable d’un tour à l’autre quand c’est possible.
Sur BroadNet Inference
La référence de l’API de BroadNet documente l’appel d’outils uniquement pour GLM 5.3 et Qwen3.8 27B, et ne documente pas tool_choice. Testez chaque valeur que vous comptez utiliser : envoyez required ou une fonction nommée et vérifiez que la réponse contient tool_calls. Si le forçage ne se comporte pas comme prévu, utilisez auto avec une instruction claire et validez le résultat, ou utilisez la sortie structurée sur les mêmes modèles. L’article sur l’appel d’outils avec les modèles ouverts propose une boucle de validation et de retry.
Erreurs fréquentes
- Forcer un outil à chaque tour d’une boucle d’agent, qui ne peut alors jamais donner de réponse finale.
- Croire que
requireddésigne un outil précis. Il désigne n’importe quel outil.