El problema
Las páginas de FAQ están en todas partes, pero Schema.org FAQPage proporciona a los sistemas de IA muy poca información para evaluar la calidad de las respuestas. No hay fechas por pregunta, no hay historial de cambios, no hay citas de fuentes por respuesta y no se declara ninguna frecuencia de mantenimiento. Un rastreador de IA no puede determinar si una respuesta fue redactada 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 conjunto reducido de propiedades de extensión mediante un contexto JSON-LD personalizado. No se crean 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 hacia atrás de forma completa.
Lo que AQA añade
| Señal | Qué comunica a los rastreadores de IA |
|---|---|
dateCreated / dateModified | Actualidad exacta de cada respuesta individual |
citation | Fuente de autoridad que respalda cada afirmación |
changelog | Por qué y cuándo se modificó cada respuesta |
questionVersion | Seguimiento de cambios en el contenido de una respuesta |
updateFrequency | Compromiso del editor con la revisión del contenido |
monitoringSources | Fuentes y publicaciones que el editor monitoriza |
conformanceLevel | Nivel de implementación autodeclarado |
aiUsagePolicy | Derechos de IA granulares: RAG, entrenamiento, cita, uso comercial |
contentSignature | Hash SHA-256 que garantiza la integridad de la respuesta |
ragSummary | Resumen de 300 caracteres optimizado en tokens para incrustación vectorial |
audienceAnswers | Variantes de respuestas por tipo de audiencia |
dynamicEndpoint | API en tiempo real para datos volátiles |
unansweredQueryEndpoint | Webhook: la IA reenvía las preguntas sin respuesta |
validThrough | Fecha de expiración por respuesta |
verificationStatus | Estado: verificado / desactualizado / en revisión |
specVersion | Declaración de la versión de la especificación AQA |
updateFeedUrl | Puntero al feed de detección de cambios |
pingbackEndpoints | Notificaciones push ante actualizaciones de contenido |
Niveles de conformidad
Basic
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.
Standard
Esfuerzo moderado
El contenido se mantiene activamente, los cambios se registran en un historial, y el contexto sectorial es explícito mediante la clasificación del sector y las fuentes de vigilancia.
Full
Esfuerzo considerable
Cadena de procedencia completa: quién redactó cada respuesta, qué cambió, cuándo, por qué y desde qué fuente. Autoría por pregunta e historiales de versiones.
AQA Shield
Cuando cada pregunta de un documento incluye tanto aiUsagePolicy como contentSignature, el documento obtiene la calificación AQA Shield. La política declara los usos de IA permitidos (cita RAG, entrenamiento, resumen, cita directa, uso comercial). La firma proporciona verificación mediante hash SHA-256 frente a alteraciones 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 mínima de 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."
}
}
]
}
}
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.
Funcionalidades de la V1.2
Protección
aiUsagePolicy— declaración granular de derechos de IAcontentSignature— hash de integridad SHA-256
Enriquecimiento
ragSummary— resumen optimizado para vectoresaudienceAnswers— variantes multi-perfilpotentialAction— acciones agénticasdynamicEndpoint— API en tiempo real
Retroalimentación
unansweredQueryEndpoint— webhook de respuesta ausentevalidThrough— expiración de la respuestaverificationStatus— verificado / desactualizado / en revisión
Distribución
specVersion— declaración de versión de la especificaciónupdateFeedUrl— feed de cambios basado en pullpingbackEndpoints— notificaciones push- AQA Hub Protocol — agregación centralizada de actualizaciones
Recursos
- Especificación completa — la especificación técnica AQA al completo
- Guía de migración — guía de 8 pasos desde HTML FAQ básico hasta AQA
- Recomendaciones para rastreadores — orientaciones para desarrolladores de rastreadores de IA
- Integración en el ecosistema — LangChain, LlamaIndex, plugin para WordPress
- Comparativa FAQ vs AQA — comparación de señales en paralelo
- Validador Python — valide bloques AQA desde archivo o URL (puntuación de 0 a 100)
- Ejemplos — 7 implementaciones para los niveles Basic, Standard y Full
- Contexto JSON-LD — la definición del espacio de nombres AQA
- JSON Schema — esquema de validación legible por máquinas
Filosofía
AQA es abierto, gratuito para siempre y sin dependencia de ningún proveedor. Cualquiera puede implementarlo, validarlo y ampliarlo. La especificación tiene licencia MIT y es impulsada por la comunidad.
El objetivo es hacer por la visibilidad en IA lo que OpenGraph hizo por el intercambio en redes sociales: ofrecer a los editores un método sencillo y estándar para hacer su contenido comprensible por las máquinas sin romper nada de lo que ya funciona.