Activer Web Search dans l'API

Leçon corrigée le 2 novembre 2026 d’après la documentation de xAI : avec le SDK xai-sdk, la recherche web s’active par la fonction web_search() importée de xai_sdk.tools, dans une conversation créée par client.chat.create ; l’ancien exemple appelait client.tools.web_search() et client.responses.create, qui n’existent pas dans ce SDK. Source : Web Search.

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-0309-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
from xai_sdk.chat import user
from xai_sdk.tools import web_search

client = Client()

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

response = chat.sample()
print(response.content)
print(response.citations)

Le SDK fournit la fonction web_search(), qui génère l’objet de configuration de l’outil. Elle accepte aussi allowed_domains ou excluded_domains — cinq domaines au plus, et jamais les deux dans la même requête.

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-0309-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-0309-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