AQA — AI Question Answer | Especificação Aberta para Q&A Otimizado para IA

O Problema

Páginas de FAQ estão em toda parte, mas o FAQPage do Schema.org fornece aos sistemas de IA quase nada para avaliar a qualidade das respostas. Não há datas por pergunta, nem registro de alterações, nem citações de fontes por resposta, nem frequência de manutenção declarada. Um rastreador de IA não consegue distinguir se uma resposta foi escrita ontem ou há três anos, ou se alguém ainda a mantém.

A Solução

AQA é uma convenção documentada que enriquece os tipos existentes do Schema.org (Article, FAQPage, Question, Answer) com um pequeno conjunto de propriedades de extensão através de um contexto JSON-LD personalizado. Nenhum novo tipo é criado, nenhuma alteração incompatível é introduzida. Validadores que não compreendem o namespace AQA ignoram silenciosamente as propriedades extras. A compatibilidade retroativa é totalmente preservada.

O Que o AQA Adiciona

Sinal	O que informa aos rastreadores de IA
`dateCreated` / `dateModified`	Frescura exata de cada resposta individual
`citation`	Fonte autoritativa que sustenta cada afirmação
`changelog`	Por que e quando cada resposta foi modificada
`questionVersion`	Rastreia alterações no conteúdo das respostas
`updateFrequency`	Compromisso do editor com a revisão de conteúdo
`monitoringSources`	Feeds e publicações que o editor acompanha
`conformanceLevel`	Profundidade de implementação autodeclarada
`aiUsagePolicy`	Direitos granulares de IA: RAG, treinamento, citação, uso comercial
`contentSignature`	Hash SHA-256 que comprova a integridade da resposta
`ragSummary`	Resumo de 300 caracteres otimizado para incorporação vetorial
`audienceAnswers`	Variantes de respostas específicas por público
`dynamicEndpoint`	API em tempo real para dados voláteis
`unansweredQueryEndpoint`	Webhook: a IA envia perguntas não respondidas de volta
`validThrough`	Data de expiração por resposta
`verificationStatus`	Status: verificado / desatualizado / em revisão
`specVersion`	Declaração da versão da especificação AQA
`updateFeedUrl`	Ponteiro para feed de detecção de alterações
`pingbackEndpoints`	Notificações push sobre atualizações de conteúdo

Níveis de Conformidade

Básico

Esforço mínimo

Cada resposta tem uma data conhecida e pelo menos uma citação de fonte. O documento declara seu idioma e autor.

Padrão

Esforço moderado

O conteúdo é mantido ativamente, as alterações são rastreadas com um registro de mudanças, e o contexto setorial é explicitado por meio de classificação de setor e fontes de monitoramento.

Completo

Esforço significativo

Cadeia completa de proveniência: quem escreveu cada resposta, o que mudou, quando, por quê e de onde. Autoria por pergunta e registros de alterações versionados.

AQA Shield

Quando cada pergunta de um documento inclui tanto aiUsagePolicy quanto contentSignature, o documento se qualifica para o AQA Shield. A política declara os usos de IA permitidos (citação RAG, treinamento, sumarização, citação, uso comercial). A assinatura fornece verificação de hash SHA-256 contra alterações de conteúdo. O Shield funciona em qualquer nível de conformidade como uma garantia ortogonal que combina proteção jurídica e integridade criptográfica.

Início Rápido

Uma implementação mínima do AQA Basic:

{
  "@context": [
    "https://schema.org",
    "https://aqa-spec.org/ns/context.jsonld"
  ],
  "@type": "Article",
  "headline": "Frequently Asked Questions",
  "author": {
    "@type": "Organization",
    "name": "Your Company"
  },
  "datePublished": "2024-01-15",
  "dateModified": "2026-03-20",
  "inLanguage": "en",
  "mainEntity": {
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "Your question here?",
        "dateCreated": "2024-01-15",
        "dateModified": "2026-03-20",
        "citation": "https://source-url.com/document",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Your answer here."
        }
      }
    ]
  }
}

Valide a sua implementação:

pip install jsonschema requests
python validators/validate.py your-file.jsonld

Guia de Migração — instruções passo a passo para adicionar AQA a páginas de FAQ existentes.

Funcionalidades V1.2

Proteção

aiUsagePolicy — declaração granular de direitos de IA
contentSignature — hash de integridade SHA-256

Enriquecimento

ragSummary — resumo otimizado para vetores
audienceAnswers — variantes por persona
potentialAction — ações agênticas
dynamicEndpoint — API em tempo real

Retroalimentação

unansweredQueryEndpoint — webhook para resposta ausente
validThrough — expiração da resposta
verificationStatus — verificado / desatualizado / em revisão

Distribuição

specVersion — declaração da versão da especificação
updateFeedUrl — feed de alterações baseado em pull
pingbackEndpoints — notificações push
AQA Hub Protocol — agregação centralizada de atualizações

Recursos

Especificação Completa — a especificação técnica completa do AQA
Guia de Migração — guia de 8 passos do FAQ em HTML puro até o AQA
Recomendações para Rastreadores — orientações para desenvolvedores de rastreadores de IA
Integração com o Ecossistema — LangChain, LlamaIndex, plugin para WordPress
Comparação FAQ vs AQA — comparação de sinais lado a lado
Validador Python — valide blocos AQA a partir de arquivo ou URL (pontuação de 0 a 100)
Exemplos — 7 implementações entre Basic, Standard e Full
Contexto JSON-LD — a definição do namespace AQA
JSON Schema — esquema de validação legível por máquina

Perguntas Frequentes

Este FAQ implementa AQA Full + Shield. Veja o código-fonte da página (Ctrl+U) para ver o bloco JSON-LD.

O que é o AQA?

AQA (AI Question Answer) é uma especificação aberta que enriquece os dados estruturados FAQPage do Schema.org com metadados que os sistemas de IA precisam para avaliar a qualidade, frescura e proveniência das respostas. Utiliza um contexto JSON-LD personalizado para adicionar propriedades de extensão como datas por pergunta, citações, registros de alterações e políticas de uso de IA aos tipos existentes do Schema.org. O AQA possui licença MIT, é gratuito para sempre e não gera dependência de fornecedor.

O AQA é compatível com Schema.org?

Sim. O AQA utiliza apenas os tipos existentes do Schema.org (Article, FAQPage, Question, Answer) e adiciona propriedades de extensão por meio de um contexto JSON-LD. Validadores que não compreendem o namespace AQA ignoram silenciosamente as propriedades extras. A marcação existente do Schema.org continua funcionando sem alterações. O AQA é um superconjunto estrito — todo bloco AQA válido também é um documento Schema.org válido.

Quais são os níveis de conformidade do AQA?

O AQA define três níveis de conformidade. O Basic exige datas por pergunta, pelo menos uma citação por resposta e autor e idioma no nível do documento. O Standard adiciona frequência de atualização, registro de alterações, versionamento de perguntas, classificação setorial e citações estruturadas. O Full exige fontes de monitoramento, autoria por pergunta com credenciais e proveniência completa de alterações. Todos os níveis são cumulativos — o Standard inclui tudo do Basic, e o Full inclui tudo do Standard.

O que é o AQA Shield?

O AQA Shield é um mecanismo de proteção ortogonal disponível em qualquer nível de conformidade. Um documento se qualifica para o AQA Shield quando cada pergunta inclui tanto uma aiUsagePolicy (declarando os usos de IA permitidos, como citação RAG, treinamento, sumarização, citação e uso comercial) quanto uma contentSignature (hash SHA-256 que comprova a integridade da resposta). O Shield combina declaração jurídica com verificação criptográfica.

Como implementar o AQA no meu site?

Adicione um bloco de script JSON-LD à sua página de FAQ com um contexto duplo que referencia tanto o Schema.org quanto o contexto AQA em https://aqa-spec.org/ns/context.jsonld. Envolva seu FAQ em um Article contendo uma FAQPage, adicione as propriedades dateCreated, dateModified e citation por pergunta, e depois valide com o validador Python. O guia de migração no GitHub fornece 8 passos detalhados, desde um FAQ em HTML puro até uma implementação completa do AQA.

Filosofia

O AQA é aberto, gratuito para sempre e não gera dependência de fornecedor. Qualquer pessoa pode implementá-lo, validá-lo e estendê-lo. A especificação possui licença MIT e é conduzida pela comunidade.

O objetivo é fazer pelo visibilidade em IA o que o OpenGraph fez pelo compartilhamento em redes sociais: dar aos editores uma forma simples e padronizada de tornar seu conteúdo compreensível por máquinas sem quebrar nada que já funcione.