AQA — AI Question Answer | Otwarta Specyfikacja dla Q&A Zoptymalizowanego pod AI

Problem

Strony FAQ są wszędzie, ale FAQPage ze Schema.org dostarcza systemom AI prawie żadnych informacji do oceny jakości odpowiedzi. Brakuje dat per pytanie, dziennika zmian, cytowań źródeł per odpowiedź oraz zadeklarowanej częstotliwości konserwacji. Robot AI nie jest w stanie ocenić, czy odpowiedź została napisana wczoraj czy trzy lata temu, ani czy ktokolwiek jeszcze ją aktualizuje.

Rozwiązanie

AQA to udokumentowana konwencja wzbogacająca istniejące typy Schema.org (Article, FAQPage, Question, Answer) o niewielki zestaw właściwości rozszerzeń za pośrednictwem niestandardowego kontekstu JSON-LD. Nie tworzy się nowych typów, nie wprowadza się żadnych zmian niekompatybilnych wstecz. Walidatory nierozumiejące przestrzeni nazw AQA po cichu ignorują dodatkowe właściwości. Pełna zgodność wsteczna jest zachowana.

Co Dodaje AQA

Sygnał	Co mówi robotom AI
`dateCreated` / `dateModified`	Dokładna aktualność każdej indywidualnej 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 odpowiedziach
`updateFrequency`	Zobowiązanie wydawcy do przeglądania treści
`monitoringSources`	Kanały i publikacje obserwowane przez wydawcę
`conformanceLevel`	Samodzielnie zadeklarowana głębokość implementacji
`aiUsagePolicy`	Szczegółowe prawa AI: RAG, trenowanie, cytowanie, użytek komercyjny
`contentSignature`	Skrót SHA-256 potwierdzający integralność odpowiedzi
`ragSummary`	Zoptymalizowane pod tokeny podsumowanie 300 znaków do osadzania wektorowego
`audienceAnswers`	Warianty odpowiedzi dla konkretnych grup odbiorców
`dynamicEndpoint`	API czasu rzeczywistego dla niestabilnych danych
`unansweredQueryEndpoint`	Webhook: AI odsyła brakujące pytania
`validThrough`	Data wygaśnięcia per odpowiedź
`verificationStatus`	Status: zweryfikowany / nieaktualny / w trakcie przeglądu
`specVersion`	Deklaracja wersji specyfikacji AQA
`updateFeedUrl`	Wskaźnik na kanał wykrywania zmian
`pingbackEndpoints`	Powiadomienia push o aktualizacjach treści

Poziomy Zgodności

Podstawowy

Minimalny wysiłek

Każda odpowiedź ma znany wiek i przynajmniej jedno cytowanie źródła. Dokument deklaruje swój język i autora.

Standardowy

Umiarkowany wysiłek

Treść jest aktywnie utrzymywana, zmiany są śledzone za pomocą dziennika zmian, a kontekst branżowy jest jawny poprzez klasyfikację sektorową i źródła monitorowania.

Pełny

Znaczny wysiłek

Pełny łańcuch proweniencji: kto napisał każdą odpowiedź, co się zmieniło, kiedy, dlaczego i skąd. Autorstwo per pytanie oraz wersjonowane dzienniki 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 RAG, trenowanie, streszczanie, cytowanie, użytek komercyjny). Podpis zapewnia weryfikację skrótu SHA-256 przeciwko modyfikacji 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 — instrukcje krok po kroku dotyczące dodawania AQA do istniejących stron FAQ.

Funkcje V1.2

Ochrona

aiUsagePolicy — szczegółowa deklaracja praw AI
contentSignature — skrót integralności SHA-256

Wzbogacenie

ragSummary — podsumowanie zoptymalizowane pod wektory
audienceAnswers — warianty dla wielu person
potentialAction — działania agentyczne
dynamicEndpoint — API czasu rzeczywistego

Informacje Zwrotne

unansweredQueryEndpoint — webhook dla brakującej odpowiedzi
validThrough — wygaśnięcie odpowiedzi
verificationStatus — zweryfikowany / nieaktualny / w trakcie przeglądu

Dystrybucja

specVersion — deklaracja wersji specyfikacji
updateFeedUrl — kanał zmian oparty na pobieraniu
pingbackEndpoints — powiadomienia push
AQA Hub Protocol — scentralizowana agregacja aktualizacji

Zasoby

Pełna Specyfikacja — kompletna techniczna specyfikacja AQA
Przewodnik Migracji — 8-krokowy przewodnik od zwykłego HTML FAQ do AQA
Zalecenia dla Robotów — wskazówki dla deweloperów robotów AI
Integracja z Ekosystemem — LangChain, LlamaIndex, wtyczka WordPress
Porównanie FAQ vs AQA — porównanie sygnałów obok siebie
Walidator Python — waliduj bloki AQA z pliku lub URL (punktacja 0-100)
Przykłady — 7 implementacji dla poziomów Basic, Standard i Full
Kontekst JSON-LD — definicja przestrzeni nazw AQA
JSON Schema — maszynowo czytelny schemat walidacji

Często Zadawane Pytania

To FAQ implementuje AQA Full + Shield. Zobacz źródło strony (Ctrl+U), aby zobaczyć blok JSON-LD.

Czym jest AQA?

AQA (AI Question Answer) to otwarta specyfikacja wzbogacająca strukturalne dane FAQPage ze Schema.org o metadane potrzebne systemom AI do oceny jakości, aktualności i proweniencji odpowiedzi. Używa niestandardowego kontekstu JSON-LD do dodawania właściwości rozszerzeń, takich jak daty per pytanie, cytowania, dzienniki zmian i polityki użytkowania AI, do istniejących typów Schema.org. AQA posiada licencję MIT, jest bezpłatne na zawsze i nie powoduje uzależnienia od dostawcy.

Czy AQA jest zgodne ze Schema.org?

Tak. AQA używa wyłącznie istniejących typów Schema.org (Article, FAQPage, Question, Answer) i dodaje właściwości rozszerzeń poprzez kontekst JSON-LD. Walidatory nierozumiejące przestrzeni nazw AQA po cichu ignorują dodatkowe właściwości. Istniejące znaczniki Schema.org nadal działają bez zmian. AQA jest ścisłym nadzbiorem — każdy prawidłowy blok AQA jest również prawidłowym dokumentem Schema.org.

Jakie są poziomy zgodności AQA?

AQA definiuje trzy poziomy zgodności. Podstawowy wymaga dat per pytanie, przynajmniej jednego cytowania per odpowiedź oraz autora i języka na poziomie dokumentu. Standardowy dodaje częstotliwość aktualizacji, dziennik zmian, wersjonowanie pytań, klasyfikację sektorową i ustrukturyzowane cytowania. Pełny wymaga źródeł monitorowania, autorstwa per pytanie z referencjami oraz pełnej proweniencji zmian. Wszystkie poziomy są kumulatywne — Standardowy zawiera wszystko z Podstawowego, a Pełny zawiera wszystko ze Standardowego.

Czym jest AQA Shield?

AQA Shield to ortogonalny mechanizm ochrony dostępny na każdym poziomie zgodności. Dokument kwalifikuje się do AQA Shield, gdy każde pytanie zawiera zarówno aiUsagePolicy (deklarującą dozwolone zastosowania AI, takie jak cytowanie RAG, trenowanie, streszczanie, cytowanie i użytek komercyjny), jak i contentSignature (skrót SHA-256 potwierdzający integralność odpowiedzi). Shield łączy deklarację prawną z weryfikacją kryptograficzną.

Jak zaimplementować AQA na mojej stronie?

Dodaj blok skryptu JSON-LD do swojej strony FAQ z podwójnym kontekstem odwołującym się zarówno do Schema.org, jak i do kontekstu AQA pod adresem https://aqa-spec.org/ns/context.jsonld. Opakuj swoje FAQ w Article zawierający FAQPage, dodaj właściwości dateCreated, dateModified i citation per pytanie, a następnie zwaliduj walidatorem Python. Przewodnik migracji na GitHub zawiera 8 szczegółowych kroków, od zwykłego HTML FAQ do pełnej implementacji AQA.

Filozofia

AQA jest otwarte, bezpłatne na zawsze i nie powoduje uzależnienia od dostawcy. Każdy może je wdrożyć, zwalidować i rozszerzyć. Specyfikacja posiada licencję MIT i jest rozwijana przez społeczność.

Celem jest zrobienie dla widoczności AI tego, co OpenGraph zrobił dla udostępniania w mediach społecznościowych: danie wydawcom prostego, standardowego sposobu na uczynienie swoich treści zrozumiałymi przez maszyny bez psucia czegokolwiek, co już działa.