Problem
Strony z FAQ są wszędzie, lecz Schema.org FAQPage dostarcza systemom AI niemal żadnych informacji pozwalających ocenić jakość odpowiedzi. Brakuje dat przypisanych do poszczególnych pytań, dziennika zmian, cytowań źródeł przy odpowiedziach oraz zadeklarowanej częstotliwości aktualizacji. Robot indeksujący AI nie jest w stanie ustalić, czy dana odpowiedź powstała wczoraj, czy trzy lata temu, ani czy ktokolwiek wciąż ją utrzymuje.
Rozwiązanie
AQA to udokumentowana konwencja wzbogacająca istniejące typy Schema.org (Article, FAQPage, Question, Answer) o niewielki zestaw właściwości rozszerzających za pośrednictwem niestandardowego kontekstu JSON-LD. Nie wprowadza się nowych typów ani żadnych zmian niekompatybilnych wstecznie. Walidatory nierozpoznające przestrzeni nazw AQA po prostu ignorują dodatkowe właściwości. Pełna wsteczna kompatybilność zostaje zachowana.
Co Dodaje AQA
| Sygnał | Co przekazuje robotom indeksującym AI |
|---|---|
dateCreated / dateModified | Dokładna aktualność każdej pojedynczej odpowiedzi |
citation | Autorytatywne źródło potwierdzające każde twierdzenie |
changelog | Dlaczego i kiedy każda odpowiedź została zmodyfikowana |
questionVersion | Śledzenie merytorycznych zmian w odpowiedzi |
updateFrequency | Zobowiązanie wydawcy do regularnego przeglądu treści |
monitoringSources | Kanały i publikacje obserwowane przez wydawcę |
conformanceLevel | Samodzielnie zadeklarowana głębokość implementacji |
aiUsagePolicy | Szczegółowe uprawnienia dla AI: RAG, trening, cytowanie, użytek komercyjny |
contentSignature | Skrót SHA-256 potwierdzający integralność odpowiedzi |
ragSummary | 300-znakowe streszczenie zoptymalizowane pod osadzanie wektorowe |
audienceAnswers | Warianty odpowiedzi dostosowane do grupy odbiorców |
dynamicEndpoint | API czasu rzeczywistego dla danych zmiennych |
unansweredQueryEndpoint | Webhook: AI odsyła brakujące pytania z powrotem |
validThrough | Data wygaśnięcia przypisana do każdej odpowiedzi |
verificationStatus | Status: zweryfikowano / nieaktualne / w trakcie przeglądu |
specVersion | Deklaracja wersji specyfikacji AQA |
updateFeedUrl | Wskaźnik do kanału wykrywania zmian |
pingbackEndpoints | Powiadomienia push o aktualizacjach treści |
Poziomy Zgodności
Basic
Minimalny nakład pracy
Każda odpowiedź ma określoną datę i co najmniej jedno cytowanie źródła. Dokument deklaruje język i autora.
Standard
Umiarkowany nakład pracy
Treści są aktywnie utrzymywane, zmiany są rejestrowane w dzienniku, a kontekst branżowy jest jawnie określony przez klasyfikację sektorową i źródła monitoringu.
Full
Znaczny nakład pracy
Pełny łańcuch proweniencji: kto napisał każdą odpowiedź, co zostało zmienione, kiedy, dlaczego i na jakiej podstawie. Autorstwo per pytanie i wersjonowany dziennik zmian.
AQA Shield
Gdy każde pytanie w dokumencie zawiera zarówno aiUsagePolicy, jak i contentSignature, dokument kwalifikuje się do AQA Shield. Polityka deklaruje dozwolone zastosowania AI (cytowanie w RAG, trening, streszczanie, cytaty bezpośrednie, użytek komercyjny). Podpis zapewnia weryfikację skrótem SHA-256 chroniącą przed modyfikacją treści. Shield działa na każdym poziomie zgodności jako ortogonalna gwarancja łącząca ochronę prawną i integralność kryptograficzną.
Szybki Start
Minimalna implementacja 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."
}
}
]
}
}
Zwaliduj swoją implementację:
pip install jsonschema requests
python validators/validate.py your-file.jsonld
Przewodnik migracji — instrukcja krok po kroku dodawania AQA do istniejących stron FAQ.
Funkcje V1.2
Ochrona
aiUsagePolicy— szczegółowa deklaracja uprawnień AIcontentSignature— skrót integralności SHA-256
Wzbogacanie
ragSummary— streszczenie zoptymalizowane wektorowoaudienceAnswers— warianty per personapotentialAction— akcje agentycznedynamicEndpoint— API czasu rzeczywistego
Informacja zwrotna
unansweredQueryEndpoint— webhook dla brakujących odpowiedzivalidThrough— wygaśnięcie odpowiedziverificationStatus— zweryfikowano / nieaktualne / w trakcie przeglądu
Dystrybucja
specVersion— deklaracja wersji specyfikacjiupdateFeedUrl— kanał zmian oparty na odpytywaniupingbackEndpoints— powiadomienia push- Protokół AQA Hub — scentralizowana agregacja aktualizacji
Zasoby
- Pełna Specyfikacja — kompletna techniczna specyfikacja AQA
- Przewodnik migracji — 8-krokowy przewodnik od czystego HTML FAQ do AQA
- Zalecenia dla robotów — wytyczne dla deweloperów robotów indeksujących AI
- Integracja z ekosystemem — LangChain, LlamaIndex, wtyczka WordPress
- Porównanie FAQ vs AQA — zestawienie sygnałów obok siebie
- Walidator Python — walidacja bloków AQA z pliku lub URL (punktacja 0–100)
- Przykłady — 7 implementacji na poziomach Basic, Standard i Full
- Kontekst JSON-LD — definicja przestrzeni nazw AQA
- JSON Schema — schemat walidacji czytelny maszynowo
Filozofia
AQA jest otwarte, bezpłatne na zawsze i wolne od uzależnienia od dostawcy. Każdy może je wdrożyć, walidować i rozszerzać. Specyfikacja jest objęta licencją MIT i rozwijana przez społeczność.
Celem jest uczynienie dla widoczności w AI tego, co OpenGraph zrobił dla udostępniania w mediach społecznościowych: dać wydawcom prosty, standardowy sposób na uczynienie swoich treści zrozumiałymi maszynowo bez naruszania czegokolwiek, co już działa.