Il Problema
Le pagine FAQ sono ovunque, ma Schema.org FAQPage fornisce ai sistemi di IA quasi nessuno strumento per valutare la qualità delle risposte. Non esistono date per domanda, nessun registro delle modifiche, nessuna citazione di fonte per risposta e nessuna 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 mantenendo.
La Soluzione
AQA è una convenzione documentata che arricchisce i tipi Schema.org esistenti (Article, FAQPage, Question, Answer) con un piccolo insieme di proprietà di estensione 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à retroattiva è preservata.
Cosa Aggiunge AQA
| Segnale | Cosa comunica ai crawler IA |
|---|---|
dateCreated / dateModified | Aggiornamento esatto di ogni singola risposta |
citation | Fonte autorevole a sostegno di ogni affermazione |
changelog | Perché e quando ogni risposta è stata modificata |
questionVersion | Tracciamento delle modifiche sostanziali delle risposte |
updateFrequency | Impegno dell'editore nella revisione dei contenuti |
monitoringSources | Feed e pubblicazioni monitorati dall'editore |
conformanceLevel | Profondità di implementazione autodichiarata |
aiUsagePolicy | Diritti IA granulari: RAG, addestramento, citazione, uso commerciale |
contentSignature | Hash SHA-256 che attesta l'integrità della risposta |
ragSummary | Riepilogo di 300 caratteri ottimizzato per l'incorporamento vettoriale |
audienceAnswers | Varianti di risposta specifiche per pubblico |
dynamicEndpoint | API in tempo reale per dati volatili |
unansweredQueryEndpoint | Webhook: l'IA reinvia le domande senza risposta |
validThrough | Data di scadenza per risposta |
verificationStatus | Stato: verificato / obsoleto / in revisione |
specVersion | Dichiarazione della versione della specifica AQA |
updateFeedUrl | Puntatore al feed per il rilevamento delle modifiche |
pingbackEndpoints | Notifiche push in caso di aggiornamenti dei contenuti |
Livelli di Conformità
Base
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 con un registro delle modifiche, e il contesto di settore è esplicito tramite classificazione settoriale e fonti di monitoraggio.
Completo
Sforzo significativo
Catena di provenienza completa: chi ha scritto ogni risposta, cosa è cambiato, quando, perché e da dove. Attribuzione per domanda e registri delle modifiche versionati.
AQA Shield
Quando ogni domanda di un documento include sia aiUsagePolicy che contentSignature, il documento si qualifica per AQA Shield. La policy dichiara gli usi IA consentiti (citazione RAG, addestramento, riepilogo, citazione diretta, uso commerciale). La firma fornisce verifica tramite hash SHA-256 contro la manomissione dei contenuti. Shield funziona a qualsiasi livello di conformità come garanzia ortogonale che combina protezione legale e integrità crittografica.
Avvio Rapido
Un'implementazione AQA Base minimale:
{
"@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."
}
}
]
}
}
Convalidate la vostra implementazione:
pip install jsonschema requests
python validators/validate.py your-file.jsonld
Guida alla Migrazione — istruzioni passo passo per aggiungere AQA a pagine FAQ esistenti.
Funzionalità V1.2
Protezione
aiUsagePolicy— dichiarazione granulare dei diritti IAcontentSignature— hash di integrità SHA-256
Arricchimento
ragSummary— riepilogo ottimizzato per vettoriaudienceAnswers— varianti multi-profilopotentialAction— azioni agentichedynamicEndpoint— API in tempo reale
Feedback
unansweredQueryEndpoint— webhook per risposte mancantivalidThrough— scadenza delle risposteverificationStatus— verificato / obsoleto / in revisione
Distribuzione
specVersion— dichiarazione della versione della specificaupdateFeedUrl— feed di modifiche in modalità pullpingbackEndpoints— notifiche push- AQA Hub Protocol — aggregazione centralizzata degli aggiornamenti
Risorse
- Specifica Completa — la specifica tecnica AQA completa
- Guida alla Migrazione — guida in 8 passi dalla FAQ HTML semplice ad AQA
- Raccomandazioni per i Crawler — guida per gli sviluppatori di crawler IA
- Integrazione nell'Ecosistema — LangChain, LlamaIndex, plugin WordPress
- Confronto FAQ vs AQA — confronto affiancato dei segnali
- Validatore Python — convalida blocchi AQA da file o URL (punteggio 0-100)
- Esempi — 7 implementazioni nei livelli Base, Standard e Completo
- Contesto JSON-LD — la definizione del namespace AQA
- JSON Schema — schema di validazione leggibile dalla macchina
Domande Frequenti
Questa FAQ implementa AQA Full + Shield. Visualizza il sorgente della pagina (Ctrl+U) per vedere il blocco JSON-LD.
Cos'è AQA?
AQA (AI Question Answer) è una specifica aperta che arricchisce i dati strutturati Schema.org FAQPage con i metadati necessari ai sistemi di IA per valutare la qualità, l'aggiornamento e la provenienza delle risposte. Utilizza un contesto JSON-LD personalizzato per aggiungere proprietà di estensione come date per domanda, citazioni, registri delle modifiche e policy di utilizzo IA ai tipi Schema.org esistenti. AQA è distribuito con licenza MIT, gratuito per sempre e senza dipendenza da fornitori.
AQA è compatibile con Schema.org?
Sì. AQA utilizza esclusivamente tipi Schema.org esistenti (Article, FAQPage, Question, Answer) e aggiunge proprietà di estensione tramite un contesto JSON-LD. I validatori che non riconoscono il namespace AQA ignorano silenziosamente le proprietà aggiuntive. Il markup Schema.org esistente continua a funzionare invariato. AQA è un sovrainsieme stretto: ogni blocco AQA valido è anche un documento Schema.org valido.
Quali sono i livelli di conformità AQA?
AQA definisce tre livelli di conformità. Il livello Base richiede date per domanda, almeno una citazione per risposta, e autore e lingua a livello di documento. Standard aggiunge frequenza di aggiornamento, registro delle modifiche, versionamento delle domande, classificazione settoriale e citazioni strutturate. Completo richiede fonti di monitoraggio, attribuzione per domanda con credenziali e provenienza completa delle modifiche. Tutti i livelli sono cumulativi: Standard include tutto ciò che è in Base, e Completo include tutto ciò che è in Standard.
Cos'è AQA Shield?
AQA Shield è un meccanismo di protezione ortogonale disponibile a qualsiasi livello di conformità. Un documento si qualifica per AQA Shield quando ogni domanda include sia un aiUsagePolicy (che dichiara gli usi IA consentiti, come citazione RAG, addestramento, riepilogo, citazione diretta e uso commerciale) sia un contentSignature (hash SHA-256 che attesta l'integrità della risposta). Shield combina dichiarazione legale e verifica crittografica.
Come implemento AQA sul mio sito web?
Aggiungete alla vostra pagina FAQ un blocco script JSON-LD con un contesto duale che faccia riferimento sia a Schema.org sia al contesto AQA all'indirizzo https://aqa-spec.org/ns/context.jsonld. Racchiudete la vostra FAQ in un Article contenente una FAQPage, aggiungete le proprietà dateCreated, dateModified e citation per domanda, quindi convalidate con il validatore Python. La guida alla migrazione su GitHub fornisce 8 passi dettagliati dalla FAQ HTML semplice a un'implementazione AQA completa.
Filosofia
AQA è aperto, gratuito per sempre e senza dipendenza da fornitori. Chiunque può implementarlo, convalidarlo ed estenderlo. La specifica è distribuita con licenza MIT ed è guidata dalla comunità.
L'obiettivo è fare per la visibilità IA quello che OpenGraph ha fatto per la condivisione sui social: offrire agli editori un modo semplice e standardizzato per rendere i propri contenuti comprensibili alle macchine, senza compromettere ciò che già funziona.