Búsqueda web

Usa la búsqueda web cuando tu agente necesite buscar información para responder una pregunta o completar una tarea.

Ejemplo: explica por qué Marte se ve rojo

Envía este cuerpo JSON a POST /v1/agents/sessions para crear una sesión y transmitir la respuesta en streaming. Esto habilita la búsqueda web en modo 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
}

Resultado

En una prueba realizada el 10 de septiembre de 2026, el agente buscó en el sitio web de la NASA y transmitió esta respuesta 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.

Este es un ejemplo registrado. Tu respuesta puede variar.

Si no incluyes web_search en agent.tools, la búsqueda web integrada queda desactivada. Pedir una búsqueda en el prompt no la activa.

Modo de búsqueda

• live (predeterminado): permite que la búsqueda acceda a internet en tiempo real. Se usa cuando incluyes web_search pero omites mode.
• cached: busca en contenido web guardado sin acceder a internet en tiempo real.
• disabled: desactiva la búsqueda web integrada, igual que si no incluyeras la herramienta.

Configuración opcional

Agrega estos campos a la misma entrada de web_search: