Busca na web não funciona no Whizi: por que ela não rodou

A resposta curta

Na maioria dos casos, nenhuma busca chegou a ser emitida. Com o botão ativado, o Whizi primeiro envia ao modelo uma ferramenta de sondagem barata, de cerca de 50 tokens, e uma busca na web real só roda em um turno em que o modelo realmente chama essa ferramenta. Se o modelo julgar que já consegue responder com o que já sabe, nenhuma busca acontece e você recebe uma resposta sem fontes com o botão ainda mostrando verde.

As causas, na ordem que vale a pena checar:

O que você viu	Causa mais provável	O que fazer
Botão ativado, a resposta não tem fontes	O modelo nunca chamou a ferramenta de sondagem, então nenhuma busca foi emitida	Nada do seu lado força uma busca: o modelo decide a cada turno
O botão parece desativado nesta conversa	O botão é armazenado por conversa, não por conta, e a busca só vem ativada em conversas novas	Ative novamente nesta conversa
Só voltaram dois ou três resultados	Uma busca comum é limitada a 3 resultados	Nada a mudar: 3 por busca e 3 no total é o limite
Um erro menciona um booleano	O corpo da requisição estava malformado	Recarregue a página e reenvie
A mensagem inteira deu erro	Uma falha do provedor do modelo	Tente de novo e, se repetir, contate o suporte

Por que o botão estar ativado não significa que uma busca rodou

Uma requisição roda em um de três modos de busca: desativado, sondagem ou nativo.

Modo desativado não carrega nenhuma ferramenta de busca: o botão está desligado, então o modelo não tem como pesquisar nada e responde só com base na conversa. Com o botão ativado, a mensagem vai para o modo de sondagem.

Modo de sondagem é o substituto barato. O modelo recebe uma função comum que pode chamar, custando cerca de 50 tokens, e só uma mensagem em que ele realmente chama essa função é reenviada com a busca real anexada. Em mensagens que nunca precisaram da web, o modo de sondagem custa cerca de 46 vezes menos que o nativo, e nas que precisam, custa cerca de 0,8 por cento a mais.

Modo nativo roda diretamente a ferramenta de busca real do provedor. Não é gratuito: a definição da ferramenta injeta um preâmbulo fixo de cerca de 4.400 tokens de entrada. O mesmo prompt de duas mensagens mediu 36 tokens sem a ferramenta e 4.472 com ela.

O botão permite uma busca. O modelo decide se vai rodar uma, e é por isso que uma pergunta como "qual é um bom CRM" pode voltar sem fontes enquanto "o que essa empresa anunciou essa semana" volta pesquisada, na mesma conversa, sem mexer no botão.

A busca na web é um botão por requisição do usuário, não um sinalizador de capacidade por modelo, por isso não existe uma lista publicada de modelos que conseguem navegar e modelos que não conseguem.

As mensagens de erro exatas e o que cada uma significa

Os clientes do Whizi exibem diretamente o error.message vindo do backend, então a mensagem na sua frente é a que a rota emitiu. Se você tem uma destas na sua frente, é isso que ela está dizendo.

Mensagem de erro	HTTP e código	Gatilho
webSearchEnabled must be a boolean.	400, invalid_generate_request	A rota de envio do site recebeu um campo webSearchEnabled que não era true nem false
webSearch must be a boolean.	400, invalid_chat_request	A rota de chat do app recebeu um campo webSearch que não era true nem false
Web searches failed. You have not been charged.	Gravada em uma execução que falhou	Menos do que o número mínimo de buscas foi concluído em uma execução do Deep Research

Os dois erros de booleano informam uma requisição malformada. O valor que o cliente enviou para o sinalizador de busca não era um booleano, e nada sobre sua conta, plano ou modelo causou isso. Recarregue a página e envie a mensagem de novo. Se recarregar não resolver, contate o suporte.

Web searches failed. You have not been charged. é gravada em uma execução do Deep Research que falhou quando menos do que o número mínimo de buscas é concluído. Os créditos não são cobrados. Tente a requisição de novo mais tarde.

Os resultados voltaram, mas havia só três

Uma requisição de busca comum é limitada a 3 resultados por busca e 3 resultados no total, com um tamanho de contexto de busca baixo. Uma pergunta que parece complexa e uma trivial voltam, ambas, com no máximo três páginas por trás.

Uma rota se comporta de forma diferente. O agente de CPA canadense é a única rota que força a busca na web em todo turno, limitada a 7 buscas, e suas buscas ficam restritas a uma lista de domínios permitidos e a uma localização aproximada de usuário canadense. Nesse agente, resultados vindos de um conjunto restrito de sites são a lista de domínios permitidos em ação.

Se a resposta estiver desatualizada em vez de sem fontes, ou se você quiser conferir um número em mais de uma busca, isso é tratado em usando a busca na web e em o hub de solução de problemas.

Quando a mensagem inteira falha

Um turno de busca também pode falhar por motivos que não têm nada a ver com a busca. Essas mensagens vêm da camada do provedor do modelo e significam que a própria geração falhou.

Mensagem de erro	HTTP e código	Significado
The model is temporarily rate-limited. Please retry shortly.	429, provider_rate_limited	O provedor upstream recusou a conexão, não o Whizi
The model provider rejected the request.	502, provider_error	O corpo do erro do provedor não pôde ser lido
The model provider returned an empty stream.	502	A resposta upstream estava correta, mas veio sem corpo
The model stream was interrupted.	Evento de erro no meio do stream	O stream falhou no meio do caminho
Too many requests. Please wait and try again.	429, rate_limit_reached	Você atingiu uma janela de limite de taxa do Whizi

As mensagens de chat são limitadas a 10 por minuto e 60 por hora por usuário, igual em todos os planos, com um teto compartilhado de 30 requisições por minuto em todas as rotas. Uma requisição recusada não custa nada: recusas por limite de taxa são desfeitas, então um 429 nunca gasta uma mensagem da sua cota.

Nenhum desses tem uma configuração do seu lado que os evite. Espere um momento e envie de novo. Se o mesmo modelo continuar falhando por vários minutos, troque para um modelo diferente para continuar trabalhando e contate o suporte para que possam investigar na sua conta.