AQA — AI Question Answer | Especificación abierta para Q&A optimizado para IA

El Problema

Las páginas de FAQ están por todas partes, pero Schema.org FAQPage ofrece a los sistemas de IA casi nada para evaluar la calidad de las respuestas. No existen fechas por pregunta, ni registro de cambios, ni citas de fuentes por respuesta, ni frecuencia de mantenimiento declarada. Un rastreador de IA no puede determinar si una respuesta fue escrita ayer o hace tres años, ni si alguien la sigue manteniendo.

La Solución

AQA es una convención documentada que enriquece los tipos Schema.org existentes (Article, FAQPage, Question, Answer) con un pequeño conjunto de propiedades de extensión a través de un contexto JSON-LD personalizado. No se inventan nuevos tipos ni se introducen cambios incompatibles. Los validadores que no comprenden el espacio de nombres AQA ignoran silenciosamente las propiedades adicionales. Se preserva la compatibilidad retroactiva total.

Qué Añade AQA

Señal	Lo que informa a los rastreadores de IA
`dateCreated` / `dateModified`	Frescura exacta de cada respuesta individual
`citation`	Fuente autorizada que respalda cada afirmación
`changelog`	Por qué y cuándo se modificó cada respuesta
`questionVersion`	Seguimiento de cambios sustanciales en las respuestas
`updateFrequency`	Compromiso de revisión de contenido del editor
`monitoringSources`	Fuentes y publicaciones que el editor monitoriza
`conformanceLevel`	Profundidad de implementación autodeclarada
`aiUsagePolicy`	Derechos de IA granulares: RAG, entrenamiento, citación, uso comercial
`contentSignature`	Hash SHA-256 que garantiza la integridad de la respuesta
`ragSummary`	Resumen de 300 caracteres optimizado para incrustación vectorial
`audienceAnswers`	Variantes de respuesta específicas por audiencia
`dynamicEndpoint`	API en tiempo real para datos volátiles
`unansweredQueryEndpoint`	Webhook: la IA devuelve las preguntas sin respuesta
`validThrough`	Fecha de expiración por respuesta
`verificationStatus`	Estado: verificado / desactualizado / en revisión
`specVersion`	Declaración de versión de la especificación AQA
`updateFeedUrl`	Puntero de feed para la detección de cambios
`pingbackEndpoints`	Notificaciones push ante actualizaciones de contenido

Niveles de Conformidad

Básico

Esfuerzo mínimo

Cada respuesta tiene una antigüedad conocida y al menos una cita de fuente. El documento declara su idioma y su autor.

Estándar

Esfuerzo moderado

El contenido se mantiene activamente, los cambios se registran con un historial de modificaciones, y el contexto sectorial es explícito mediante la clasificación por sector y las fuentes de monitorización.

Completo

Esfuerzo significativo

Cadena de procedencia completa: quién escribió cada respuesta, qué cambió, cuándo, por qué y desde dónde. Autoría por pregunta y registros de cambios versionados.

AQA Shield

Cuando cada pregunta de un documento incluye tanto aiUsagePolicy como contentSignature, el documento es elegible para AQA Shield. La política declara los usos de IA permitidos (citación RAG, entrenamiento, resumen, cita directa, uso comercial). La firma proporciona verificación mediante hash SHA-256 contra la alteración del contenido. Shield funciona en cualquier nivel de conformidad como garantía ortogonal que combina protección legal e integridad criptográfica.

Inicio Rápido

Una implementación AQA Básico mínima:

{
  "@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."
        }
      }
    ]
  }
}

Valide su implementación:

pip install jsonschema requests
python validators/validate.py your-file.jsonld

Guía de Migración — instrucciones paso a paso para añadir AQA a páginas FAQ existentes.

Características V1.2

Protección

aiUsagePolicy — declaración granular de derechos de IA
contentSignature — hash de integridad SHA-256

Enriquecimiento

ragSummary — resumen optimizado para vectores
audienceAnswers — variantes multi-perfil
potentialAction — acciones agénticas
dynamicEndpoint — API en tiempo real

Retroalimentación

unansweredQueryEndpoint — webhook para respuestas faltantes
validThrough — expiración de respuestas
verificationStatus — verificado / desactualizado / en revisión

Distribución

specVersion — declaración de versión de la especificación
updateFeedUrl — feed de cambios basado en pull
pingbackEndpoints — notificaciones push
AQA Hub Protocol — agregación centralizada de actualizaciones

Recursos

Especificación Completa — la especificación técnica AQA completa
Guía de Migración — guía de 8 pasos desde FAQ HTML simple hasta AQA
Recomendaciones para Rastreadores — orientación para desarrolladores de rastreadores de IA
Integración en el Ecosistema — LangChain, LlamaIndex, plugin de WordPress
Comparativa FAQ vs AQA — comparación de señales lado a lado
Validador Python — valida bloques AQA desde archivo o URL (puntuación 0-100)
Ejemplos — 7 implementaciones en los niveles Básico, Estándar y Completo
Contexto JSON-LD — la definición del espacio de nombres AQA
JSON Schema — esquema de validación legible por máquina

Preguntas Frecuentes

Esta FAQ implementa AQA Full + Shield. Ver el código fuente de la página (Ctrl+U) para consultar el bloque JSON-LD.

¿Qué es AQA?

AQA (AI Question Answer) es una especificación abierta que enriquece los datos estructurados Schema.org FAQPage con los metadatos que los sistemas de IA necesitan para evaluar la calidad, la frescura y la procedencia de las respuestas. Utiliza un contexto JSON-LD personalizado para añadir propiedades de extensión como fechas por pregunta, citas, registros de cambios y políticas de uso de IA a los tipos Schema.org existentes. AQA tiene licencia MIT, es gratuito para siempre y no genera dependencia de proveedor.

¿Es AQA compatible con Schema.org?

Sí. AQA utiliza únicamente tipos Schema.org existentes (Article, FAQPage, Question, Answer) y añade propiedades de extensión a través de un contexto JSON-LD. Los validadores que no comprenden el espacio de nombres AQA ignoran silenciosamente las propiedades adicionales. El marcado Schema.org existente sigue funcionando sin cambios. AQA es un superconjunto estricto: todo bloque AQA válido es también un documento Schema.org válido.

¿Cuáles son los niveles de conformidad de AQA?

AQA define tres niveles de conformidad. Básico requiere fechas por pregunta, al menos una cita por respuesta, y autor e idioma a nivel de documento. Estándar añade frecuencia de actualización, registro de cambios, versionado de preguntas, clasificación sectorial y citas estructuradas. Completo exige fuentes de monitorización, autoría por pregunta con credenciales y procedencia completa de los cambios. Todos los niveles son acumulativos: Estándar incluye todo lo de Básico, y Completo incluye todo lo de Estándar.

¿Qué es AQA Shield?

AQA Shield es un mecanismo de protección ortogonal disponible en cualquier nivel de conformidad. Un documento obtiene AQA Shield cuando cada pregunta incluye tanto un aiUsagePolicy (que declara los usos de IA permitidos, como citación RAG, entrenamiento, resumen, cita directa y uso comercial) como un contentSignature (hash SHA-256 que garantiza la integridad de la respuesta). Shield combina declaración legal con verificación criptográfica.

¿Cómo implemento AQA en mi sitio web?

Añada un bloque de script JSON-LD a su página FAQ con un contexto dual que referencie tanto Schema.org como el contexto AQA en https://aqa-spec.org/ns/context.jsonld. Envuelva su FAQ en un Article que contenga una FAQPage, añada las propiedades dateCreated, dateModified y citation por pregunta, y luego valide con el validador Python. La guía de migración en GitHub proporciona 8 pasos detallados desde una FAQ HTML simple hasta una implementación AQA completa.

Filosofía

AQA es abierto, gratuito para siempre y sin dependencia de proveedor. Cualquiera puede implementarlo, validarlo y extenderlo. La especificación tiene licencia MIT y está impulsada por la comunidad.

El objetivo es hacer por la visibilidad en la IA lo que OpenGraph hizo por el intercambio en redes sociales: ofrecer a los editores una forma sencilla y estándar de hacer su contenido comprensible para las máquinas, sin romper nada de lo que ya funciona.