Recherche web

Utilisez la recherche web lorsque votre agent a besoin de trouver des informations pour répondre à une question ou accomplir une tâche.

Exemple : expliquer pourquoi Mars paraît rouge

Envoyez ce corps de requête JSON à POST /v1/agents/sessions pour créer une session et recevoir la réponse en continu. Cette requête active la recherche web en mode live :

12345678910{
  "agent": {
    "model": "gpt-6-astra",
    "reasoning": { "effort": "low" },
    "tools": [{ "type": "web_search", "mode": "live" }]
  },
  "environment": { "type": "none" },
  "input": "Search NASA's website for why Mars looks red. Explain it in two sentences and include a source link.",
  "stream": true
}

Résultat

Lors d’un test effectué le 10 septembre 2026, l’agent a effectué une recherche sur le site de la NASA et transmis la réponse suivante en continu :

Mars paraît rouge parce que les minéraux de son sol qui contiennent du fer s’oxydent, autrement dit qu’ils rouillent, ce qui donne à sa surface une teinte rougeâtre. C’est cette couleur de rouille qui lui vaut le surnom de « planète rouge », selon la fiche de la NASA sur Mars.

Cet exemple a été enregistré lors du test. La réponse que vous obtiendrez peut varier.

Si vous omettez web_search dans agent.tools, la recherche web intégrée est désactivée. Demander une recherche dans le prompt ne l’active pas.

Mode de recherche

• live (par défaut) : autorise l’outil à consulter Internet en direct. Ce mode s’applique lorsque vous incluez web_search sans préciser mode.
• cached : recherche des informations dans des contenus web enregistrés, sans consulter Internet en direct.
• disabled : désactive la recherche web intégrée, comme si vous aviez omis l’outil.

Paramètres facultatifs

Ajoutez ces champs à la même entrée web_search :