Le flux d'exécution en 5 étapes

Comment Grok décide d’utiliser un outil

Quand vous activez un ou plusieurs outils dans votre requête API, le modèle ne les utilise pas systématiquement. Il suit un processus de décision structuré en cinq étapes pour déterminer si un outil est nécessaire, lequel utiliser, et comment intégrer les résultats dans sa réponse.

Comprendre ce flux vous permet de mieux anticiper le comportement du modèle et d’optimiser vos prompts pour obtenir des résultats précis.

Les 5 étapes du flux

Étape 1 : Analyse de la requête

Le modèle commence par analyser le message de l’utilisateur pour identifier ce qui est demandé. Il évalue la nature de la question : s’agit-il d’une demande factuelle nécessitant des données récentes ? D’un calcul complexe ? D’une question d’opinion qui ne requiert aucun outil ?

Cette analyse est déterminante. Si le modèle dispose déjà de l’information dans ses données d’entraînement et qu’aucune donnée en temps réel n’est requise, il peut choisir de répondre directement sans activer d’outil.

Étape 2 : Décision d’appel

Sur la base de son analyse, le modèle décide d’appeler un outil ou de répondre directement. Cette décision dépend de plusieurs facteurs :

• La nature de la question : une question sur l’actualité favorise Web Search, une question sur les tendances X favorise X Search
• Les outils disponibles : le modèle ne peut utiliser que les outils que vous avez activés dans le tableau tools
• La confiance du modèle : s’il estime pouvoir répondre correctement sans outil, il le fera

Vous pouvez influencer cette décision via votre prompt. Un message comme “Recherche les dernières informations sur…” oriente clairement le modèle vers l’utilisation de Web Search.

Étape 3 : Exécution

Le traitement diffère selon la catégorie d’outil :

• Outil intégré : l’exécution est automatique et transparente. Le serveur xAI effectue la recherche ou l’exécution de code, et le résultat est directement transmis au modèle. Vous ne voyez pas cette étape dans la réponse API
• Function Calling : le modèle retourne un objet décrivant la fonction à appeler et ses arguments. C’est à votre code d’exécuter la fonction et de renvoyer le résultat via une nouvelle requête

Étape 4 : Traitement des résultats

Une fois les résultats obtenus, le modèle les analyse. Ce traitement peut aboutir à plusieurs scénarios :

• Résultats suffisants : le modèle passe directement à la formulation de la réponse finale
• Résultats insuffisants : le modèle peut effectuer un appel supplémentaire avec des paramètres différents, par exemple en élargissant ou en précisant sa recherche
• Appels multiples : pour une question complexe, le modèle peut enchaîner plusieurs appels d’outils (Web Search puis Code Execution, par exemple)

Ce comportement itératif est important à comprendre car il impacte directement les coûts : chaque appel d’outil est facturé séparément.

Étape 5 : Réponse finale

Le modèle formule sa réponse en intégrant les informations collectées. Si des sources web ou X ont été consultées, la réponse inclut automatiquement des citations avec les URLs d’origine. Ces citations sont accessibles dans le champ citations de l’objet réponse.

Implications pratiques

Coûts cumulatifs

Le modèle peut effectuer plusieurs appels d’outils pour une seule requête utilisateur. Chaque appel est facturé indépendamment en plus de la consommation de tokens. Un prompt ambigu peut générer des appels inutiles et augmenter vos coûts.

Contrôle via le prompt

Vous ne pouvez pas forcer le modèle à utiliser un outil spécifique, mais vous pouvez fortement l’orienter via votre prompt système ou le message utilisateur. Des instructions claires réduisent les appels inutiles.

Comportement non déterministe

Le choix d’utiliser ou non un outil peut varier entre deux appels identiques, surtout avec des températures élevées. Pour des résultats reproductibles, utilisez une température basse (0.0 à 0.3).

Points clés à retenir

• Le modèle suit un flux en 5 étapes : analyse, décision, exécution, traitement, réponse
• Il ne sollicite un outil que s’il le juge nécessaire — ce n’est pas automatique
• Les appels multiples sont possibles et augmentent les coûts
• Un prompt précis réduit les appels inutiles et améliore la pertinence
• Les citations sont automatiquement incluses quand des sources ont été consultées