# Cloudflare apresenta a Web Search API: busca na web para agentes pelo AI Gateway

https://jsonscraper.com/pt/blog/cloudflare-apresenta-busca-web-agentes

Author: Michael Johnson

Published: 2026-10-08T06:21:46+00:00

Updated: 2026-10-08T06:34:05+00:00

A beta aberta reúne três provedores de busca, registro de consultas e cobrança. A orquestração da busca ainda cabe à aplicação.

Em 2 de outubro de 2026, a Cloudflare [apresentou a Web Search API](https://blog.cloudflare.com/introducing-web-search-api/) pelo AI Gateway — uma interface de busca na web para agentes e aplicações de IA. No lançamento, a empresa conectou Ceramic.ai, Exa e Linkup. A [documentação oficial de visão geral](https://developers.cloudflare.com/web-search/), consultada em 8 de outubro e atualizada em 2 de outubro, classifica o produto como beta aberta.



![Cloudflare apresenta a Web Search API: busca na web para agentes pelo AI Gateway
Contexto: Em 2 de outubro de 2026, a Cloudflare apresentou a Web Search API pelo AI Gateway. Veja os modos de integração confirmados, o formato dos resultados, as condições de pagamento e os limites dos recursos anunciados.
Tema visual: fotografia editorial fotorrealista de uma estação de trabalho de desenvolvedor, com um laptop exibindo resultados de busca na web abstratos e dados estruturados de API, iluminação laranja sutil, sem logotipos e sem texto legível](https://jsonscraper.com/assets/uploads/journal/2026/10/daad7cbd19f04c9c9d5ed6c4c370ab46.png.hero.webp)

© jsonscraper · Imagem gerada por IA

 

Para quem desenvolve, a principal mudança é poder adicionar busca ao fluxo de trabalho existente com modelos. De acordo com a [descrição da integração com o AI Gateway](https://developers.cloudflare.com/web-search/), as chamadas de busca compartilham com as solicitações aos modelos os registros, as análises, o faturamento e os controles de acesso. Assim, a busca pode ser tratada como uma etapa observável e independente na execução de uma tarefa do agente.

 

## Por que um agente precisa fazer uma busca

 

No [anúncio da Cloudflare](https://blog.cloudflare.com/introducing-web-search-api/), a empresa apresenta um problema prático: um agente pode tentar adivinhar o endereço da página desejada, e a solicitação a uma URL incorreta pode retornar 404. Uma ferramenta de busca oferece outro caminho: formular uma consulta, obter os endereços de materiais relevantes e usar as informações encontradas para preparar a resposta.

 

Outro cenário é lidar com mudanças ocorridas após o treinamento do modelo. A Cloudflare menciona especificamente eventos recentes, APIs em constante mudança e novos lançamentos de ferramentas. Para um agente que ajuda a escrever código, pode ser útil buscar a documentação de uma versão específica de uma biblioteca ou de um parâmetro recém-introduzido. Nesse processo, a busca fornece material para o contexto, enquanto a aplicação decide quais resultados serão enviados ao modelo.

 

Uma conclusão prática para a equipe: guarde o URL e a consulta junto com o trecho encontrado. Assim, ao verificar a resposta, será possível recuperar o material usado pelo agente. Para tarefas que envolvam versões, também é útil incluir explicitamente na consulta o nome do produto e a versão desejada.

 

## Como integrar a nova API

 

A documentação descreve [dois modos de chamada](https://developers.cloudflare.com/web-search/): uma API REST a partir de um backend externo e um vínculo de IA dentro do Cloudflare Workers. O provedor é escolhido pelo parâmetro `provider`. Os três serviços retornam resultados em um formato comum, com títulos, URLs e descrições. Isso facilita trocar de fornecedor na etapa em que a aplicação processa a resposta.

 

O formato unificado é útil para criar um adaptador próprio para a ferramenta de busca. Sua função é receber a consulta do agente, chamar o provedor escolhido e enviar os resultados selecionados ao modelo. No nível da aplicação, vale decidir separadamente quando a descrição do resultado é suficiente e quando é necessário ler a página encontrada e verificar uma afirmação específica.

 

Na [publicação sobre o lançamento](https://blog.cloudflare.com/introducing-web-search-api/), as ferramentas de servidor integradas ao AI Gateway são apresentadas como um recurso futuro. A Cloudflare informa que a busca na web será uma das primeiras ferramentas desse tipo. O cenário demonstrado no lançamento pressupõe orquestração própria: processar a chamada à ferramenta e enviar a resposta da busca na próxima solicitação ao modelo.

 

## Quais condições estão confirmadas

 

Segundo as [condições de pagamento descritas na documentação](https://developers.cloudflare.com/web-search/), as solicitações podem ser pagas com créditos do AI Gateway, pelo preço público de API do provedor correspondente, sem margem adicional da Cloudflare. Também há suporte a Bring Your Own Key, ou seja, ao uso da própria chave de API do provedor de busca. Ao escolher essa opção, a equipe deve definir com antecedência como acompanhará o consumo e conferirá as cobranças.

 

Os anúncios e a página de visão geral consultados não informam valores específicos nem limites numéricos de consultas. Por isso, o orçamento da integração deve ser calculado depois de verificar a tarifa do provedor escolhido. É útil estruturar os testes de aceitação em torno de tarefas próprias: proporção de fontes pertinentes, tempo de resposta, número de consultas de busca por tarefa concluída e tratamento de erros.

 

Outro ponto é a retenção de dados. Na [descrição da Zero Data Retention](https://blog.cloudflare.com/introducing-web-search-api/), a Cloudflare promete identificar os parceiros com suporte a ZDR. Para cada rota de busca, as condições de retenção do provedor e as configurações dos registros do AI Gateway devem ser verificadas separadamente: o anúncio também confirma que as consultas de busca são registradas no sistema de observabilidade.

 

Os provedores também se comprometem a cumprir os [requisitos da Cloudflare para Verified Bots](https://developers.cloudflare.com/bots/concepts/bot/verified-bots/): identificar seu bot, respeitar o `robots.txt` e as diretivas de rastreamento, manter uma frequência razoável de solicitações e respeitar as preferências dos proprietários dos sites. A visão geral da Web Search API confirma que cada resultado deve incluir um link para a fonte.

 

Para quem desenvolve, o lançamento oferece um ponto de integração claro para conectar a busca na web a um agente e registrar seu uso em um sistema comum. A avaliação pode começar com um pequeno conjunto de tarefas reais, a escolha explícita de um provedor e a inclusão de links nas respostas. Essas decisões determinarão o quanto os materiais encontrados ajudarão a aplicação a executar tarefas concretas.
