Activer Web Search dans l'API

Donner à Grok l’accès au web en temps réel

Web Search est l’outil intégré le plus utilisé de l’API Grok. Il permet au modèle de rechercher des informations actualisées sur le web, comblant ainsi la limite naturelle de ses données d’entraînement. L’activation est simple, mais il y a des points importants à maîtriser pour l’utiliser efficacement.

Prérequis : l’API Responses

Web Search est exclusivement disponible sur l’API Responses. L’ancienne API Chat Completions proposait un système de “Live Search” qui est désormais déprécié. Si vous utilisez encore Chat Completions pour la recherche web, vous devez migrer vers l’API Responses.

L’API Responses utilise client.responses.create() au lieu de client.chat.completions.create(). La structure des requêtes et des réponses diffère, mais le xAI SDK et l’OpenAI SDK prennent en charge les deux.

Activation basique

L’activation de Web Search se fait en ajoutant un objet {"type": "web_search"} au tableau tools de votre requête :

{
  "model": "grok-4.20-reasoning",
  "input": "Quelles sont les dernières avancées en intelligence artificielle ?",
  "tools": [
    {"type": "web_search"}
  ]
}

C’est tout ce qu’il faut pour une recherche web basique. Le modèle détermine automatiquement s’il doit effectuer une recherche et formule la requête de recherche optimale à partir du message de l’utilisateur.

Activation avec le xAI SDK (Python)

from xai_sdk import Client

client = Client()

response = client.responses.create(
    model="grok-4.20-reasoning",
    input="Quelles sont les dernières avancées en IA ?",
    tools=[client.tools.web_search()]
)

print(response.output_text)

Le SDK simplifie la syntaxe avec client.tools.web_search(), qui génère automatiquement l’objet de configuration correct.

Activation avec l’OpenAI SDK

from openai import OpenAI

client = OpenAI(
    api_key="xai-votre-cle",
    base_url="https://api.x.ai/v1"
)

response = client.responses.create(
    model="grok-4.20-reasoning",
    input="Quelles sont les dernières avancées en IA ?",
    tools=[{"type": "web_search"}]
)

L’OpenAI SDK fonctionne avec l’API Grok en modifiant simplement le base_url. La syntaxe des outils reste identique.

Activation avec le Vercel AI SDK

import { xai } from "@ai-sdk/xai";

const response = await generateText({
  model: xai("grok-4.20-reasoning"),
  prompt: "Quelles sont les dernières avancées en IA ?",
  tools: [xai.tools.webSearch()]
});

Le Vercel AI SDK utilise xai.tools.webSearch() avec la convention camelCase de JavaScript.

Combiner Web Search avec d’autres outils

Vous pouvez activer plusieurs outils simultanément. Le modèle choisira celui qui est le plus approprié, ou les utilisera séquentiellement :

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

Dans cet exemple, le modèle peut rechercher des données sur le web puis les analyser avec Code Execution.

Points clés à retenir

• Web Search est exclusif à l’API Responses — Chat Completions est déprécié pour cette fonctionnalité
• L’activation se fait avec {"type": "web_search"} dans le tableau tools
• Le modèle décide automatiquement quand et comment rechercher
• Tous les SDKs (xAI, OpenAI, Vercel AI) supportent Web Search
• Plusieurs outils peuvent être activés simultanément dans une même requête