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 / dateModifiedAggiornamento esatto di ogni singola risposta
citationFonte autorevole a supporto di ogni affermazione
changelogPerché e quando è stata modificata ogni risposta
questionVersionTracciamento delle variazioni sostanziali di una risposta
updateFrequencyImpegno dell'editore nella revisione dei contenuti
monitoringSourcesFeed e pubblicazioni che l'editore monitora
conformanceLevelLivello di implementazione autodichiarato
aiUsagePolicyDiritti IA granulari: RAG, addestramento, citazione, uso commerciale
contentSignatureHash SHA-256 a prova dell'integrità della risposta
ragSummaryRiepilogo di 300 caratteri ottimizzato in token per l'incorporamento vettoriale
audienceAnswersVarianti di risposta per tipo di pubblico
dynamicEndpointAPI in tempo reale per dati volatili
unansweredQueryEndpointWebhook: l'IA reinvia le domande senza risposta
validThroughData di scadenza per singola risposta
verificationStatusStato: verificato / obsoleto / in revisione
specVersionDichiarazione della versione delle specifiche AQA
updateFeedUrlPuntatore al feed di rilevamento delle modifiche
pingbackEndpointsNotifiche 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.

Badge AQA Basic

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.

Badge AQA Standard

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.

Badge AQA Full

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.

Badge AQA Shield

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 IA
  • contentSignature — hash di integrità SHA-256

Arricchimento

  • ragSummary — riepilogo ottimizzato per i vettori
  • audienceAnswers — varianti multi-persona
  • potentialAction — azioni agentiche
  • dynamicEndpoint — API in tempo reale

Feedback

  • unansweredQueryEndpoint — webhook per risposte mancanti
  • validThrough — scadenza della risposta
  • verificationStatus — verificato / obsoleto / in revisione

Distribuzione

  • specVersion — dichiarazione della versione delle specifiche
  • updateFeedUrl — feed di aggiornamenti in modalità pull
  • pingbackEndpoints — notifiche push
  • AQA Hub Protocol — aggregazione centralizzata degli aggiornamenti

Risorse

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.