Les deux catégories d'outils Grok

Comprendre l’écosystème d’outils de l’API Grok

L’API Grok ne se limite pas à générer du texte. Elle propose un ensemble d’outils qui permettent au modèle d’interagir avec le monde extérieur : rechercher des informations en temps réel, analyser des données sur les réseaux sociaux, ou exécuter du code Python. Pour exploiter ces capacités, vous devez comprendre comment elles sont organisées.

L’API Grok distingue deux catégories fondamentales d’outils. Cette distinction détermine qui exécute l’outil, où le traitement a lieu, et ce que vous devez gérer côté développeur.

Outils intégrés (Built-in Tools) — côté serveur

Les outils intégrés sont exécutés directement par les serveurs de xAI. Lorsque le modèle décide d’utiliser l’un de ces outils, l’exécution est automatique et transparente. Vous n’avez aucune infrastructure à gérer, aucun résultat intermédiaire à traiter.

Voici les cinq outils intégrés disponibles :

• Web Search (web_search) : recherche sur le web en temps réel, avec filtrage par domaines et citations automatiques
• X Search (x_search) : recherche sur X/Twitter, avec filtrage par comptes et par dates
• Code Execution (code_interpreter / code_execution) : exécution de code Python dans un environnement sandboxé sécurisé
• Collections Search (collections_search / file_search) : recherche dans des documents que vous avez préalablement uploadés
• Remote MCP (mcp) : connexion à des serveurs MCP (Model Context Protocol) externes

Pour activer un outil intégré, vous l’ajoutez simplement au tableau tools de votre requête :

{
  "tools": [{"type": "web_search"}]
}

Function Calling — côté client

Le Function Calling fonctionne différemment. Vous définissez des fonctions personnalisées que le modèle peut appeler. Mais contrairement aux outils intégrés, c’est votre code côté client qui exécute la fonction et renvoie le résultat au modèle.

Le flux est le suivant :

1. Vous décrivez vos fonctions (nom, paramètres, description) dans la requête
2. Le modèle analyse la requête de l’utilisateur
3. S’il juge qu’une fonction est nécessaire, il retourne un appel de fonction avec les arguments
4. Votre code exécute la fonction (appel API, requête base de données, calcul…)
5. Vous renvoyez le résultat au modèle
6. Le modèle formule sa réponse finale

Cette approche vous donne un contrôle total : vous décidez ce que font vos fonctions, quelles données elles manipulent, et comment elles se connectent à votre infrastructure.

Quand utiliser chaque catégorie

Les outils intégrés sont idéaux quand vous avez besoin d’accéder à des informations en temps réel (web, réseaux sociaux) ou d’exécuter des calculs sans gérer d’infrastructure. Le Function Calling est préférable quand vous avez besoin d’interagir avec vos propres systèmes : bases de données internes, APIs métier, ou tout service spécifique à votre application.

Les deux catégories peuvent être combinées dans une même requête. Vous pouvez, par exemple, activer Web Search tout en définissant une fonction personnalisée qui enregistre les résultats dans votre base de données.

Points clés à retenir

• L’API Grok propose deux catégories d’outils : les outils intégrés (exécutés par xAI) et le Function Calling (exécuté par votre code)
• Les outils intégrés ne nécessitent aucune infrastructure côté client
• Le Function Calling offre un contrôle total mais demande plus de développement
• Les deux catégories sont combinables dans une même requête
• Ce cours se concentre sur les trois outils intégrés principaux : Web Search, X Search et Code Execution