Búsqueda web

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

Ejemplo: explicar por qué Marte se ve rojo

Envía este cuerpo JSON a POST /v1/agents/sessions para crear una sesión y recibir la respuesta a medida que se genera. La solicitud 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ó información en el sitio web de la NASA y transmitió la siguiente respuesta a medida que la generaba:

Marte se ve rojo porque los minerales de hierro presentes en su suelo se oxidan y le dan a la superficie un tono rojizo. Por ese color de óxido se le conoce como el “planeta rojo”, según la página de la NASA sobre Marte.

Este ejemplo muestra la respuesta registrada durante la prueba. La respuesta que recibas puede variar.

Si omites 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 herramienta consulte internet en tiempo real. Se usa cuando incluyes web_search y 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 omitieras la herramienta.

Opciones de configuración

Agrega estos campos a la misma entrada de web_search: