O Problema
Páginas de FAQ estão em todo lugar, mas o Schema.org FAQPage fornece às IAs quase nenhuma informação para avaliar a qualidade das respostas. Não há datas por pergunta, nenhum histórico de alterações, nenhuma citação de fontes por resposta e nenhuma frequência de manutenção declarada. Um rastreador de IA não consegue saber se uma resposta foi escrita ontem ou há três anos, nem se alguém ainda a está mantendo.
A Solução
AQA é uma convenção documentada que enriquece os tipos existentes do Schema.org (Article, FAQPage, Question, Answer) com um conjunto reduzido de propriedades de extensão, por meio de um contexto JSON-LD personalizado. Nenhum tipo novo é criado, nenhuma quebra de compatibilidade é introduzida. Validadores que não reconhecem o namespace AQA simplesmente ignoram as propriedades adicionais. A compatibilidade retroativa é totalmente preservada.
O Que o AQA Acrescenta
| Sinal | O que comunica aos rastreadores de IA |
|---|---|
dateCreated / dateModified | Atualidade exata de cada resposta individual |
citation | Fonte autoritativa que fundamenta cada afirmação |
changelog | Por que e quando cada resposta foi modificada |
questionVersion | Rastreamento de alterações substantivas na resposta |
updateFrequency | Compromisso do editor com a revisão periódica do 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 resposta por tipo de público |
dynamicEndpoint | API em tempo real para dados voláteis |
unansweredQueryEndpoint | Webhook: a IA envia de volta as perguntas sem resposta |
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 em atualizações de conteúdo |
Níveis de Conformidade
Basic
Esforço mínimo
Cada resposta tem uma data de criação conhecida e pelo menos uma citação de fonte. O documento declara o idioma e o autor.
Standard
Esforço moderado
O conteúdo é mantido ativamente, as alterações são registradas em um histórico e o contexto setorial é explicitado por meio de classificação e fontes de monitoramento.
Full
Esforço significativo
Cadeia completa de proveniência: quem escreveu cada resposta, o que mudou, quando, por quê e a partir de onde. Autoria por pergunta e histórico de alterações versionado.
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 em RAG, treinamento, sumarização, citação direta, uso comercial). A assinatura fornece verificação por hash SHA-256 contra adulteração do 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 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 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 o AQA a páginas de FAQ existentes.
Funcionalidades da V1.2
Proteção
aiUsagePolicy— declaração granular de direitos de IAcontentSignature— hash de integridade SHA-256
Enriquecimento
ragSummary— resumo otimizado para vetoresaudienceAnswers— variantes por personapotentialAction— ações agênticasdynamicEndpoint— API em tempo real
Retroalimentação
unansweredQueryEndpoint— webhook para perguntas sem respostavalidThrough— expiração de respostaverificationStatus— verificado / desatualizado / em revisão
Distribuição
specVersion— declaração da versão da especificaçãoupdateFeedUrl— feed de alterações por pullpingbackEndpoints— notificações push- Protocolo AQA Hub — agregação centralizada de atualizações
Recursos
- Especificação Completa — a especificação técnica completa do AQA
- Guia de Migração — guia em 8 etapas do FAQ em HTML simples para 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 nos níveis Basic, Standard e Full
- Contexto JSON-LD — a definição do namespace AQA
- JSON Schema — esquema de validação legível por máquina
Filosofia
O AQA é aberto, gratuito para sempre e não cria dependência de fornecedor. Qualquer pessoa pode implementá-lo, validá-lo e estendê-lo. A especificação tem licença MIT e é conduzida pela comunidade.
O objetivo é fazer pelo visibilidade na IA o que o OpenGraph fez pelo compartilhamento em redes sociais: oferecer aos editores uma forma simples e padronizada de tornar seu conteúdo compreensível por máquinas, sem quebrar nada que já funcione.