Recherche web

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

Exemple : expliquer pourquoi Mars paraît rouge

Envoyez ce corps JSON à POST /v1/agents/sessions pour créer une session et recevoir la réponse en streaming. Il 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 recherché des informations sur le site de la NASA et diffusé cette réponse en streaming :

Mars looks red because iron minerals in its soil oxidize, or rust, giving the surface a reddish color. This rusty appearance is why it’s called the “Red Planet,” according to NASA’s Mars Facts.

Cet exemple provient d’une exécution enregistrée. La réponse que vous obtiendrez peut varier.

Si vous n’incluez pas 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 la recherche à accéder à Internet en direct. Ce mode est utilisé lorsque vous incluez web_search sans préciser mode.
• cached : recherche dans du contenu web enregistré, sans accéder à Internet en direct.
• disabled : désactive la recherche web intégrée, comme lorsque vous n’incluez pas l’outil.

Paramètres facultatifs

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