Ir al contenido
Base de conocimiento

Guía de inicio rápido

Esta guía recorre el flujo de trabajo completo de Askalot, desde el diseño del cuestionario hasta el análisis estadístico.

Tiempo necesario: unos 15 minutos

Vaya a armiger.dev.askalot.io para crear cuestionarios con ayuda de la IA y validación SMT en tiempo real.

Armiger muestra la lista de los proyectos que puede abrir. Elija uno —si no ha creado otros, ahí está su proyecto predeterminado— y el editor lo abre en su navegador y muestra los cuestionarios, los documentos y el artículo de investigación de ese proyecto y nada más. Para trabajar más adelante en otro proyecto, vuelva a Armiger y elíjalo en la misma lista. El editor necesita un navegador de escritorio: Chrome o Edge 125, Firefox 147, Safari 26 o versiones posteriores. Consulte Integración con Armiger.

Armiger y el editor se muestran en su idioma: el de su perfil o, en su defecto, el de su organización o, en último término, el de su navegador (inglés, español, francés, alemán o húngaro). En húngaro, QML Explorer está íntegramente en húngaro (sus comandos, avisos y paneles: el diagrama, los paneles de generación con IA y de proyecto, la vista previa del ítem, la vista en PDF y la pestaña de traducciones), mientras que el marco del editor que lo rodea (los menús, los comandos integrados de la paleta de comandos, el explorador de archivos) permanece en inglés. Un cambio de idioma se aplica la próxima vez que abra el editor.

Para empezar un cuestionario sin el asistente de IA, elija Nuevo archivo en la carpeta questionnaires del explorador del editor y escriba un nombre.

La forma más rápida de empezar es un cuestionario ya preparado de la biblioteca de plantillas: evaluaciones de cursos, opiniones de clientes, NPS, inscripciones a eventos, encuestas rápidas de clima laboral, admisión de pacientes y varios cientos más, en 13 categorías.

Puede explorar toda la biblioteca antes de registrarse: el catálogo público de plantillas muestra cada plantilla con su diagrama de flujo y sus preguntas.

Las plantillas se muestran, y se copian, en su idioma cuando la biblioteca lo ofrece; si no, en inglés, con una nota que lo indica. La copia incluye además los demás idiomas de la biblioteca como traducciones.

  • En la página de inicio de Roundtable, elija Empezar a partir de una plantilla (el paso del cuestionario de la guía del flujo de investigación también lo ofrece). Busque por nombre o descripción, o explore una categoría. Al abrir una plantilla se muestra una vista previa de solo lectura: el diagrama de flujo del cuestionario, el mismo que dibuja el editor, con cada sección y cada pregunta y los recorridos entre ellas; todavía no se crea nada. Usar esta plantilla añade una copia al proyecto que elija (su proyecto predeterminado aparece preseleccionado; la lista contiene los proyectos de los que es propietario) y después ofrece Editar, que la abre en el editor, o Realizar una campaña, que abre el formulario de nueva campaña con ese proyecto y el nuevo cuestionario ya elegidos.
  • En el editor, haga clic con el botón derecho en la carpeta questionnaires y elija Nuevo cuestionario a partir de una plantilla…, o ejecute ese comando desde la paleta de comandos. Se abre la misma biblioteca de plantillas en una nueva pestaña del navegador, ya asociada al proyecto que está editando: abra la vista previa de una plantilla y elija Usar esta plantilla; la copia se añade a ese proyecto y aparece en la carpeta questionnaires del editor.
  • Mediante MCP, list_questionnaire_templates enumera la biblioteca y create_questionnaire acepta un slug template en lugar de content; ambas aceptan un language. Consulte Herramientas de cuestionarios y QML.

A partir de ese momento, la copia es su propio cuestionario: puede cambiar lo que quiera, y las versiones posteriores de la biblioteca no la modifican. Unos segundos después de crearse, se comprueba en segundo plano su solidez lógica, como cualquier versión guardada.

Con el asistente de IA:

Describa los requisitos de su encuesta:

«Cree una encuesta de satisfacción del cliente. Pregunte por la satisfacción general y, si es baja, pregunte de forma condicional por los problemas concretos».

La IA genera el código QML mientras el solucionador SMT valida la coherencia lógica en tiempo real.

Ejemplo de QML:

qmlVersion: "2.0"
questionnaire:
title: "Customer Satisfaction Survey"
codeInit: |
satisfaction_level = 0
needs_followup = 0
blocks:
- id: b_main
title: "Your Experience"
items:
- id: q_overall
kind: Question
title: "How satisfied are you with our service?"
codeBlock: |
satisfaction_level = q_overall.outcome
if q_overall.outcome <= 6:
needs_followup = 1
input:
control: Slider
min: 0
max: 10
labels:
0: "Very Dissatisfied"
5: "Neutral"
10: "Very Satisfied"
- id: q_reason
kind: Question
title: "What is the primary reason for your low rating?"
precondition:
- predicate: needs_followup == 1
input:
control: Radio
labels:
1: "Product quality"
2: "Delivery time"
3: "Customer service"
4: "Pricing"
- id: q_recommend
kind: Question
title: "Would you recommend us to others?"
input:
control: Switch
on: "Yes"
off: "No"

Armiger valida automáticamente:

  • ✓ Alcanzabilidad: todas las preguntas pueden alcanzarse
  • ✓ Coherencia: las reglas de validación pueden satisfacerse
  • ✓ Aciclicidad: no hay dependencias circulares
  • ✓ Satisfacibilidad global: existen recorridos válidos hasta completar la encuesta

Resultado de la validación:

✓ All items reachable
✓ No circular dependencies detected
✓ Postconditions satisfiable
✓ Global formula: SAT
Flow paths: 2
Path 1: q_overall → q_recommend (satisfaction > 6)
Path 2: q_overall → q_reason → q_recommend (satisfaction ≤ 6)

Vaya a targetor.dev.askalot.io para configurar la segmentación demográfica y lanzar su campaña.

  1. Haga clic en «Nueva campaña»
  2. Configure los ajustes:
    • Nombre: «Satisfacción del cliente T4»
    • Respuestas objetivo: 500
    • Duración: 14 días

Cargue un CSV o conéctese a una base de datos de usuarios:

user_id,email,age,gender,customer_segment
1001,[email protected],34,M,premium
1002,[email protected],28,F,standard

Distribución demográfica objetivo:

Distribución por edad:

  • 18-24: 15 % | 25-34: 30 % | 35-44: 25 % | 45-54: 20 % | 55+: 10 %

Segmento de cliente:

  • Premium: 30 % | Estándar: 70 %

Targetor calcula automáticamente los tamaños de muestra y supervisa en tiempo real la finalización por segmento.

  1. Asocie el cuestionario Customer Satisfaction: así se verifica formalmente y la campaña queda fijada a esa versión exacta
  2. Revise la configuración
  3. Haga clic en «Lanzar campaña»

Targetor genera enlaces de encuesta únicos e inicia la distribución.

Los encuestados acceden a sirway.dev.askalot.io mediante enlaces únicos.

SirWay evalúa las preguntas dinámicamente según el estado actual:

  1. Estado inicial: carga el cuestionario e inicializa las variables
  2. Flujo dinámico: presenta las preguntas cuyas precondiciones se cumplen
  3. Recogida de la respuesta: ejecuta el codeBlock y actualiza el estado
  4. Reevaluación: comprueba las precondiciones de las preguntas restantes
  5. Siguiente pregunta: muestra las preguntas que acaban de pasar a ser elegibles
Respondent: Slides satisfaction to 4/10
→ codeBlock executes: needs_followup = 1
→ Precondition evaluated: needs_followup == 1 ✓
→ Question appears: "What is the primary reason?"
→ Selects: "Delivery time"
→ Final question: "Would you recommend us?"
→ Survey complete

Un cuestionario solo puede salir a campo después de superar la verificación, que rechaza:

  • ❌ Preguntas con precondiciones insatisfacibles (ningún encuestado podría llegar a ellas)
  • ❌ Comprobaciones de respuesta que ninguna respuesta puede cumplir
  • ❌ Condiciones que hacen referencia a una respuesta que ninguna pregunta produce
  • ❌ Dependencias circulares

La comprobación se hace sobre el modelo formal del cuestionario: cubre todos los recorridos de respuesta que contiene el modelo, no una muestra de ejecuciones de prueba.

Vaya a balansor.dev.askalot.io para la corrección estadística y la exportación de datos.

La página de inicio de Balansor es un tablero de tarjetas de paquete. Un paquete reúne un proyecto, un cuestionario y las campañas que quiere analizar en un único proceso Bronce → Plata → Oro; todos los pasos de los conjuntos de datos se circunscriben a ese paquete.

  1. Cree un paquete para «Satisfacción del cliente T4» (proyecto + cuestionario + sus campañas)
  2. Extraiga el conjunto de datos Bronce: respuestas en bruto con los datos demográficos de los encuestados, todavía sin ajustes
  3. Balansor muestra la distribución demográfica real frente a la objetivo
Segmento % objetivo % real Desviación
Edad 18-24 15 % 12 % -3 %
Edad 25-34 30 % 33 % +3 %
Premium 30 % 35 % +5 %
Estándar 70 % 65 % -5 %

Al derivar el conjunto de datos Plata, primero se codifican en categorías las respuestas abiertas y después se calculan las ponderaciones de posestratificación sobre esa base de casos codificada:

\[w_i = \frac{N_{\text{target},g}}{N_{\text{sample},g}}\]

Ponderaciones de ejemplo:

  • Edad 18-24: 1,25 (infrarrepresentada)
  • Edad 25-34: 0,91 (sobrerrepresentada)
  • Premium: 0,86 (sobrerrepresentado)
  • Estándar: 1,08 (infrarrepresentado)

Antes del reequilibrio:

  • Satisfacción media: 6,8/10
  • Tasa de recomendación: 72 %

Después del reequilibrio:

  • Satisfacción media: 6,5/10 (ajustada)
  • Tasa de recomendación: 68 % (ajustada)

Exporte en varios formatos:

CSV:

user_id,q_overall,q_reason,q_recommend,weight,segment
1001,4,2,0,1.08,standard
1002,8,NULL,1,0.86,premium

SPSS (.sav): con etiquetas de variable y ponderaciones incluidas

Excel / Parquet: el conjunto de datos completo con la columna de ponderación, listo para su herramienta de análisis

Resumen estadístico: medias ponderadas, intervalos de confianza, tablas cruzadas

Diseño → Campaña → Ejecución → Análisis

Sección titulada «Diseño → Campaña → Ejecución → Análisis»

Armiger:

AI generates questionnaire
→ SMT validates: ✓ SAT, ✓ No cycles, ✓ All reachable
→ Saved as a new version of the questionnaire

Targetor:

Import 10,000 users
→ Select 1,200 (stratified sampling, 2.4× oversampling)
→ Launch campaign
→ Send unique survey links

SirWay:

User 1001 clicks link
→ Load QML, init: satisfaction_level=0, needs_followup=0
→ Present: q_overall
→ Collect: 4 → Execute: needs_followup=1
→ Present: q_reason (precondition satisfied)
→ Collect: 2 (Delivery time)
→ Present: q_recommend
→ Collect: 0 (No)
→ Complete: 3 items, 45 seconds

Balansor:

Load 500 responses
→ Calculate weights by demographic
→ Apply post-stratification
→ Export corrected data
→ Result: Weighted satisfaction 6.5/10 (CI: 6.2-6.8)

Flujo de trabajo clave:

  1. ✓ Diseñe con IA y validación SMT en Armiger
  2. ✓ Cree campañas con segmentación demográfica en Targetor
  3. ✓ Ejecute encuestas con evaluación diferida en SirWay
  4. ✓ Analice con corrección estadística en Balansor

Innovación clave: la descarga cognitiva. La IA genera las preguntas, SMT garantiza la coherencia y usted se centra en los objetivos de la investigación.