BroadRouter
Commencer

Appels d’outils parallèles (parallel tool calls)

Mis à jour

On parle d’appels d’outils parallèles quand un modèle renvoie plus d’un appel d’outil dans une même réponse, par exemple trois lectures de fichiers d’un coup. Au format OpenAI, ils arrivent comme plusieurs entrées dans tool_calls, et parallel_tool_calls à false limite le modèle à zéro ou un appel par tour.

Aussi appelé : appels d’outils parallèles, appel de fonctions parallèle, plusieurs appels d’outils, parallel tool calling, parallel function calling, parallel_tool_calls, multiple tool calls

Un agent qui a besoin de trois fichiers n’a pas à les demander en trois allers-retours. Avec les appels d’outils parallèles, le modèle les demande tous les trois d’un coup.

Comment ça marche

Dans une réponse d’appel d’outils, message.tool_calls est une liste. Avec des appels parallèles, elle contient plusieurs entrées, chacune avec son id, son nom de fonction et ses arguments JSON.

"tool_calls": [
  {"id": "call_1", "type": "function", "function": {"name": "read_file", "arguments": "{\"path\": \"a.py\"}"}},
  {"id": "call_2", "type": "function", "function": {"name": "read_file", "arguments": "{\"path\": \"b.py\"}"}}
]

Votre code exécute les appels et ajoute un message tool par appel, chacun avec le tool_call_id correspondant, puis rappelle le modèle.

  • OpenAI : parallel_tool_calls vaut true par défaut. Le passer à false « ensures exactly zero or one tool is called. » (traduction : « garantit qu’exactement zéro ou un outil est appelé. ») Le guide signale qu’un snapshot de modèle répétait parfois des appels au même outil et recommande d’y désactiver la fonction.
  • Anthropic : l’utilisation parallèle est activée par défaut. Désactivez-la avec disable_parallel_tool_use: true dans l’objet tool_choice. Anthropic précise que l’API « doesn’t prescribe an execution order » (traduction : « n’impose pas d’ordre d’exécution »), et que tous les résultats d’outils doivent revenir dans un seul message utilisateur pour que le parallélisme continue de fonctionner.

Pourquoi c’est important

  • Latence. Moins d’allers-retours avec le modèle. Les outils indépendants en lecture seule peuvent tourner en même temps de votre côté.
  • Ordre. Les appels à effets de bord, comme écrire puis lire, peuvent dépendre les uns des autres. Anthropic conseille de les exécuter à la suite. Ou désactivez la fonction.
  • Comptabilité. Chaque appel a besoin d’un résultat avec le bon ID. Un résultat manquant est une cause fréquente d’échec de la requête suivante.

Sur BroadNet Inference

La référence de l’API de BroadNet documente l’appel d’outils pour GLM 5.3 et Qwen3.8 27B, mais pas parallel_tool_calls. Testez si votre prompt reçoit plusieurs appels et si false est respecté. Les appels parallèles arrivent dans une seule réponse : ils ne s’ajoutent donc pas à votre nombre de requêtes. L’exécution des outils se fait de votre côté. Notez qu’une session de forfait illimité BroadNet autorise une requête à la fois et ne vaut que pour DeepSeek V4.1 Flash ; avec une clé en paiement à l’usage, la limite de concurrence est de 4 requêtes en cours. L’article sur l’appel d’outils avec les modèles ouverts propose une boucle fonctionnelle.

Erreurs fréquentes

  • Renvoyer les résultats dans un format de message différent pour chaque appel, ou en oublier un.
  • Exécuter en parallèle des outils dépendants parce que le modèle les a listés ensemble.

Questions fréquentes

Des appels d’outils parallèles signifient-ils des requêtes API parallèles ?

Non. Le modèle renvoie plusieurs appels dans une seule réponse. Votre code les exécute, en parallèle ou l’un après l’autre, et renvoie tous les résultats dans la requête suivante.

Comment désactiver les appels d’outils parallèles ?

Au format OpenAI, mettez parallel_tool_calls à false ; selon OpenAI, cela « ensures exactly zero or one tool is called » (traduction : « garantit qu’exactement zéro ou un outil est appelé »). Dans l’API d’Anthropic, mettez disable_parallel_tool_use à true dans tool_choice.

BroadNet Inference prend-il en charge parallel_tool_calls ?

La référence de l’API BroadNet ne documente pas parallel_tool_calls. L’appel d’outils est documenté pour GLM 5.3 et Qwen3.8 27B ; testez s’ils renvoient plusieurs appels et si le paramètre est respecté.

Lire en MarkdownDemander à ChatGPTDemander à ClaudeDemander à Perplexity