Pular para o conteúdo principal
Descubra, pela resposta e pelo registro da solicitação, se uma busca na web realmente foi executada, qual mecanismo a executou e o que ela retornou. No fim, você consegue distinguir uma busca que nunca aconteceu de uma que foi executada e encontrou pouco.

Declare a busca na solicitação

Pedir “as últimas notícias” no prompt não executa uma busca. Adicione-a explicitamente:
phaseo:web_search funciona em Chat Completions, Responses e Messages. web_search_options funciona onde o endpoint o suporta. tool_choice força a chamada; sem ele, o modelo pode responder de memória. O guia de busca na web lista todos os parâmetros.

Confira se foi executada

Distinga os casos de falha

Com engine: "native", a solicitação vai só para provedores que executam a busca na web por conta própria. Se nenhum deles atender o modelo, o Phaseo executa o mecanismo padrão no lugar e cobra como busca gerenciada, então uma solicitação nativa pode mostrar contadores de busca gerenciada.

Compare solicitações

Quando os resultados variam entre execuções, compare o ID do modelo, o provedor selecionado, os parâmetros de busca e as contagens de resultados e de citações. As contagens são normalizadas entre provedores, então as diferenças de qualidade da busca aparecem sem que você precise ler os payloads brutos. Para um fluxo completo e fundamentado, veja Busca na web gerenciada em TypeScript; para uma URL conhecida, use web fetch.
Última modificação em 5 de novembro de 2026