Docsbook
Visão geral

AEO — Otimização para mecanismos de resposta

Um mecanismo de resposta — um snippet em destaque do Google, um assistente de voz, um auxiliar de IA integrado ao produto — não lê sua página. Ele escolhe uma passagem dela, mostra essa passagem em vez da página e segue adiante. AEO é o trabalho de garantir que uma passagem da sua página seja aquela que pode ser escolhida e que continue correta depois de ser retirada de seu contexto.

O Docsbook faz duas coisas para isso. Ele emite marcação legível por máquinas que descreve as perguntas e os procedimentos que sua página já contém, com uma única opção. E ele escreve e aplica conteúdo com base em um conjunto de regras voltadas para a passagem, não para a página — essas regras são a parte que realmente altera o resultado e estão em Regras de conteúdo para mecanismos de resposta.

Esta página aborda o que um mecanismo de resposta precisa, o que o Docsbook fornece sem que você precise solicitar e o que fica por sua conta.

Respostas estruturadas

cada tipo do schema.org emitido pelo Docsbook, o que o aciona, o formato exato em Markdown, o JSON-LD real emitido e o que acontece quando a marcação é gerada incorretamente

Regras de conteúdo para mecanismos de resposta

as regras numeradas pelas quais o Docsbook escreve, o que cada uma faz para um agente de resposta e quais são aplicadas automaticamente em vez de apenas recomendadas

O que um mecanismo de respostas precisa de uma página?#

Quatro coisas, nesta ordem. As duas primeiras são estruturais e o Docsbook cuida delas; as duas últimas são o que você escreve.

Necessidade Por que o mecanismo precisa disso Quem fornece
O texto chega sem JavaScript Os rastreadores de recuperação obtêm HTML; o conteúdo renderizado por um script do navegador não está disponível na busca Docsbook — as páginas são HTML estático renderizado no servidor
O trecho é avaliado por si só O Google executa um sistema de classificação de trechos para "identificar seções individuais ou 'trechos' de uma página da web" (Google) Você — uma seção que só faz sentido depois das três anteriores perde
A resposta está na frase de abertura Os modelos usam melhor as informações no início ou no fim de um contexto e apresentam desempenho inferior no meio (Liu et al., TACL) Você
Um fato aproveitável — um número, um limite, uma definição Estatísticas, citações e fontes referenciadas aumentaram mensuravelmente a visibilidade em respostas generativas (GEO, KDD 2024) Você

A marcação não aparece em nenhum ponto dessa lista, e essa ordem é deliberada. A marcação descreve o conteúdo; ela não o cria.

O que o Docsbook emite automaticamente?#

Cada página de documentação contém um bloco <script type="application/ld+json"> que inclui um @graph do schema.org. Há três objetos nele em todas as páginas, independentemente das suas configurações: um Organization para o proprietário do projeto, um TechArticle para a própria página e um BreadcrumbList criado a partir da mesma URL canônica usada pelo <link rel="canonical"> da página.

Ativar o AEO na aba SEO / GEO do painel administrativo adiciona mais três, cada um somente quando a página realmente contém o conteúdo correspondente:

  • FAQPage — quando a página tem uma seção de FAQ ou um H3 em formato de pergunta. Até 20 perguntas, cada resposta limitada a 1.000 caracteres.
  • HowTo — quando um título iniciado por "How to" (ou pelo russo "Как") é seguido por uma lista numerada de pelo menos três etapas. Até 5 procedimentos por página, com 20 etapas cada.
  • speakable — um SpeakableSpecification dentro do TechArticle, nomeando .tldr, o primeiro parágrafo do artigo e o H1, nessa ordem de preferência.

Uma página sem FAQ não recebe nenhum FAQPage, e um procedimento de duas etapas não recebe nenhum HowTo. Esse é o comportamento planejado, não uma lacuna: a política de dados estruturados do Google diz "Don't mark up content that is not visible to readers of the page", e violá-la pode resultar em uma ação manual que remove a elegibilidade para resultados avançados (Google). Os gatilhos, limites e JSON emitido exatos estão em Respostas estruturadas.

O AEO é uma opção disponível em todos os planos. Os agentes que aplicam as regras de redação para você são um recurso pago — consulte os preços.

Por que esta é a maneira correta (evidências)#

Regra seguida pelo Docsbook Por que funciona na máquina que o consome Fonte
Emitir JSON-LD, não microdados "O Google recomenda usar JSON-LD para dados estruturados se a configuração do seu site permitir" Google, introdução aos dados estruturados
Emitir marcação apenas para conteúdo que está na página "Não marque conteúdo que não esteja visível para os leitores da página" — violar essa regra pode desencadear uma ação manual Google, diretrizes para dados estruturados
Emitir BreadcrumbList em todas as páginas A trilha de navegação é um dos resultados avançados que o Google ainda oferece, e a trilha "indica a posição da página na hierarquia do site" Google, trilha de navegação, galeria de pesquisa
Apontar speakable para o resumo, não para a página inteira A orientação do Google é marcar os "pontos principais", em vez de artigos inteiros, aproximadamente duas ou três frases Google, conteúdo falável
Tratar o trecho, não a página, como unidade O sistema de classificação por trechos do Google avalia seções individuais de uma página Google, guia dos sistemas de classificação
Nunca prometer um snippet ou uma citação Uma pesquisa de 2026 com 45 estudos de GEO concluiu que "nenhuma técnica analisada demonstra um efeito causal estável, longitudinal e multiplataforma sobre a capacidade de descoberta orgânica" Martinez, arXiv 2607.14035

Limites e questões em aberto#

  • O Google já não exibe resultados avançados de FAQ ou How-to, e não vamos fingir o contrário. O Google removeu o resultado avançado de How-to em setembro de 2023 — "já não é exibido nos resultados de pesquisa, tanto em computadores como em dispositivos móveis" — e, ao mesmo tempo, restringiu o FAQ a sites governamentais e de saúde conhecidos. O FAQ foi então descontinuado de forma definitiva: o próprio registo de atualizações do Google informa que "esta funcionalidade deixará de aparecer na Pesquisa Google a partir de 7 de maio de 2026", e a documentação foi removida em 15 de junho de 2026 (atualizações da documentação do Google). Nenhum dos dois tipos aparece na atual galeria de resultados avançados compatíveis. O que FAQPage e HowTo ainda fazem é tornar explícitas as perguntas e respostas e o procedimento para qualquer sistema que analise JSON-LD. O que já não fazem é produzir um resultado avançado no Google. Se um fornecedor lhe disser o contrário, peça a data da fonte.
  • Não é possível obter um snippet em destaque apenas com marcação. Quando perguntado sobre como marcar uma página como snippet em destaque, o Google responde: "Não é possível. Os sistemas do Google determinam se uma página seria um bom snippet em destaque para a consulta de pesquisa de um utilizador e, em caso afirmativo, elevam-na" (Google, snippets em destaque). Os snippets em destaque são conquistados pelo texto. É por isso que Regras de conteúdo é a página mais longa das duas.
  • speakable está em versão beta e tem critérios restritos. A implementação do Google "está em versão beta e sujeita a alterações", é limitada a editores de notícias e destina-se a "utilizadores nos EUA que tenham dispositivos Google Home configurados para inglês" (Google, speakable). Um site de documentação não é um editor de notícias; portanto, trate a marcação como uma declaração correta sobre qual parte da página é o resumo, não como um caminho para um altifalante inteligente.
  • Em aberto: outros assistentes de voz. Versões anteriores desta página afirmavam que a Amazon Alexa lia a marcação speakable. Não encontrámos uma fonte primária da Amazon que afirmasse isso, e o schema.org não publica nenhuma lista de consumidores. O que é verificável: speakable é uma propriedade do schema.org, o Google documenta uma utilização beta dela e nada mais é documentado pelo respetivo fornecedor. Considere não comprovada qualquer afirmação sobre a Alexa e speakable.
  • Em aberto: saber se os mecanismos de resposta de IA leem JSON-LD. Nenhum fornecedor de modelos — OpenAI, Anthropic, Google ou Perplexity — publica uma declaração de que o seu pipeline de recuperação analisa marcação do schema.org. Análises de terceiros correlacionam JSON-LD com citações, mas a correlação em páginas rastreadas não consegue separar a marcação da qualidade do site que normalmente a acompanha. Até que um fornecedor o documente, a posição honesta é que o JSON-LD elimina a ambiguidade para qualquer sistema que opte por analisá-lo e não oferece nenhum benefício mensurável que possamos demonstrar.
  • Os domínios personalizados não recebem marcação AEO. Um workspace disponibilizado no seu próprio domínio é processado através de um caminho diferente que emite apenas um TechArticle simples — sem BreadcrumbList, sem FAQPage, sem HowTo, sem speakable, e o botão de alternância AEO não tem efeito nesse caso. Nos endereços *.docsbook.io é emitido o grafo completo. Esta é uma limitação conhecida, não uma configuração que possa alterar.
  • Nada no Docsbook valida a marcação que emite. Não existe um linter de schema no pipeline e audit_geo não inspeciona JSON-LD. Verifique uma página com o Teste de resultados avançados do Google ou com o Validador de marcação do Schema depois de ativar o AEO — Respostas estruturadas explica como é uma falha.

Updated

Esta página foi útil?

Desenvolvido por Docsbook