BroadRouter
Commencer

tool_choice

Mis à jour

tool_choice est un paramètre de requête qui contrôle l’usage des outils. Dans les Chat Completions d’OpenAI, il vaut auto (le modèle décide), required (il doit appeler un ou plusieurs outils), none (aucun outil) ou le nom d’une fonction à forcer. Les options équivalentes chez Anthropic sont auto, any, tool et none.

Aussi appelé : tool_choice, choix d’outil, appel d’outil forcé, appel de fonction forcé, tool choice, forced tool call, forced function call

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 none pour 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_choice invalide 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 required désigne un outil précis. Il désigne n’importe quel outil.

Questions fréquentes

Quelle est la valeur par défaut de tool_choice ?

Dans l’API d’OpenAI, none quand aucun outil n’est envoyé et auto quand des outils sont présents. Anthropic utilise les mêmes valeurs par défaut.

Quand faut-il forcer un appel d’outil ?

Quand la seule réponse acceptable est un appel, par exemple un classifieur qui doit appeler submit_label. Pour une réponse JSON fixe, la sortie structurée est souvent plus simple.

BroadNet Inference prend-il en charge tool_choice ?

BroadNet documente l’appel d’outils pour GLM 5.3 et Qwen3.8 27B, mais sa référence d’API ne documente pas tool_choice. Testez chaque valeur avant de vous y fier.

Lire en MarkdownDemander à ChatGPTDemander à ClaudeDemander à Perplexity