Pesquisa na Web

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

Exemplo de como explicar por que Marte parece vermelho

Envie este corpo de requisição em JSON para POST /v1/agents/sessions para criar uma sessão e receber a resposta à medida que ela é gerada. A requisição 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 a seguinte resposta à medida que a gerava.

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 exemplo foi registrado durante o teste. A resposta que você receber pode variar.

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

Modo de pesquisa

• live (padrão) permite pesquisar diretamente na internet. Esse modo é usado quando você inclui web_search e omite mode.
• cached pesquisa conteúdo salvo da Web sem acessar a internet.
• disabled desativa a pesquisa na Web integrada. Omitir a ferramenta tem o mesmo efeito.

Configurações opcionais

Adicione estes campos à mesma entrada de web_search.