Como tornar a documentação pronta para IA para ChatGPT e Claude
O que realmente torna uma central de ajuda legível pelo ChatGPT, Claude, Perplexity e agentes de IA: HTML rastreável, as regras corretas no robots.txt, artigos que respondem primeiro e uma análise honesta sobre llms.txt e MCP.
Berkay Akpolat15 min de leitura
Atualizado em 3 de novembro de 2026
Para tornar a documentação pronta para IA, comece pelo básico que comprovadamente importa: os rastreadores de IA devem ser capazes de buscar suas páginas como HTML simples, seu robots.txt deve permitir a entrada dos bots de busca e cada artigo deve responder a uma pergunta claramente, com plano, função e limites declarados. Mantenha as páginas atualizadas e, em seguida, adicione cópias em Markdown, um llms.txt e um servidor MCP para agentes de IA. Esses extras são baratos, mas seu efeito mensurável nas respostas da IA ainda é pequeno.
Este guia é para líderes de suporte cujos clientes agora perguntam ao ChatGPT, Perplexity ou aos AI Overviews do Google como usar seu produto, e para equipes cujos desenvolvedores apontam o Claude Code ou o Cursor para sua documentação. Ele separa o que tem evidências por trás do que ainda é uma aposta.
O que significa documentação pronta para IA?
Documentação pronta para IA é aquela que os sistemas de IA podem buscar, entender e citar corretamente: documentação legível por IA para mecanismos de resposta e documentação para agentes de IA que agem com base nela. Dois tipos de leitor importam:
- Mecanismos de resposta (busca do ChatGPT, Perplexity, Claude, Google AI Overviews e AI Mode) respondem às perguntas dos seus clientes e citam páginas como fontes.
- Agentes de IA (Claude Code, Cursor, Codex, assistentes personalizados) leem sua documentação para realizar uma tarefa, geralmente por meio de arquivos Markdown ou um servidor MCP.
Ambos estão crescendo rapidamente. A pesquisa de 2025 do Stack Overflow descobriu que 84% dos desenvolvedores usam ou planejam usar ferramentas de IA, e a Similarweb contabilizou 1,13 bilhão de visitas de referência de plataformas de IA em junho de 2025, um aumento de 357% em relação ao ano anterior, com o ChatGPT enviando mais de 80% delas. E quando o Google mostra um resumo de IA, as pessoas clicam menos: o Pew Research descobriu que os usuários clicaram em um link de resultado em 8% das visitas com um resumo de IA, contra 15% sem um. Se a resposta é mostrada sem o clique, a resposta precisa estar correta, e ela é tão correta quanto sua documentação. Mais números sobre onde os clientes procuram ajuda estão em nossas estatísticas de autoatendimento do cliente.
Os rastreadores de IA conseguem realmente ler sua central de ajuda?
Verifique isso primeiro, porque nada mais importa se a resposta for não.
O texto está no HTML? A análise de tráfego de rastreadores da Vercel de dezembro de 2024 descobriu que nenhum dos principais rastreadores de IA renderiza JavaScript, sendo o rastreador do Gemini do Google e o da Apple as exceções. Uma central de ajuda que carrega seus artigos com JavaScript do lado do cliente pode parecer vazia para os rastreadores do ChatGPT e do Claude. Teste isso:
curl -s -A "GPTBot" https://help.example.com/your-article \
| grep "a sentence from the article"Se a frase não estiver na resposta, o rastreador também não a vê. Páginas renderizadas no servidor ou pré-renderizadas resolvem isso.
Suas URLs resolvem? Nos mesmos dados da Vercel, cerca de 35% das buscas dos rastreadores do ChatGPT e do Claude atingiram páginas 404. Mantenha redirecionamentos ao mover ou renomear artigos e mantenha o sitemap atualizado. Se você estiver mudando de plataforma, siga um checklist de migração de central de ajuda.
A página é pública? Mecanismos de resposta não conseguem ler páginas atrás de um login. Se você tem documentação privada para clientes, aceite que as respostas da IA virão de suas páginas públicas, fóruns e sites de terceiros.
Quais bots de IA seu robots.txt deve permitir?
Cada empresa de IA executa bots separados para treinamento e para busca. Bloquear "todos os bots de IA" também remove você das respostas da IA.
| Bot (empresa) | O que faz | Bloqueie se… |
|---|---|---|
| GPTBot (OpenAI) | Coleta conteúdo para treinamento de modelo | Você deseja optar por não participar do treinamento |
| OAI-SearchBot (OpenAI) | Encontra páginas para mostrar na busca do ChatGPT | Raramente: bloqueá-lo mantém você fora das respostas de busca do ChatGPT |
| ChatGPT-User (OpenAI) | Busca uma página quando um usuário pergunta | Não é prático: buscas iniciadas pelo usuário podem não seguir o robots.txt |
| ClaudeBot (Anthropic) | Coleta conteúdo para treinamento | Você deseja optar por não participar do treinamento |
| Claude-SearchBot, Claude-User (Anthropic) | Indexação de busca e buscas solicitadas pelo usuário | Apenas para sair das respostas de busca do Claude |
| PerplexityBot (Perplexity) | Indexa páginas para citar em respostas, não para treinamento | Apenas para sair das respostas do Perplexity |
| Perplexity-User (Perplexity) | Busca uma página quando um usuário pergunta | Não é prático: o Perplexity diz que geralmente ignora o robots.txt |
| Google-Extended (Google) | Treinamento do Gemini e fundamentação em aplicativos Gemini; não busca ou AI Overviews | Você deseja optar por não participar do treinamento e fundamentação do Gemini |
Os detalhes vêm da própria documentação de cada empresa: OpenAI, Anthropic e Perplexity. Uma central de ajuda que deseja ser citada, mas não usada para treinamento, pode dizer:
User-agent: GPTBot
Disallow: /
User-agent: ClaudeBot
Disallow: /
User-agent: Google-Extended
Disallow: /
User-agent: *
Allow: /
Sitemap: https://help.example.com/sitemap.xmlUm bot que tem seu próprio grupo ignora as regras *, então repita quaisquer linhas Disallow (como /admin) em cada grupo nomeado. Bloquear o Google-Extended também impede que os aplicativos Gemini fundamentem respostas em suas páginas; a Busca do Google e o AI Overviews não são afetados.
Verifique também sua CDN ou firewall. Um botão de "bloquear bots de IA" lá pode substituir um robots.txt permissivo.
Como você deve escrever artigos de ajuda para que a IA responda corretamente?
Mecanismos de resposta extraem um trecho, não todo o seu site. Cada trecho precisa se sustentar sozinho.
- Uma tarefa por artigo, nomeada da forma como os clientes perguntam. "Cancelar ou pausar sua assinatura", não "Gerenciamento de assinatura".
- Responda primeiro. As duas primeiras frases sob cada título devem responder a esse título. Nosso modelo de artigo de central de ajuda é construído dessa forma.
- Declare as condições. Qual plano, qual função, qual plataforma. "Apenas administradores podem excluir um espaço de trabalho" é citável; "você pode excluir um espaço de trabalho" produz respostas erradas para todos os outros.
- Diga o que o produto não pode fazer. Frequentemente perguntam aos assistentes "posso…?" Se sua documentação descreve apenas o que existe, o modelo adivinha.
- Use um nome por coisa e defina-o uma vez. Se "espaço de trabalho", "conta" e "organização" significam a mesma coisa, escolha um e mantenha uma página de glossário curta que defina os termos do seu produto.
- Dê a cada página metadados limpos. Um título específico, uma descrição de uma linha, uma data da última atualização e, onde aplicável, o plano ou área do produto. Mecanismos de resposta e sua própria busca usam isso para decidir qual página responde a uma pergunta.
- Não esconda etapas em imagens ou vídeos. Dê a cada captura de tela um texto alternativo real e certifique-se de que cada etapa que um vídeo mostra também exista como texto.
- Cubra o básico antes dos casos extremos. Se você ainda está construindo a central de ajuda, comece com como construir uma base de conhecimento com IA.
- Mantenha-o atualizado. Um artigo desatualizado agora é uma resposta desatualizada, repetida com confiança. Nosso guia para manter a documentação atualizada cobre uma rotina de lançamento por lançamento, e como atualizar automaticamente a documentação a cada lançamento mostra como iniciá-la a partir do próprio lançamento.
O Google diz o mesmo em palavras mais simples: para seus recursos de IA, "não há requisitos adicionais" e nenhuma otimização especial necessária além do SEO normal. Seu guia também diz que não há necessidade de dividir seu conteúdo em pedaços minúsculos para a IA, então não corte artigos em fragmentos para atender a um modelo.
Você deve adicionar llms.txt para documentação?
Ajuda menos do que os fornecedores sugerem. llms.txt é um arquivo Markdown na raiz do seu site que lista suas páginas mais úteis com descrições curtas. Jeremy Howard propôs isso em setembro de 2024 como um mapa para modelos de linguagem.
As evidências até agora:
- O Google ignora isso. O guia do Google diz que você não precisa de novos arquivos legíveis por máquina, arquivos de texto de IA, marcação ou Markdown para aparecer na Busca do Google, e que arquivos llms.txt não ajudarão nem prejudicarão, pois a Busca os ignora. Em 2025, John Mueller, do Google, comparou o llms.txt à meta tag de palavras-chave.
- Poucos bots solicitam isso. A Ahrefs estudou 137.210 domínios e descobriu que 97% dos arquivos llms.txt não receberam nenhuma solicitação em maio de 2026. Bots de recuperação de IA fizeram apenas 1,1% das solicitações que chegaram (assistentes de IA, outros 2,5%); agentes de codificação como o Claude Code estavam entre os principais leitores nomeados.
Portanto: adicione um llms.txt se sua plataforma de documentação o disponibiliza gratuitamente, especialmente se os desenvolvedores usam sua documentação com agentes de codificação, mas não espere que isso mude o que o ChatGPT diz sobre você. llms-full.txt (todas as páginas em um arquivo) é uma convenção comum, não parte da proposta.
Sua documentação deve estar disponível em Markdown?
Sim, se não lhe custar nada. Agentes que buscam uma página funcionam melhor com Markdown limpo do que com HTML cheio de navegação e scripts, e a proposta llms.txt sugere servir cada página na mesma URL com .md adicionado. Três detalhes:
- Marque as cópias em Markdown com
noindex(um cabeçalhoX-Robots-Tagfunciona), para que os mecanismos de busca não as tratem como duplicatas das páginas HTML. - Mantenha-as geradas a partir da mesma fonte que o HTML, para que nunca fiquem defasadas.
- Deixe que os agentes as encontrem: a proposta sugere uma tag
<link rel="alternate" type="text/markdown">em cada página HTML.
Como os agentes de IA usam a documentação via MCP?
O Model Context Protocol é um padrão aberto que permite que uma aplicação de IA chame ferramentas e leia dados de outros sistemas. Um servidor MCP de documentação permite que um agente pesquise sua documentação sob demanda em vez de depender do que aprendeu no treinamento e, com as permissões corretas, redija ou atualize páginas. Para uma comparação dos servidores disponíveis, veja servidores MCP para documentação.
As mesmas regras se aplicam se você criar seu próprio assistente com base na sua documentação (geração aumentada por recuperação, ou RAG): ele só pode ser tão preciso quanto as passagens que recupera. Dois avisos: conceda acesso somente leitura a qualquer conteúdo voltado ao cliente, a menos que uma pessoa revise as edições, e lembre-se de que o MCP ajuda os agentes que seus usuários conectam por conta própria. Isso não altera o que os mecanismos de resposta públicos dizem.
Como você testa o que os assistentes de IA dizem sobre seu produto?
Ninguém consegue ver dentro dos modelos, então teste a saída. Uma vez por mês:
- Anote 20 perguntas reais de clientes vindas de tickets e buscas malsucedidas na central de ajuda.
- Faça cada uma delas no ChatGPT, Perplexity, Claude e Google (Modo IA ou Visões Gerais de IA).
- Registre se a resposta está correta e qual página ela cita.
| Pergunta (assistente) | O que disse (fonte citada) | Correção |
|---|---|---|
| Como exporto faturas para CSV? (ChatGPT) | Parcialmente correto: um caminho de menu antigo (post de fórum de 2024) | Atualize o artigo de exportação; coloque o novo caminho no primeiro parágrafo |
| Posso pausar minha assinatura? (Perplexity) | Errado: diz que não é possível (sem fonte) | Adicione um artigo "Pausar ou cancelar" que indique os limites do plano |
- Corrija o artigo de onde cada resposta errada deveria ter vindo e, em seguida, pergunte novamente no mês seguinte.
Para ver o lado do tráfego, segmente as visitas por referenciador (chatgpt.com, perplexity.ai, claude.ai) e verifique os logs do seu servidor em busca dos nomes dos bots na tabela acima (exceto o Google-Extended, que não possui um user agent próprio). O Google conta cliques de recursos de IA no Relatório de Desempenho do Search Console, sob o tipo de pesquisa Web.
Como tornar a documentação pronta para IA: o checklist
| Prioridade | Tarefa | Evidência |
|---|---|---|
| 1 | Texto do artigo presente no HTML sem JavaScript | Forte: os principais crawlers de IA não renderizam JS |
| 2 | robots.txt e firewall permitem a entrada de bots de busca (bots de treinamento opcionais) | Forte: documentado por cada empresa de IA |
| 3 | Uma tarefa por artigo, resposta primeiro, plano e função declarados | Bom: corresponde à orientação do Google |
| 4 | Conteúdo atualizado a cada lançamento; sem erros 404 | Bom: páginas obsoletas produzem respostas erradas |
| 5 | Sitemap atualizado | Bom: descoberta padrão |
| 6 | Cópia em Markdown de cada página, noindexed | Moderado: usado por agentes de codificação |
| 7 | llms.txt | Fraco até agora: poucas solicitações, o Google ignora |
| 8 | Servidor MCP para agentes | Útil para usuários de agentes; sem efeito em respostas públicas |
| Sempre | Teste mensal de 20 perguntas reais | Sua própria evidência |
Como as centrais de ajuda da Clevera são criadas para leitores de IA
A Clevera é uma plataforma de IA que transforma uma gravação de tela em um vídeo narrado de instruções, um artigo de ajuda passo a passo e uma página na sua central de ajuda hospedada, em 74 idiomas. Suas centrais de ajuda hospedadas lidam com a maior parte da metade técnica do checklist, em todos os planos, incluindo o Gratuito:
- Páginas pré-renderizadas e um sitemap, para que o texto do artigo esteja no HTML que os crawlers buscam.
llms.txt,llms-full.txte uma cópia.mdde cada página, sob a configuração llms.txt e cópias em Markdown ("Permite que ferramentas de IA leiam sua documentação"), que está ativada por padrão. Em nossa própria central de ajuda, as cópias em Markdown são servidas comnoindex. Centrais de ajuda privadas (Pro e superior) mantêm tudo isso atrás do login.- Pergunte à IA para seus leitores (ative Mostrar o assistente em Configurações → Assistente de IA; 300 respostas por mês no Gratuito). O assistente integrado responde apenas a partir de suas páginas publicadas, vincula suas fontes, informa quando a documentação não cobre uma pergunta e lista essas perguntas em Perguntas não respondidas para que você saiba o que escrever a seguir (nosso guia sobre lacunas de conteúdo na central de ajuda mostra como resolvê-las).
- Agentes de IA e MCP (Pro e superior). Claude Code, Codex, Cursor, Claude ou ChatGPT podem pesquisar, redigir e, com direitos de publicação, atualizar sua central de ajuda por meio do servidor MCP e da API da Clevera. Um token de Assistente de suporte só pode pesquisar páginas públicas publicadas.
Este é o topo do llms.txt que nossa própria central de ajuda publica (abreviado):
# Clevera Help Center
> Clevera turns screen recordings into polished videos: record your screen
> or let the AI record a website, edit with zooms, captions and AI
> voice-overs, then share or embed the result. ...
Every page is also available as Markdown: append `.md` to its URL.
The full text of all pages is at https://help.clevera.ai/llms-full.txt.
### Getting started
- [Understand what Clevera makes](https://help.clevera.ai/docs/getting-started/what-clevera-makes.md): ...
A parte da escrita ainda é sua, e a Clevera também ajuda nisso: artigos gerados a partir de uma gravação de tela saem como etapas numeradas com capturas de tela do que está na tela, e a gravação por trás de um vídeo também pode produzir seu artigo escrito, para que as etapas não vivam apenas em um vídeo. Nenhuma plataforma pode prometer que o ChatGPT citará você, e nós também não.
Comece gratuitamente com uma central de ajuda hospedada ou importe a sua atual do Zendesk, Intercom, GitBook e outras plataformas. As configurações estão em Controlar quem pode ler um site de documentação, Configurar o assistente do site de documentação e Conectar agentes de IA aos seus sites de documentação. A visão geral do produto está na página de software de central de ajuda e em nosso post de lançamento de sites de documentação.
FAQ
Vale a pena adicionar o llms.txt a uma central de ajuda?
Adicione-o se sua plataforma o gerar gratuitamente. Não custa nada e os agentes de codificação o leem, mas o Google não o usa e estudos mostram quase nenhuma solicitação de bots de busca de IA. HTML rastreável e artigos claros e atuais importam muito mais.
Como faço para que o ChatGPT responda corretamente a perguntas sobre meu produto?
Certifique-se de que o OAI-SearchBot possa rastrear sua central de ajuda pública, que o texto do artigo esteja no HTML e que cada artigo responda a uma pergunta com as condições declaradas. Em seguida, teste perguntas reais de clientes mensalmente e corrija as páginas por trás de respostas erradas. Isso melhora as chances; ninguém pode fazer o ChatGPT citar você.
Devo bloquear o GPTBot e o ClaudeBot?
Essa é uma decisão de treinamento, não de visibilidade. Bloquear o GPTBot e o ClaudeBot mantém sua documentação fora do treinamento de modelos; isso não remove você da busca do ChatGPT ou do Claude, que usam o OAI-SearchBot e o Claude-SearchBot. Não bloqueie esses se você quiser ser citado.
Dados estruturados ajudam nas Visões Gerais de IA?
O Google diz que nenhum esquema especial é necessário para recursos de IA. Use dados estruturados onde eles descrevem conteúdo visível, como faria para uma pesquisa normal.
Qual é a diferença entre documentação pronta para IA e um chatbot de IA na minha central de ajuda?
Documentações prontas para IA ajudam assistentes externos a responder com base em suas páginas. Um chatbot de central de ajuda, como o Ask AI da Clevera, responde aos seus leitores em seu próprio site a partir das mesmas páginas. Ambos dependem de artigos claros e atualizados.
