Michael JohnsonEm 2 de outubro de 2026, a Cloudflare apresentou a 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, consultada em 8 de outubro e atualizada em 2 de outubro, classifica o produto como beta aberta.
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, 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, 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: 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, 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, 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, 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: 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.