Problém
Stránky s FAQ jsou všude, ale Schema.org FAQPage poskytuje AI systémům téměř žádné informace pro hodnocení kvality odpovědí. Chybí data pro jednotlivé otázky, záznamy o změnách, citace zdrojů pro jednotlivé odpovědi a deklarovaná frekvence údržby. AI prohledávač nedokáže zjistit, zda byla odpověď napsána včera nebo před třemi lety, ani zda ji někdo stále spravuje.
Řešení
AQA je zdokumentovaná konvence, která obohacuje stávající typy Schema.org (Article, FAQPage, Question, Answer) o malou sadu rozšiřujících vlastností prostřednictvím vlastního JSON-LD kontextu. Nevymýšlejí se žádné nové typy ani se nezavádějí žádné zpětně nekompatibilní změny. Validátory, které AQA jmenný prostor neznají, navíc tiše ignorují. Plná zpětná kompatibilita je zachována.
Co AQA přidává
| Signál | Co sděluje AI prohledávačům |
|---|---|
dateCreated / dateModified | Přesná aktuálnost každé jednotlivé odpovědi |
citation | Autoritativní zdroj podporující každé tvrzení |
changelog | Proč a kdy byla každá odpověď upravena |
questionVersion | Sledování věcných změn v odpovědích |
updateFrequency | Závazek vydavatele k průběžné revizi obsahu |
monitoringSources | Které zdroje a publikace vydavatel sleduje |
conformanceLevel | Vlastní deklarace hloubky implementace |
aiUsagePolicy | Podrobná práva pro AI: RAG, trénink, citace, komerční využití |
contentSignature | SHA-256 hash prokazující integritu odpovědi |
ragSummary | Tokenově optimalizované shrnutí o 300 znacích pro vektorové vkládání |
audienceAnswers | Varianty odpovědí pro konkrétní cílové skupiny |
dynamicEndpoint | API v reálném čase pro proměnlivá data |
unansweredQueryEndpoint | Webhook: AI odesílá zpět chybějící otázky |
validThrough | Datum vypršení platnosti pro každou odpověď |
verificationStatus | Stav: ověřeno / zastaralé / v přezkumu |
specVersion | Deklarace verze specifikace AQA |
updateFeedUrl | Ukazatel na zdroj pro detekci změn |
pingbackEndpoints | Push notifikace při aktualizacích obsahu |
Úrovně shody
Basic
Minimální úsilí
Každá odpověď má známé stáří a alespoň jeden odkaz na zdroj. Dokument deklaruje svůj jazyk a autora.
Standard
Střední úsilí
Obsah je aktivně udržován, změny jsou sledovány v záznamu o změnách a oborový kontext je explicitní prostřednictvím klasifikace sektoru a sledovaných zdrojů.
Full
Značné úsilí
Úplný řetězec původu: kdo napsal každou odpověď, co bylo změněno, kdy, proč a odkud. Autorství na úrovni otázek a verzované záznamy o změnách.
AQA Shield
Pokud každá otázka v dokumentu obsahuje jak aiUsagePolicy, tak contentSignature, dokument se kvalifikuje pro AQA Shield. Politika deklaruje povolená využití AI (citace v RAG, trénink, sumarizace, citování, komerční použití). Podpis zajišťuje ověření pomocí SHA-256 hashe proti pozměnění obsahu. Shield funguje na libovolné úrovni shody jako ortogonální záruka kombinující právní ochranu a kryptografickou integritu.
Rychlý start
Minimální implementace 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."
}
}
]
}
}
Ověřte svou implementaci:
pip install jsonschema requests
python validators/validate.py your-file.jsonld
Průvodce migrací — podrobné pokyny pro přidání AQA na stávající stránky FAQ.
Funkce verze V1.2
Ochrana
aiUsagePolicy— podrobná deklarace práv pro AIcontentSignature— SHA-256 hash pro integritu
Obohacení
ragSummary— vektorově optimalizované shrnutíaudienceAnswers— varianty pro více personpotentialAction— agentní akcedynamicEndpoint— API v reálném čase
Zpětná vazba
unansweredQueryEndpoint— webhook pro chybějící odpovědivalidThrough— vypršení platnosti odpovědiverificationStatus— ověřeno / zastaralé / v přezkumu
Distribuce
specVersion— deklarace verze specifikaceupdateFeedUrl— pull-based zdroj změnpingbackEndpoints— push notifikace- AQA Hub Protocol — centralizovaná agregace aktualizací
Zdroje
- Úplná specifikace — kompletní technická specifikace AQA
- Průvodce migrací — 8krokový průvodce od prosté HTML FAQ po AQA
- Doporučení pro prohledávače — pokyny pro vývojáře AI crawlerů
- Integrace do ekosystému — LangChain, LlamaIndex, WordPress plugin
- Srovnání FAQ vs AQA — porovnání signálů vedle sebe
- Python validátor — validace AQA bloků ze souboru nebo URL (skóre 0–100)
- Příklady — 7 implementací pro Basic, Standard a Full
- JSON-LD kontext — definice jmenného prostoru AQA
- JSON Schema — strojově čitelné validační schéma
Filozofie
AQA je otevřené, navždy zdarma a bez závislosti na konkrétním dodavateli. Kdokoli jej může implementovat, validovat a rozšiřovat. Specifikace je licencována pod MIT a je řízena komunitou.
Cílem je udělat pro viditelnost v AI to, co OpenGraph udělal pro sdílení na sociálních sítích: poskytnout vydavatelům jednoduchý, standardizovaný způsob, jak učinit svůj obsah srozumitelným pro stroje, aniž by narušili cokoli, co již funguje.