--- title: "Página 404 que o agente entende (e o soft 404 que engana) | Grupo Marfre" description: "Página 404 para agentes de IA: por que endereço inexistente deve responder 404 e não a home com 200, o caso do Cloudflare Pages e como testar com curl." canonical: https://grupomarfre.com.br/sites-agenticos/pagina-404-para-agentes/ alternate_html: https://grupomarfre.com.br/sites-agenticos/pagina-404-para-agentes/ language: pt-BR last_updated: 2026-10-27 type: guia --- # Página 404 que o agente entende (e o soft 404 que engana) **Resposta rápida:** Endereço que não existe deve responder com código HTTP 404, nunca com a home e código 200. Esse erro se chama soft 404 e pode levar o agente a tratar a home como se fosse a página pedida. O teste é pedir uma rota inventada com curl e conferir o código. Sem 404.html, o Cloudflare Pages comete esse erro. Quando alguém (ou um agente de IA) pede um endereço que não existe, o site precisa responder com o código 404. Se ele devolve a home com código 200, está dizendo que a página existe e que o conteúdo é aquele. O agente que confia no código pode ler a home, atribuir o texto ao endereço errado e seguir em frente sem saber que errou. O conserto é simples, mas o defeito passa despercebido porque, no navegador, a home aparece normalmente e nada parece errado. Só o código da resposta mostra o problema. ## O que é um soft 404 e por que ele engana o agente? Soft 404 é a resposta que parece erro para uma pessoa, mas declara sucesso para a máquina: o endereço não existe, o servidor devolve uma página qualquer e o código HTTP é 200. Quem lê o código, e não a aparência, pode registrar o conteúdo como se fosse a página que procurava. Na prática, isso gera três problemas: - O agente pode citar ou resumir a home como se fosse uma página de serviço que nunca existiu. - Links antigos, apagados ou digitados errados parecem funcionar, e o erro não aparece. - Uma auditoria que usa uma rota inventada como controle negativo acusa falha. Com o 404 correto, o código diz ao agente que o endereço não existe. ## Por que o Cloudflare Pages devolve a home com 200? Porque, sem um arquivo `404.html` na pasta publicada, o Cloudflare Pages entra em modo SPA (aplicação de página única) e entrega a home com HTTP 200 para qualquer endereço que não exista. O Grupo Marfre encontrou esse comportamento por controle negativo em 3 sites que publica. O site estático pode passar nos outros testes e ainda assim ter o defeito, porque ele só aparece num endereço que não se visita de propósito. A correção é incluir um `404.html` na raiz da pasta de saída do deploy. Com o arquivo presente, o Cloudflare Pages passa a responder 404 nos endereços inexistentes. O caminho completo para esse tipo de site está em [Site estático no Cloudflare Pages](https://grupomarfre.com.br/sites-agenticos/site-estatico-no-cloudflare-pages/). ## Como deve ser o 404 para um agente? O 404 para agente deve manter o código 404 e trazer, em Markdown, uma saída clara: o mapa do site, o resumo para IA e a página inicial. O agente que cai ali encontra o caminho sem adivinhar. Na régua do Grupo Marfre, o 404 em Markdown faz parte do middleware de borda, ao lado da negociação de conteúdo. Exemplo fictício do corpo de um 404 em Markdown: ```markdown ## Página não encontrada O endereço pedido não existe neste site. - Mapa do site: https://www.exemplo.com.br/sitemap.xml - Resumo para agentes: https://www.exemplo.com.br/llms.txt - Página inicial: https://www.exemplo.com.br/ ``` Cada link tem uma função: | Link | Para que serve | | --- | --- | | sitemap.xml | Lista as páginas HTML que existem de fato | | llms.txt | Resume o site e indexa as versões em Markdown | | Home | Ponto de partida para quem se perdeu | O código continua sendo 404. O Markdown só ajuda quem chegou até ali. Quem monta isso na borda encontra os detalhes em [Camada agêntica no Cloudflare Pages com Pages Functions](https://grupomarfre.com.br/sites-agenticos/middleware-cloudflare-pages/), e o arquivo apontado na segunda linha da lista é explicado em [O que é llms.txt e para que serve](https://grupomarfre.com.br/sites-agenticos/llms-txt/). ## Como testar com uma rota inventada? Peça um endereço que com certeza não existe e leia o código da resposta. Esse é o controle negativo: um teste que precisa falhar para o site estar certo. Use um trecho aleatório no caminho, para não coincidir com nada publicado. ```bash ## 1. Código de uma rota inventada (esperado: 404) curl -s -o /dev/null -w "%{http_code}\n" https://www.exemplo.com.br/rota-que-nao-existe-7f3a ## 2. Mesma rota pedindo Markdown (esperado: 404 com corpo em Markdown) curl -si -H "Accept: text/markdown" https://www.exemplo.com.br/rota-que-nao-existe-7f3a ## 3. Arquivo de ferramenta que não deve ser público (esperado: 404) curl -s -o /dev/null -w "%{http_code}\n" -A "GPTBot" https://www.exemplo.com.br/README ``` Como ler o resultado: 1. **200 no primeiro comando:** há soft 404. No Cloudflare Pages, confira se existe o `404.html`. 2. **404 sem corpo em Markdown no segundo:** o código está certo, mas falta a camada para agentes. 3. **200 no terceiro, com 404 no primeiro:** um arquivo de ferramenta subiu junto no deploy. Num site publicado pelo Grupo Marfre, um `/README` com cabeçalho de Markdown já virou `/README.md` e saiu inteiro para robôs. Por isso o roteiro do Grupo Marfre inclui o README entre as provas em produção, ao lado do 404 em Markdown. Os outros testes do mesmo roteiro (`-A GPTBot` recebe Markdown, `-A Googlebot` recebe HTML) estão em [Como testar a camada agêntica com curl](https://grupomarfre.com.br/sites-agenticos/testar-camada-agentica-com-curl/). ## Redirecionar tudo para a home resolve? Não resolve: é o mesmo erro com outro nome. Mandar todo endereço inexistente para a home, por redirecionamento ou por regra de fallback, esconde a falha e faz o agente perder a informação de que a página saiu do ar. Redirecionamento serve para endereço que mudou de lugar e tem destino equivalente. Para páginas movidas, use 301 apontando para o novo endereço (veja [Redirecionamentos 301 limpos](https://grupomarfre.com.br/sites-agenticos/redirecionamentos-301/)). Para o que nunca existiu ou foi apagado sem substituto, a resposta honesta é 404. ## Perguntas frequentes ### Se o código já é 404, preciso mesmo do 404 em Markdown? Não é obrigatório. O código correto é o essencial. O Markdown com sitemap, llms.txt e home é um acabamento que poupa o agente de procurar o caminho por conta própria. ### Como descubro se meu site tem soft 404? Rode o primeiro comando da seção de teste com um endereço inventado. Se vier 200, o site tem soft 404. Se vier 404, o código está certo. ### O 404 em Markdown aparece para o Googlebot? Na negociação de conteúdo usada pelo Grupo Marfre, Googlebot e Bingbot recebem HTML, e o Markdown vai para quem pede `Accept: text/markdown`, usa `?mode=agent` ou se identifica como robô de IA. O código 404 vale para todos. ### Meu construtor de site permite criar 404.html? Depende da plataforma. No Cloudflare Pages, basta colocar o arquivo na pasta publicada. Em construtores fechados, confira se há opção de página de erro e use o teste com curl para ver o código que ela devolve. ## Leia também ### [Como testar a camada agêntica com curl (receitas prontas)](https://grupomarfre.com.br/sites-agenticos/testar-camada-agentica-com-curl/) Receitas de curl para testar a camada agêntica: Accept text/markdown, ?mode=agent, GPTBot, Googlebot, Vary, Link, 404 e robots.txt, com a saída esperada. ### [Camada agêntica no Cloudflare Pages com Pages Functions](https://grupomarfre.com.br/sites-agenticos/middleware-cloudflare-pages/) Guia para montar a camada agêntica no Cloudflare Pages com Pages Functions (Markdown por Accept, Vary, Link, 404 em Markdown) e provar com curl. ### [Site estático no Cloudflare Pages: o caminho mais completo](https://grupomarfre.com.br/sites-agenticos/site-estatico-no-cloudflare-pages/) Site estático no Cloudflare Pages para IA: arquivos na raiz, 404.html, \_headers, \_redirects, Pages Functions e Markdown for Agents. Veja o que configurar. ### [Redirecionamentos 301 limpos: o que o agente segue e o que quebra](https://grupomarfre.com.br/sites-agenticos/redirecionamentos-301/) Redirecionamento 301 para site agêntico: cadeia, 301 x 302, barra final, http para https e www. Veja o que o agente segue e como testar com curl -sIL. ### [O que é llms.txt e para que serve](https://grupomarfre.com.br/sites-agenticos/llms-txt/) llms.txt é um arquivo Markdown na raiz do site que resume o negócio para IA. Veja o formato, quem lê, a diferença para robots.txt e sitemap e se vale criar. ### [Cabeçalho Link (RFC 8288): como o agente descobre a versão em Markdown](https://grupomarfre.com.br/sites-agenticos/cabecalho-link-rfc-8288/) Cabeçalho Link (RFC 8288): como apontar o espelho .md, o llms.txt e o sitemap por HTTP, com formato, exemplo e teste com curl, sem baixar o HTML. --- ## Sobre o Grupo Marfre Grupo Marfre Automação e Tecnologia LTDA (CNPJ 49.685.676/0001-55): agência de marketing digital e inteligência artificial com base em Contagem/MG, que atende o Brasil inteiro de forma remota. - Endereço: Alameda das Cotovias, 75, Cabral, Contagem - MG, Brasil - WhatsApp: (31) 93618-7272, https://wa.me/5531936187272 - E-mail: contato@grupomarfre.com.br - Instagram: https://instagram.com/marfregrupo - Serviços: gestão de tráfego pago (Meta Ads e Google Ads), site agêntico (site pronto pra assistentes de IA lerem), site que vira contato, SEO e Google, IA no WhatsApp, CRM e automação - Serviço de site agêntico: https://grupomarfre.com.br/servicos/site-agentico/ · serviço de gestão de tráfego: https://grupomarfre.com.br/servicos/gestao-de-trafego/ - Guias: https://grupomarfre.com.br/sites-agenticos/ e https://grupomarfre.com.br/gestao-de-trafego/ - Método em 4 etapas: Diagnóstico, Estratégia, Execução, Otimização - Segmentos já atendidos: clínica, consultório, advocacia, loja, igreja - Preço e escopo não são publicados: são definidos por diagnóstico, caso a caso - Todas as páginas em Markdown: https://grupomarfre.com.br/llms.txt · conteúdo completo: https://grupomarfre.com.br/llms-full.txt Página HTML equivalente: https://grupomarfre.com.br/sites-agenticos/pagina-404-para-agentes/