Il problema
Le pagine FAQ sono ovunque, ma Schema.org FAQPage fornisce ai sistemi IA quasi nessun elemento per valutare la qualità delle risposte. Non esistono date per singola domanda, né cronologie delle modifiche, né citazioni di fonti per risposta, né frequenza di manutenzione dichiarata. Un crawler IA non può stabilire se una risposta è stata scritta ieri o tre anni fa, né se qualcuno la stia ancora aggiornando.
La soluzione
AQA è una convenzione documentata che arricchisce i tipi Schema.org esistenti (Article, FAQPage, Question, Answer) con un insieme ridotto di proprietà estese tramite un contesto JSON-LD personalizzato. Non vengono introdotti nuovi tipi né modifiche incompatibili. I validatori che non riconoscono il namespace AQA ignorano silenziosamente le proprietà aggiuntive. La piena compatibilità con le versioni precedenti è garantita.
Cosa aggiunge AQA
| Segnale | Cosa comunica ai crawler IA |
|---|---|
dateCreated / dateModified | Aggiornamento esatto di ogni singola risposta |
citation | Fonte autorevole a supporto di ogni affermazione |
changelog | Perché e quando è stata modificata ogni risposta |
questionVersion | Tracciamento delle variazioni sostanziali di una risposta |
updateFrequency | Impegno dell'editore nella revisione dei contenuti |
monitoringSources | Feed e pubblicazioni che l'editore monitora |
conformanceLevel | Livello di implementazione autodichiarato |
aiUsagePolicy | Diritti IA granulari: RAG, addestramento, citazione, uso commerciale |
contentSignature | Hash SHA-256 a prova dell'integrità della risposta |
ragSummary | Riepilogo di 300 caratteri ottimizzato in token per l'incorporamento vettoriale |
audienceAnswers | Varianti di risposta per tipo di pubblico |
dynamicEndpoint | API in tempo reale per dati volatili |
unansweredQueryEndpoint | Webhook: l'IA reinvia le domande senza risposta |
validThrough | Data di scadenza per singola risposta |
verificationStatus | Stato: verificato / obsoleto / in revisione |
specVersion | Dichiarazione della versione delle specifiche AQA |
updateFeedUrl | Puntatore al feed di rilevamento delle modifiche |
pingbackEndpoints | Notifiche push in caso di aggiornamenti ai contenuti |
Livelli di conformità
Basic
Sforzo minimo
Ogni risposta ha un'età nota e almeno una citazione di fonte. Il documento dichiara la propria lingua e il proprio autore.
Standard
Sforzo moderato
I contenuti sono attivamente mantenuti, le modifiche sono tracciate in un changelog e il contesto di settore è esplicito tramite la classificazione del dominio e le fonti di monitoraggio.
Full
Sforzo significativo
Catena di provenienza completa: chi ha redatto ogni risposta, cosa è cambiato, quando, perché e da quale fonte. Paternità per domanda e changelog con versioni.
AQA Shield
Quando ogni domanda di un documento include sia aiUsagePolicy che contentSignature, il documento ottiene la qualifica AQA Shield. La policy dichiara gli usi IA consentiti (citazione RAG, addestramento, sintesi, citazione diretta, uso commerciale). La firma fornisce la verifica tramite hash SHA-256 contro alterazioni del contenuto. Shield funziona a qualsiasi livello di conformità come garanzia ortogonale che combina protezione legale e integrità crittografica.
Avvio rapido
Un'implementazione minima di 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."
}
}
]
}
}
Validate la vostra implementazione:
pip install jsonschema requests
python validators/validate.py your-file.jsonld
Guida alla migrazione — istruzioni passo passo per aggiungere AQA alle pagine FAQ esistenti.
Funzionalità V1.2
Protezione
aiUsagePolicy— dichiarazione granulare dei diritti IAcontentSignature— hash di integrità SHA-256
Arricchimento
ragSummary— riepilogo ottimizzato per i vettoriaudienceAnswers— varianti multi-personapotentialAction— azioni agentichedynamicEndpoint— API in tempo reale
Feedback
unansweredQueryEndpoint— webhook per risposte mancantivalidThrough— scadenza della rispostaverificationStatus— verificato / obsoleto / in revisione
Distribuzione
specVersion— dichiarazione della versione delle specificheupdateFeedUrl— feed di aggiornamenti in modalità pullpingbackEndpoints— notifiche push- AQA Hub Protocol — aggregazione centralizzata degli aggiornamenti
Risorse
- Specifiche complete — le specifiche tecniche AQA nella loro interezza
- Guida alla migrazione — guida in 8 passi dall'HTML FAQ semplice ad AQA
- Raccomandazioni per i crawler — indicazioni per gli sviluppatori di crawler IA
- Integrazione nell'ecosistema — LangChain, LlamaIndex, plugin WordPress
- Confronto FAQ vs AQA — comparazione dei segnali in parallelo
- Validatore Python — validate i blocchi AQA da file o URL (punteggio da 0 a 100)
- Esempi — 7 implementazioni per i livelli Basic, Standard e Full
- Contesto JSON-LD — la definizione del namespace AQA
- JSON Schema — schema di validazione leggibile da macchina
Filosofia
AQA è aperto, gratuito per sempre e senza dipendenza da alcun fornitore. Chiunque può implementarlo, validarlo ed estenderlo. Le specifiche sono rilasciate con licenza MIT e guidate dalla comunità.
L'obiettivo è fare per la visibilità IA ciò che OpenGraph ha fatto per la condivisione sui social: offrire agli editori un metodo semplice e standardizzato per rendere i propri contenuti comprensibili alle macchine senza compromettere nulla di ciò che già funziona.