Pesquisa na Web

Use a pesquisa na Web quando seu agente precisar buscar informações para responder a uma pergunta ou concluir uma tarefa.

Exemplo: explique por que Marte parece vermelho

Envie este corpo JSON para POST /v1/agents/sessions para criar uma sessão e transmitir a resposta em streaming. Ele ativa a pesquisa na Web no 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

Em um teste realizado em 10 de setembro de 2026, o agente pesquisou no site da NASA e transmitiu esta resposta em 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 é um exemplo registrado. A resposta que você receber pode variar.

Se você não incluir web_search em agent.tools, a pesquisa na Web integrada ficará desativada. Pedir uma pesquisa no prompt não a ativa.

Modo de pesquisa

• live (padrão): permite que a pesquisa acesse a internet em tempo real. É usado quando você inclui web_search, mas omite mode.
• cached: pesquisa conteúdo salvo da Web sem acessar a internet em tempo real.
• disabled: desativa a pesquisa na Web integrada, assim como omitir a ferramenta.

Configurações opcionais

Adicione estes campos à mesma entrada de web_search: