Ir al contenido
Base de conocimiento

Generación de cuestionarios asistida por IA

Este documento describe la generación de cuestionarios asistida por IA, la función que ayuda a los investigadores a crear encuestas completas y lógicamente sólidas combinando la comprensión del lenguaje natural con la validación matemática formal.

La generación de cuestionarios asistida por IA la dirige el agente Diseñador, que delega en seis subagentes especializados para convertir su artículo de investigación y sus documentos de origen en cuestionarios QML verificados formalmente:

Etapa Subagente Responsabilidad
Investigación Asistente de investigación Incorporar e indexar documentos, extraer conceptos medibles y redactar un artículo de investigación estructurado
Planificación Planificador QML Descomponer el artículo en un plan ordenado de capítulos
Inventario Constructor del inventario Convertir cada capítulo del plan en el inventario del cuestionario: cada pregunta con sus códigos de respuesta, sus saltos y las comprobaciones entre respuestas
Revisión del inventario Juez del inventario Aprobar el inventario o devolver objeciones antes de escribir ningún QML
Redacción Redactor QML Generar QML y validarlo con Z3 capítulo a capítulo, en orden de dependencias
Revisión Revisor del diseño Auditar la calidad del diseño del cuestionario guardado y sin errores, y devolver una ficha de evaluación

Un cuestionario nuevo se guarda junto con su inventario, el mismo registro que lleva un cuestionario importado, de modo que siempre puede ver a partir de qué se generó la primera versión. Regenerar capítulos de un cuestionario existente es una edición y no construye ningún inventario.

Estas etapas se desarrollan dentro de una única conversación continua: usted interactúa con el Diseñador a través de un solo chat, y él decide cuándo pasar el trabajo a cada especialista. No hay un cambio rígido entre una «fase de investigación» y una «fase de diseño»: en el mismo hilo se puede ampliar el artículo con un tema nuevo, generar un primer cuestionario, regenerar los capítulos que falten o validar un cuestionario existente cuando se pida.

  • Indexación semántica de documentos con recuperación basada en grafos para buscar de forma inteligente en grandes conjuntos de documentos
  • Comprensión del lenguaje natural para interpretar los objetivos de investigación y extraer dimensiones cuantitativas
  • Conocimiento del dominio para recomendar tipos de pregunta y escalas de respuesta adecuados
  • Verificación formal con solucionadores SMT (Z3) para garantizar la coherencia lógica
  • Refinamiento iterativo para corregir automáticamente los problemas de validación
  • Aislamiento por proyecto, que garantiza que los documentos de investigación no salgan del ámbito del equipo

El sistema admite una amplia gama de dominios de investigación:

Dominio Ejemplos Enfoque habitual
Sociología Actitudes sociales, estudios demográficos, encuestas comunitarias Características de la población, patrones de comportamiento
Investigación de mercados Preferencias de los consumidores, percepción de marca, pruebas de producto Comportamiento de compra, métricas de satisfacción
Salud y medicina Resultados en pacientes, ensayos clínicos, evaluaciones de bienestar Seguimiento de síntomas, eficacia de los tratamientos, calidad de vida
Política Preferencias de voto, opiniones sobre políticas, sondeos electorales Apoyo a los partidos, importancia de los temas, tablas cruzadas demográficas
Riesgo y cumplimiento Controles internos, cumplimiento normativo, evaluación de riesgos Eficacia de los controles, brechas de cumplimiento, exposición al riesgo
Diligencia debida (due diligence) Evaluación de proveedores, análisis de fusiones y adquisiciones, comprobación de antecedentes Salud financiera, riesgos operativos, factores reputacionales
Compras Evaluación de proveedores, cumplimiento de contratos, evaluación de ofertas Verificación de capacidades, análisis de precios, cumplimiento de los SLA
Seguridad informática Análisis de amenazas, evaluación de vulnerabilidades, postura de seguridad Vectores de riesgo, cobertura de los controles, historial de incidentes
Conflicto de intereses Declaraciones éticas, mapeo de relaciones, verificación de la independencia Relaciones financieras, vínculos personales, influencia en las decisiones

Asistente de investigaciónPlanificador + Redactor QMLRevisor del diseño(ficha de calidad)Documentos de origenIndexación semánticaArtículo de investigaciónAnálisis y síntesisArtículo de investigación estructuradoPlan de capítulosGeneración secuencial(un capítulo cada vez)Ensamblaje + validaciónQML validado

Todos los subagentes comparten el historial de la conversación del Diseñador. El Diseñador conserva el contexto completo (los mensajes anteriores, los documentos indexados y el artículo de investigación) a medida que pasa de la investigación a la planificación, la redacción y la revisión, de modo que no se pierde nada entre etapas.


Etapa de investigación: el Asistente de investigación

Sección titulada «Etapa de investigación: el Asistente de investigación»

El Asistente de investigación del Diseñador procesa los documentos de origen, mantiene un diálogo aclaratorio con el investigador y produce un artículo de investigación estructurado que recoge todos los requisitos para el diseño del cuestionario.

Todo proyecto nuevo empieza con un artículo de investigación vacío: existe el esqueleto de secciones, pero no se ha decidido nada. La primera tarea es la ideación: determinar con usted cuáles son los temas de investigación y cuál es el objetivo de la investigación, y escribirlos en el artículo.

En este punto, el Diseñador dispone como mucho de dos fuentes:

  • La conversación con usted. Siempre está disponible y, a menudo, es la única fuente que necesita. Un proyecto no requiere ningún documento. Si quiere pensar un estudio desde cero en el chat, funciona exactamente igual de bien.
  • Los documentos que haya subido, si ha subido alguno. Askalot une todos los documentos indexados del proyecto en un único índice de temas (una breve síntesis más una lista de temas, cada uno atribuido al archivo del que procede) y se lo entrega al Diseñador mientras el artículo sigue vacío. Así el agente sabe qué material ha aportado usted y qué merece la pena leer a fondo (cosa que hace después mediante recuperación, no adivinando a partir del índice).

El índice de temas es material de origen, nunca el objetivo. El objetivo es lo que produce la ideación, a partir de sus documentos y de su conversación juntos.

Después de la ideación: el artículo toma el relevo

Sección titulada «Después de la ideación: el artículo toma el relevo»

Una vez que el artículo tiene contenido real, dirige todo lo que viene después: la planificación, la redacción, la revisión y, más adelante, la campaña y el análisis. En ese momento se deja de proporcionar al agente el índice de temas de los documentos, de forma deliberada: el artículo es el registro revisado de lo que usted decidió, y seguir enviando junto a él el material de origen sin procesar solo invitaría al agente a volver a los documentos y alejarse de sus decisiones. Sus documentos siguen plenamente disponibles: el Diseñador recupera información de ellos a demanda siempre que una pregunta lo requiera.

Si sube un documento a mitad del proceso, cuando el artículo ya se está perfeccionando, normalmente es porque se ha dado cuenta de que faltaba algo. Tiene dos opciones claras:

  1. Mencionarlo directamente en la conversación. El Diseñador incorpora los pasajes pertinentes y sigue perfeccionando el artículo existente.
  2. Empezar la ideación de nuevo: restablecer la conversación y el artículo. Obtiene un nuevo punto de partida con un índice de temas nuevo que ya incluye el documento.

Askalot no cambia el alcance de su artículo a sus espaldas cuando aparece un archivo nuevo; usted decide cuál de las dos opciones quería.

Los proyectos de investigación grandes suelen implicar abundante material de origen. El Agente de investigación lo trata mediante un flujo de indexación semántica para poder recuperarlo de forma inteligente.

Capa de entradaIndexación semánticaAnálisis de la investigaciónSíntesis de la investigaciónAprobación del usuarioDocumentos de origenArtículo de investigaciónConversión a MarkdownFragmentación en dos pasadas(encabezados → oraciones)Embeddings vectorialesAlmacenamiento en el grafo de conocimientoRecuperación semánticaExtracción de conceptos claveIdentificación de dimensiones cuantificablesAgrupación por temasIdentificación de capítulosDocumento de investigación

Cuando los usuarios suben documentos o hacen referencia a ellos (mediante menciones con @ en el chat), el Agente de investigación los indexa para poder recuperarlos de forma inteligente:

  1. Conversión: los documentos se convierten a Markdown estructurado, que conserva los encabezados, las tablas y el formato. Los documentos PDF conservan marcas de página para citar la fuente
  2. Fragmentación: un proceso en dos pasadas divide los documentos de forma inteligente: primero en los límites de los encabezados, para conservar la estructura de secciones, y después en los límites de las oraciones para las secciones demasiado grandes. El tamaño de los fragmentos se calcula dinámicamente a partir de la ventana de contexto del modelo de embeddings
  3. Embeddings: cada fragmento se convierte en un embedding con el modelo BGE-M3 en el servicio de inferencia local de la plataforma, lo que produce representaciones vectoriales densas. Los embeddings permanecen en la plataforma; todo el razonamiento de los agentes se ejecuta con Claude de Anthropic (a través de la API de Anthropic o de AWS Bedrock)
  4. Almacenamiento: los fragmentos, las entidades y sus relaciones se almacenan en un grafo de conocimiento con embeddings vectoriales para la recuperación híbrida. Los archivos sin cambios (detectados por su tamaño y el hash de su contenido) no se vuelven a indexar
  5. Recuperación: cuando el investigador hace una pregunta, la plataforma usa una recuperación basada en grafos que combina las relaciones entre entidades, la similitud semántica y el recorrido del grafo de conocimiento para encontrar el contexto más pertinente

Esto significa que el Agente de investigación puede manejar grandes conjuntos de documentos (cientos de páginas) sin perder detalles relevantes: recupera exactamente el contexto necesario para cada parte de la conversación, aprovechando tanto las relaciones conceptuales entre entidades como la similitud semántica.

Los documentos indexados siguen el modo de uso compartido de la organización:

  • En las organizaciones no privadas, los documentos indexados en un proyecto solo son visibles para los usuarios que trabajan en ese mismo proyecto. Un investigador de «Satisfacción del cliente 2026» no puede buscar en los documentos indexados por otro equipo que trabaja en «Compromiso de los empleados T1».
  • En las organizaciones privadas, todos los documentos indexados se comparten en toda la organización, de acuerdo con el modelo de confianza colaborativo.

El editor Armiger trabaja con un proyecto cada vez, así que los documentos que sube en él se indexan en ese proyecto. Consulte Uso compartido de datos según la organización para conocer los modos de aislamiento.

El Agente de investigación puede usar las herramientas de exploración de documentos de Portor para recorrer el contenido indexado de forma conversacional:

Herramienta Finalidad
list_indexed_documents Mostrar todos los documentos indexados en el proyecto actual
get_document_summary Obtener el resumen guardado de un documento, por su clave de documento
search_document_chunks_by_keyword Búsqueda de texto completo por palabras clave en los fragmentos indexados
get_document_chunk Recuperar un fragmento concreto por clave de documento e índice

El Agente de investigación acepta varios formatos de documento y convierte cada uno a Markdown estructurado, conservando los encabezados, las tablas y el formato:

  • Documentos PDF (informes, artículos de investigación, normativas), con marcas de página para citar la fuente
  • Documentos de Word (encargos, especificaciones, directrices), conservando la estructura del documento
  • Hojas de cálculo (diccionarios de datos, listas de variables, esquemas de codificación), con formato de tabla
  • Presentaciones (diapositivas de PowerPoint con texto y tablas)
  • Archivos de texto (transcripciones, notas, requisitos)

Para grandes conjuntos de documentos, el Agente de investigación:

  1. Indexa todos los documentos con fragmentación semántica y embeddings vectoriales
  2. Identifica los tipos de documento (normativos, académicos, operativos, etc.)
  3. Establece referencias cruzadas entre documentos relacionados
  4. Los prioriza por pertinencia respecto al artículo de investigación mediante búsqueda por similitud del coseno

A partir de los documentos incorporados, el Agente de investigación extrae:

Tipo de extracción Descripción Ejemplo
Entidades clave Organizaciones, funciones y procesos mencionados «Comité de Auditoría», «Responsable de Riesgos», «Revisión mensual»
Constructos medibles Conceptos que se pueden cuantificar «Nivel de satisfacción», «Frecuencia de aparición», «Valoración de la gravedad»
Variables categóricas Dimensiones de clasificación discretas «Departamento», «Región», «Categoría de producto»
Relaciones Dependencias entre conceptos «La satisfacción se correlaciona con la retención»
Restricciones Reglas y requisitos que afectan a la lógica de las preguntas «Solo aplicable si los ingresos son > 10 M$»

Identificación de dimensiones cuantificables

Sección titulada «Identificación de dimensiones cuantificables»

El Agente de investigación identifica los aspectos de la investigación que se pueden medir mediante preguntas de encuesta:

Document excerpt: "Employees must report conflicts of interest annually.
The policy requires disclosure of financial interests
exceeding $5,000 and any family relationships with
vendors or competitors."
Extracted dimensions:
┌─────────────────────────────┬────────────────────────────────────┐
│ Dimension │ Measurement Approach │
├─────────────────────────────┼────────────────────────────────────┤
│ Reporting compliance │ Yes/No + date of last disclosure │
│ Financial interest amount │ Numeric range with thresholds │
│ Relationship types │ Multiple selection (family types) │
│ Entity categories │ Checkbox (vendor, competitor, etc) │
└─────────────────────────────┴────────────────────────────────────┘

En los proyectos de investigación amplios, el Agente de investigación organiza el cuestionario en capítulos lógicos:

User: "Create a questionnaire for evaluating IT security posture
across our organization"
Research Agent: Based on the security framework documents provided, I recommend
organizing the questionnaire into 6 chapters:
Chapter 1: General Information (10 questions)
- Organization details, respondent role, IT environment scope
Chapter 2: Access Control (15 questions)
- Authentication methods, authorization policies, privilege management
Chapter 3: Network Security (12 questions)
- Perimeter protection, segmentation, monitoring capabilities
Chapter 4: Data Protection (14 questions)
- Classification, encryption, backup, retention policies
Chapter 5: Incident Response (11 questions)
- Detection capabilities, response procedures, recovery testing
Chapter 6: Compliance & Governance (8 questions)
- Regulatory requirements, audit findings, policy currency
Would you like me to proceed with this structure, or would you
prefer to modify the chapter organization?

Antes de producir el documento de investigación, el Agente de investigación mantiene un diálogo estructurado para asegurarse de que este se ajuste a los objetivos de investigación.

El Agente de investigación formula preguntas concretas para precisar los requisitos:

Research Agent: I've analyzed your research paper on customer satisfaction.
Before generating the questionnaire, I need to clarify a few points:
1. Target Population
Who are the intended respondents?
[ ] All customers
[ ] Recent purchasers (last 30/90/180 days)
[ ] Specific product line users
[ ] High-value customers only
2. Response Format Preference
For satisfaction ratings, which scale do you prefer?
[ ] 5-point Likert (Strongly Disagree -> Strongly Agree)
[ ] 7-point Likert (more granular)
[ ] 0-10 NPS-style scale
[ ] Let AI recommend based on analysis type
3. Open-Ended Questions
Should the questionnaire include free-text responses?
[ ] Yes, after key sections
[ ] Yes, only at the end
[ ] No, quantitative only
4. Estimated Completion Time
What's the acceptable survey length?
[ ] Under 5 minutes (~15-20 questions)
[ ] 5-10 minutes (~25-40 questions)
[ ] 10-15 minutes (~40-60 questions)
[ ] Comprehensive (60+ questions, with progress saves)

Validación del diseño de la investigación

Sección titulada «Validación del diseño de la investigación»

El Agente de investigación comprueba que el diseño de cuestionario propuesto se ajusta a la metodología de la investigación:

Research Agent: Based on your research objectives, I've identified the following
analytical requirements:
Statistical Analysis Planned:
┌─────────────────────────┬─────────────────────────────────────┐
│ Analysis Type │ Questionnaire Implication │
├─────────────────────────┼─────────────────────────────────────┤
│ Cross-tabulation │ Need categorical demographics │
│ Regression analysis │ Need continuous outcome variables │
│ Factor analysis │ Need multiple items per construct │
│ Segment comparison │ Need clear grouping variables │
└─────────────────────────┴─────────────────────────────────────┘
Recommended additions:
- Add 3 demographic questions to enable cross-tabulation
- Include 4-item scales for key constructs to support factor analysis
- Add "segment identifier" question for group comparisons
Accept these recommendations?

El artículo de investigación: de los objetivos a las preguntas

Sección titulada «El artículo de investigación: de los objetivos a las preguntas»

El resultado del Asistente de investigación es un artículo de investigación estructurado: el documento compartido en el que todos los agentes leen y escriben a lo largo de todo el proyecto. Dos de sus secciones forman una capa de medición que le ofrece trazabilidad de principio a fin, desde lo que quiere saber hasta las preguntas que lo recogen:

  • Objetivos de investigación: las preguntas de investigación concretas que el estudio debe responder, cada una con su etiqueta (por ejemplo, RQ-1, RQ-2).
  • KPI: el valor cuantificable que da respuesta a cada pregunta de investigación, cada uno con una definición y la forma en que se medirá (su modo de recogida), además de los criterios de éxito de la campaña.

Como cada KPI indica cómo se mide, el Planificador QML puede garantizar que cada KPI se recoja en al menos un capítulo del cuestionario, de modo que ningún objetivo de investigación se quede sin una pregunta que lo responda y no exista ninguna pregunta que no remita a un objetivo. Esta misma cadena objetivo → KPI → pregunta es la que el Analista evalúa después para indicarle si los datos recogidos responden realmente a sus preguntas (consulte Análisis de resultados). Usted revisa y perfecciona estas secciones directamente en el artículo, y puede volver a ellas en cualquier momento a medida que evoluciona el alcance de su investigación.

El artículo de investigación como traspaso

Sección titulada «El artículo de investigación como traspaso»

Una vez completada la alineación, el Asistente de investigación ha escrito los capítulos de objetivos del artículo de investigación: los requisitos, las dimensiones extraídas, la estructura de capítulos y las decisiones de diseño de su conversación. El artículo es el contexto del que parten las etapas de planificación y redacción.

El artículo de investigación se guarda con el proyecto capítulo a capítulo, y cada edición se convierte en una nueva versión de ese capítulo en lugar de sustituir la anterior. El editor abre el artículo ensamblado al abrir un proyecto y lo actualiza directamente a medida que escriben los agentes, y la búsqueda del proyecto abarca sus capítulos escritos. Consulte El artículo de investigación.

No hay ningún paso de aprobación entre la investigación y el diseño. Cuando usted pide un cuestionario, el Diseñador empieza a escribirlo en la misma conversación, a partir del artículo tal como esté; puede volver a la investigación en cualquier momento y el artículo crece con ella.

Research Assistant: The paper's goal chapters now cover 6 chapters and
the dimensions we agreed on, with the design rationale.
User: Draft the questionnaire.
→ The same conversation continues
→ The Designer plans and writes the questionnaire from the paper

Etapa de diseño: planificación, redacción y revisión

Sección titulada «Etapa de diseño: planificación, redacción y revisión»

A partir del artículo de investigación y del historial completo de la conversación, el Diseñador produce un cuestionario QML completo y validado formalmente. Internamente coordina un pequeño equipo de subagentes especializados (uno que analiza la investigación, otro que planifica la estructura del cuestionario, otro que escribe y valida los ítems QML y otro que revisa el diseño terminado), pero desde el punto de vista del investigador el Diseñador funciona como un único colaborador coherente.

La ficha de evaluación del Revisor del diseño es la misma evaluación de la calidad del diseño del Estado del instrumento que se calcula cada vez que un cuestionario supera el filtro de publicación (el mismo por el que pasa la generación asistida por IA), de modo que puede abrir la vista Estado del instrumento del cuestionario generado para revisar usted mismo esa ficha antes de asociarlo a una campaña.

Cuando se le pregunta al Diseñador por qué recomienda una redacción, una escala de respuesta o un patrón de salto concretos, fundamenta la respuesta en literatura revisada por pares: Taherdoost (2016) y Aithal & Aithal (2020) para la validez y la fiabilidad; Fagan & Greenberg (1988), Elliott (2012), Feeney & Feeney (2019), Schiopu-Kratina et al. (2015) y Manski & Molinari (2008) para la lógica del cuestionario y la solidez de los patrones de salto; Krosnick (2010), Bradburn et al. (2004) y Fowler (2013) para la redacción y el diseño de escalas. Las citas incluyen el artículo y el año para que pueda comprobarlas directamente. Consulte Resumen de las funciones asistidas por IA → Fundamentación en metodología revisada por pares.

Documento de investigación aprobadoPlan del cuestionarioEscribir ítems QMLValidación SMT con Z3¿Válido?Corrección automáticaQML completoCiclo de comentariosRevisión del investigadorPrueba en SirWay¿Hacen faltacambios?RegenerarCuestionario final NoSíSíNo

El Diseñador empieza descomponiendo el documento de investigación en un plan ordenado de secciones temáticas. Para cada sección registra:

  • Un título y una descripción
  • Los requisitos de investigación que aborda la sección (asociados a los identificadores REQ-* del documento de investigación)
  • Qué variables produce la sección y de qué variables anteriores depende
  • Un número estimado de ítems (normalmente entre 5 y 10 por sección)

El plan determina el orden de generación, de modo que las preguntas dependientes aparezcan después de las preguntas de cuyas respuestas dependen.

Siguiendo el plan sección por sección, el Diseñador:

  1. Genera ítems QML que abordan los requisitos de la sección
  2. Valida cada ítem frente a las restricciones formales con el solucionador SMT (Z3) mediante las herramientas MCP de Askalot
  3. Corrige automáticamente los problemas de validación que encuentra antes de continuar
  4. Une las secciones validadas en un archivo QML completo, en orden de dependencias

Como el Diseñador llama al solucionador SMT durante toda la generación, y no solo al final, la mayoría de los problemas estructurales (preguntas inalcanzables, precondiciones imposibles, poscondiciones contradictorias) se detectan y corrigen mientras se escribe el cuestionario, y no a posteriori.

El agente Diseñador genera el código QML a partir del documento de investigación aprobado:

Designer Agent: Generating Chapter 2: Access Control...
Creating 15 questions covering:
- Authentication mechanisms (4 questions)
- Authorization policies (5 questions)
- Privilege management (4 questions)
- Access monitoring (2 questions)
Applying QML best practices:
- Using appropriate control types for each question
- Setting realistic domain constraints (min/max)
- Adding preconditions for conditional questions
- Including postconditions for logical validation
- Organizing items in dependency order
Generated QML snippet:
- id: q_auth_methods
kind: Question
title: "Which authentication methods are used for system access?"
input:
control: Checkbox
labels:
1: "Username/password"
2: "Multi-factor authentication (MFA)"
4: "Single sign-on (SSO)"
8: "Biometric authentication"
16: "Hardware tokens"
32: "Certificate-based"
- id: q_mfa_coverage
kind: Question
title: "What percentage of user accounts have MFA enabled?"
precondition:
- predicate: (q_auth_methods.outcome & 2) != 0
input:
control: Slider
min: 0
max: 100
step: 5
left: "0%"
right: "100%"
labels:
0: "None"
50: "Half"
100: "All"
postcondition:
- predicate: q_mfa_coverage.outcome >= 0
hint: "Please specify the MFA coverage percentage"

El agente Diseñador envía el QML generado al validador de cuestionarios basado en SMT mediante herramientas MCP. El validador realiza tres niveles de análisis:

Para cada ítem, el validador comprueba:

Comprobación Clasificación Significado
Alcanzabilidad de la precondición ALWAYS / NEVER / CONDITIONAL ¿Se puede llegar alguna vez a esta pregunta?
Validez de la poscondición TAUTOLOGICAL / CONSTRAINING / INFEASIBLE ¿Tiene sentido la regla de validación?
Validation Report - Chapter 2: Access Control
=============================================
Item: q_auth_methods
Precondition: ALWAYS (no dependencies)
Postcondition: TAUTOLOGICAL (no constraints)
Status: Valid
Item: q_mfa_coverage
Precondition: CONDITIONAL (requires MFA selected)
Postcondition: TAUTOLOGICAL
Status: Valid
Item: q_password_complexity
Precondition: CONDITIONAL (requires password auth)
Postcondition: CONSTRAINING (enforces minimum length)
Status: Valid
Item: q_token_expiry
Precondition: NEVER (!)
Issue: Precondition (q_auth_methods.outcome & 64) != 0
references bit 64, but no label with value 64 exists
Status: Error - unreachable question

El validador comprueba si el cuestionario completo tiene al menos un camino de cumplimentación válido:

Global Satisfiability Check
===========================
Formula: B AND (P_i => Q_i) for all items
Result: SAT (satisfiable)
Witness (example valid completion):
q_auth_methods = 7 (password + MFA + SSO)
q_mfa_coverage = 85
q_password_complexity = 3 (complex)
...

Para una validación exhaustiva, el sistema comprueba que ninguna pregunta se vuelva inalcanzable por la acumulación de restricciones:

Accumulated Reachability Analysis
=================================
Item: q_privileged_account_review
Direct precondition: q_has_privileged_accounts.outcome == 1
Accumulated constraints: q_account_management.outcome >= 2
Check: Can both conditions be satisfied simultaneously?
Result: SAT (reachable on valid paths)
Item: q_legacy_system_access
Direct precondition: q_has_legacy_systems.outcome == 1
Accumulated constraints: q_modernization_complete.outcome == 1
Check: Can both conditions be satisfied simultaneously?
Result: UNSAT (!) (dead code - never reachable)
Reason: If modernization is complete, legacy systems flag is forced to 0

Cuando se detectan errores de validación, el agente Diseñador genera correcciones automáticamente:

Designer Agent: Found 2 issues in Chapter 2. Applying corrections...
Issue 1: q_token_expiry references non-existent bit flag
---------------------------------------------------------
Original precondition:
predicate: (q_auth_methods.outcome & 64) != 0
Analysis: Bit 64 not in label set. Hardware tokens use bit 16.
Correction:
predicate: (q_auth_methods.outcome & 16) != 0
Issue 2: q_legacy_system_access is dead code
--------------------------------------------
Original precondition:
predicate: q_has_legacy_systems.outcome == 1
Analysis: Earlier postcondition forces q_has_legacy_systems = 0
when q_modernization_complete = 1, but the precondition
of this question also requires q_modernization_complete = 1.
Correction options:
a) Remove the conflicting postcondition on q_modernization_complete
b) Change this question's precondition to not require modernization
c) Remove this question (if legacy systems are truly gone)
Recommended: Option (a) - relax the postcondition
Re-validating...
All items now valid

El ciclo de generación de cada bloque continúa hasta que:

  1. Se superan todas las validaciones por ítem del bloque
  2. Se confirma la coherencia global
  3. No existe código muerto (nivel de exigencia opcional)

Tras el ensamblaje, una pasada final de validación comprueba la coherencia entre bloques:

Validation Summary - Complete Questionnaire
===========================================
Blocks completed: 6/7 (1 failed, within threshold)
Final status: All validations passed
Per-item results:
85/85 items have valid preconditions
85/85 items have feasible postconditions
0 items classified as dead code
Global consistency: SAT (valid completion exists)
Path coverage: All CONDITIONAL items reachable
QML ready for review.

Si el cuestionario generado necesita una revisión a fondo, puede usar el botón para regenerar el QML en lugar de hacer ediciones sucesivas. La regeneración conserva su investigación y aprende del intento anterior:

  1. Se guardan las conclusiones de la conversación: el sistema extrae las decisiones de diseño, las preferencias y las correcciones de su conversación de generación y las añade al documento de investigación
  2. El intento anterior queda en el historial: no se elimina nada; el nuevo cuestionario se escribe como una versión más, de modo que siempre puede ver lo que produjo el intento anterior o volver a él
  3. Empieza una generación nueva: el agente Diseñador vuelve a recorrer la planificación y la generación, ahora con la investigación original y las conclusiones del intento anterior

Esto significa que cada intento de regeneración aprovecha todo lo hablado antes: el agente Diseñador no repetirá errores que usted ya corrigió en la conversación.


Pida al Diseñador que traduzca un cuestionario validado a otro idioma admitido («traduce esto al húngaro»), o que complete solo los textos sin traducir después de editar el original («el original ha cambiado, actualiza el alemán»). Redacta a partir del texto original en un registro formal, cambia solo el texto (los identificadores de los ítems, los códigos de las opciones y la lógica siguen siendo los del original, por lo que la verificación formal no se ve afectada), conserva el formato y los marcadores de posición, y pregunta antes de sobrescribir una traducción que haya editado una persona. Cada guardado se muestra para su aprobación como cualquier otro cambio del Diseñador. Una traducción completa se ofrece a los encuestados sin ningún paso de revisión adicional. Detalles, grado de completitud y congelación: Traducir un cuestionario.


Tras la validación inicial, el cuestionario entra en un ciclo de comentarios con el investigador. El Diseñador permanece en la misma conversación durante todo el proceso.

El agente Diseñador puede crear una encuesta de prueba en SirWay para que el investigador la pruebe:

Designer Agent: I've created a test instance of Chapter 2 in SirWay.
Test URL: https://sirway.dev.askalot.io/survey/test-abc123
You can:
1. Walk through all question paths
2. See how conditional logic works
3. Test validation messages
4. Experience the respondent interface
The test includes debug mode showing:
- Current variable values
- Active preconditions
- Postcondition status
After testing, let me know what changes you'd like.

Los investigadores pueden pedir modificaciones en lenguaje natural:

User: "The MFA coverage question should only appear if they selected
MFA as an authentication method. Also, add a follow-up question
about MFA bypass procedures when coverage is below 100%."
Designer Agent: Understood. Making the following changes to Chapter 2:
Change 1: q_mfa_coverage precondition
-------------------------------------
The precondition already checks for MFA selection:
predicate: (q_auth_methods.outcome & 2) != 0
This is correct (bit 2 = MFA). No change needed.
Change 2: New question q_mfa_bypass
------------------------------------
Adding new question after q_mfa_coverage:
- id: q_mfa_bypass
kind: Question
title: "Are there documented procedures for MFA bypass in emergencies?"
precondition:
- predicate: q_mfa_coverage.outcome < 100
input:
control: Radio
labels:
1: "Yes, formally documented and tested"
2: "Yes, but informal/ad-hoc"
3: "No bypass procedures exist"
4: "Unknown"
Re-validating...
New question validated successfully
Precondition: CONDITIONAL (appears when MFA < 100%)
No conflicts with existing logic

El agente Diseñador aplica las buenas prácticas de la guía Creación de encuestas:

Práctica Aplicación por la IA
Sea específico Genera títulos de pregunta precisos a partir del contexto de los documentos
Use los controles adecuados Elige el tipo de control según el tipo de variable y la distribución de las respuestas
Establezca rangos realistas Deriva los mínimos y máximos de los documentos del dominio y de las normas estadísticas
Aporte contexto Añade textos left/right para unidades y aclaraciones
Práctica Aplicación por la IA
Mantenga juntos los ítems relacionados Agrupa las preguntas por tema dentro de los bloques
El orden importa Garantiza el orden de dependencias en la secuencia de ítems
Pruebe todos los caminos Usa la validación SMT para verificar la alcanzabilidad
Práctica Aplicación por la IA
Restricciones del dominio Fija el mínimo y el máximo del control de entrada a partir de los requisitos extraídos
Poscondiciones Genera reglas de coherencia lógica a partir de las relaciones de los documentos
Indicaciones útiles Crea mensajes de error claros que explican los fallos de validación
Casos límite Añade comprobaciones de límites y el tratamiento de valores extremos

User: "I need to create a due diligence questionnaire for evaluating
potential acquisition targets. I've uploaded 5 documents:
- M&A policy (PDF)
- Financial checklist (Excel)
- Legal requirements (Word)
- IT integration guidelines (PDF)
- HR transition procedures (PDF)"
[Research Assistant]
Research Agent: Indexing documents...
✓ M&A Policy — 24 pages, 47 chunks indexed
✓ Financial Checklist — 8 sheets, 32 chunks indexed
✓ Legal Requirements — 18 pages, 38 chunks indexed
✓ IT Integration Guidelines — 31 pages, 61 chunks indexed
✓ HR Transition Procedures — 15 pages, 29 chunks indexed
Analyzing documents...
Document Summary:
+----------------------------+----------+-----------------------+
| Document | Pages | Key Topics |
+----------------------------+----------+-----------------------+
| M&A Policy | 24 | Process, approvals |
| Financial Checklist | 8 sheets | Revenue, assets, debt |
| Legal Requirements | 18 | Contracts, IP, claims |
| IT Integration Guidelines | 31 | Systems, security |
| HR Transition Procedures | 15 | Staff, benefits |
+----------------------------+----------+-----------------------+
Extracted 147 quantifiable dimensions across 6 themes.
Recommended questionnaire structure (8 chapters, ~85 questions):
1. Company Overview (8 questions)
2. Financial Health (15 questions)
3. Legal & Compliance (12 questions)
4. Operational Assessment (14 questions)
5. Technology & Systems (11 questions)
6. Human Resources (10 questions)
7. Market Position (9 questions)
8. Risk Summary (6 questions)
Estimated completion time: 20-25 minutes
Before I proceed, I have some clarification questions...
[Alignment dialogue continues]
Research Agent: The Research Paper's goal chapters now cover all 8 chapters
and the dimensions we agreed on.
User: Draft the questionnaire.
→ Research Paper chapters written
→ The same conversation continues with the Designer
[Designer]
Designer Agent: Starting QML generation based on the approved research document.
Planning questionnaire structure...
Decomposed into 8 chapters with dependency ordering.
Generating chapters sequentially (in dependency order)...
✓ Block 1: Company Overview — 8 questions, validated
✓ Block 2: Financial Health — 15 questions, validated (2 iterations)
✓ Block 3: Legal & Compliance — 12 questions, validated
✓ Block 4: Operational Assessment — 14 questions, validated
✓ Block 5: Technology & Systems — 11 questions, validated (1 fix)
✓ Block 6: Human Resources — 10 questions, validated
✓ Block 7: Market Position — 9 questions, validated
✓ Block 8: Risk Summary — 6 questions, validated
Assembling blocks (topological sort)...
Final validation passed.
Generation Complete
===================
Total questions: 85
Blocks completed: 8/8
Final status: All blocks validated and assembled
Test URL: https://sirway.dev.askalot.io/survey/test-dd-eval-2026
Would you like to review any specific chapter, or should I
proceed with creating the production questionnaire in Targetor?

La generación asistida por IA se integra sin fisuras con Armiger, el entorno de desarrollo de QML basado en el navegador:

Armiger con la conversación del Diseñador

El editor Armiger en el navegador, con un proyecto Demo: el historial de la conversación del panel de generación con IA con una ejecución del Diseñador (izquierda), el QML que escribió (centro) y el diagrama de flujo del cuestionario (derecha).

La página de inicio de Armiger enumera los proyectos que puede abrir; al elegir uno, el editor se abre con él en la misma pestaña del navegador. El enlace Diseñar en Armiger de Targetor abre el editor directamente, con el cuestionario indicado en primer plano. Necesita el rol de diseñador o de gestor, o el de un administrador.

El editor se ejecuta íntegramente en la pestaña del navegador y trabaja con el proyecto tal como está guardado: no se copia, reserva ni bloquea nada para usted, así que no hay nada que esperar al abrir un proyecto ni nada que resolver al cerrar la pestaña. Para trabajar en otro proyecto, vuelva a la lista de proyectos (el enlace junto al nombre del proyecto en el panel de IA) y elíjalo.

Navegadores compatibles. El editor necesita Chrome o Edge 125, Firefox 147, Safari 26 o una versión posterior de cualquiera de ellos, en un ordenador de sobremesa o portátil. En un navegador más antiguo, la página lo indica en lugar de mostrar un editor vacío. Los teléfonos y las tabletas no son compatibles.

El panel Proyecto de la barra lateral enumera lo que contiene el proyecto abierto: sus cuestionarios, sus documentos de referencia subidos, su artículo de investigación, su material de origen y su índice de temas de los documentos. El Explorador del editor muestra el mismo proyecto como carpetas: questionnaires/, documents/ y el artículo de investigación. El Explorador, la apertura rápida y la búsqueda ven ese único proyecto, de modo que la búsqueda de una frase no puede devolver un resultado de una investigación ajena.

Desde el panel Proyecto puede:

  • Abrir un cuestionario en el editor, con el diagrama de flujo en directo al lado
  • Renombrar, duplicar o eliminar un cuestionario; una eliminación se puede deshacer durante unos segundos, y ninguna de estas acciones afecta a su historial de versiones guardado
  • Subir documentos de referencia al proyecto e indexarlos para la búsqueda semántica (necesario antes de mencionarlos con @ en el chat)
  • Volver a indexar o quitar un documento cuya indexación falló o está desactualizada
  • Ver el artículo de investigación y el índice de temas de los documentos con los que trabaja el Diseñador

Cada documento subido aparece dos veces en documents/: el archivo original y, a su lado, una versión en texto sin formato del mismo documento. Esa versión es la que la plataforma extrajo para la indexación, no una segunda conversión, así que lo que encuentra la búsqueda es lo que leen los agentes de IA. Un documento que todavía se está indexando aparece solo como original, con el estado de su indexación en su entrada, y su texto aparece cuando termina la indexación. También puede subir archivos soltándolos en la carpeta documents.

Elija Nuevo archivo en la carpeta questionnaires del Explorador y escriba un nombre. El cuestionario se crea en el proyecto con un breve texto inicial, se abre en una pestaña y aparece en Targetor como cualquier otro. No necesita credenciales de IA; el Diseñador también puede crearlo por usted. Un cuestionario creado por error se elimina desde el panel Proyecto. Renombrar y eliminar también se hace allí, no desde la lista de archivos.

Edite un cuestionario y guárdelo: no hay ningún paso aparte de publicar, aplicar o confirmar. Cada guardado se almacena de inmediato como una nueva versión de ese cuestionario, de modo que el Diseñador, las herramientas MCP y la campaña que finalmente lleve a campo ven el mismo contenido. El editor también guarda por usted cuando sale de un archivo (al hacer clic en otra pestaña, pasar al panel de chat o salir de la ventana), y la barra de estado indica en qué punto está el guardado del cuestionario abierto.

  • Cambios hechos en otro lugar. Un cambio del Diseñador o de un compañero llega a su pestaña abierta en cuestión de segundos mientras la ventana está en primer plano, con las líneas cambiadas marcadas durante un momento. Si tiene texto sin guardar, ambos se combinan automáticamente. Un cambio del Diseñador ofrece Deshacer en el aviso.
  • Ediciones en conflicto. Cuando su edición y un cambio guardado afectan a las mismas líneas, no se guarda nada y se le pregunta una sola vez: Comparar muestra ambas versiones, Conservar la mía guarda su texto y Usar la guardada guarda la otra. La versión que no elija se queda en el historial de versiones en cualquier caso.
  • Validación. El diagrama y los resultados del panel Problemas describen el texto de su pestaña aproximadamente un segundo después de que deje de escribir, antes de guardarlo, con los mismos resultados verificados con Z3 que en el resto de Askalot.
  • Ayuda para la edición. Autocompletado, ayuda al pasar el puntero y esquema para QML, y formato al guardar.
  • Texto sin guardar. Su navegador le pregunta antes de salir de una pestaña con texto sin guardar. El texto que decidió no guardar no se conserva.
  • Un PDF se abre en un visor integrado que muestra sus páginas como imágenes: puede desplazarse y hacer zoom, pero no seleccionar texto, así que use para ello la versión en texto del documento que está a su lado. Cualquier otro original (un archivo de Word, por ejemplo) se ofrece para descargar. Los documentos y el artículo de investigación son de solo lectura.
  • Solo se abren los enlaces https, en una pestaña nueva del navegador. La vista previa de un documento no carga imágenes ni otro contenido de internet.
  • La búsqueda abarca todos los cuestionarios, los capítulos escritos del artículo de investigación y el texto de todos los documentos indexados, y le avisa cuando no se ha podido buscar en una fuente en lugar de indicar que no hay coincidencias. Se ejecuta al pulsar Intro. Reemplazar solo modifica cuestionarios e indica qué archivos de solo lectura ha dejado intactos.
  • El editor no tiene terminal, ni vista de control de código fuente, ni marketplace de extensiones.

Un proyecto que puede leer pero no modificar, y cualquier proyecto de una organización sellada (incluida la demostración pública), se abre en modo de solo lectura e indica el motivo. Puede seguir leyendo los cuestionarios, ver el diagrama y abrir la vista previa de los ítems. Un cuestionario de más de 1 MB también se abre en modo de solo lectura.

Función Descripción
Nombre del proyecto Indica el proyecto que tiene abierto el editor, con un enlace a la lista de proyectos para pasar a otro
Estado del turno Muestra lo que está haciendo el Diseñador en ese momento: el paso concreto en el que está y cuánto tiempo lleva en marcha
Interfaz de chat Interacción en lenguaje natural con el Diseñador, que delega en sus especialistas según sea necesario
Flujo de actividad Vea cómo llega la respuesta del agente a medida que se escribe, con cada paso de herramienta mostrado mientras se ejecuta: su nombre y cuánto tardó
Subida de documentos Arrastre y suelte documentos de origen para su indexación semántica
Vista previa en directo Vea cómo se actualiza el QML generado en tiempo real
Estado de la validación Información inmediata sobre los resultados de la validación SMT
Artículo de investigación Abra el artículo de investigación del proyecto y vaya a una sección concreta
Generar cuestionario Pida al Diseñador que escriba el cuestionario a partir del artículo de investigación tal como está
Restablecer el chat Borra el historial del chat del proyecto; el artículo de investigación y los cuestionarios generados se conservan. Úselo cuando la salida del chat esté demasiado recargada y quiera una conversación limpia sin perder los capítulos ya rellenados del artículo.
Restablecer el chat y el artículo Borra el chat Y vacía todos los capítulos del artículo de investigación: un reinicio completo del ciclo de investigación y diseño. Los archivos QML generados y las entidades de cuestionario no se tocan, de forma intencionada. Úselo solo cuando quiera empezar desde cero.
Orientar Envíe un mensaje de seguimiento mientras el Diseñador sigue trabajando: incorpora su indicación al turno actual en el siguiente paso, sin reiniciar
Interrumpir y redirigir Detenga lo que está haciendo el Diseñador y llévelo hacia otro lado: su siguiente mensaje reanuda el mismo turno en una nueva dirección (a diferencia de Cancelar, que termina el turno)
Revisar los cambios antes de aplicarlos Cuando el Diseñador propone un cambio en un archivo de cuestionario o en el artículo de investigación, le muestra la diferencia exacta y espera: puede aprobarlo, editar antes el texto propuesto o rechazarlo. Active Aceptar ediciones automáticamente para que una ejecución de confianza avance sin preguntar
Deshacer este turno Revierte los cambios en cuestionarios y en el artículo que hizo un turno completado, restaurando el estado de justo antes de su ejecución. Se rechaza si usted (u otro colaborador) cambió esos archivos entretanto, o si alguien más (una persona, otro chat del Diseñador o un asistente conectado mediante el plugin de Claude) guardó uno de ellos mientras el turno seguía en curso, de modo que nunca sobrescribe trabajo que no sea de ese turno
Cancelar Detiene un turno de agente en curso; cerrar el panel a mitad del turno también lo detiene

El Diseñador trabaja como un colaborador en directo al que puede guiar mientras trabaja, no como una caja negra a la que hay que esperar:

  • Vea cómo piensa. La respuesta del Diseñador llega a medida que se escribe, y cada paso (buscar en sus documentos, validar un bloque, guardar un archivo) aparece en el momento en que ocurre, con lo que tardó. Cuando se detiene para recuperar contexto de sus documentos, el panel se lo indica en lugar de parecer bloqueado.
  • Oriéntelo a mitad del turno. Escriba un mensaje de seguimiento mientras el Diseñador sigue trabajando y este incorporará su indicación en el siguiente paso: útil para «cubre también X» o «haz estas preguntas más cortas» sin empezar de nuevo.
  • Interrúmpalo y rediríjalo. Si el Diseñador va en la dirección equivocada, interrúmpalo y envíe una nueva instrucción; detiene el trabajo en curso y reanuda el mismo turno en la dirección que usted indique. Esto es distinto de Cancelar, que termina el turno por completo.
  • Apruebe los cambios antes de que se apliquen. Siempre que el Diseñador quiere escribir un archivo de cuestionario o actualizar el artículo de investigación, le muestra el cambio exacto frente a la versión guardada y espera su decisión. Puede aprobarlo tal cual, editar el texto propuesto y aprobar su versión, o rechazarlo. Si confía en una ejecución concreta, active Aceptar ediciones automáticamente para que aplique los cambios sin preguntar: si la marca antes de enviar, abarca el turno que envía; si la marca mientras se ejecuta un turno, el resto de ese turno. «Este turno» se desactiva solo cuando termina el turno; «esta sesión» permanece activado.
  • Deshaga un turno entero. Cuando termina un turno, puede deshacerlo para devolver los cuestionarios y el artículo exactamente al estado en que estaban justo antes de que se ejecutara. Si algo de lo que tocó el turno cambió entretanto (por usted, por un compañero o por un turno posterior), la acción de deshacer se rechaza para que nunca pueda borrar trabajo más reciente. Lo mismo ocurre con cualquier otro guardado que se produjera mientras el turno seguía en curso, ya sea suyo, de un compañero o de otra sesión de IA como el plugin de Claude: deshacer el turno se llevaría ese guardado por delante, así que se rechaza. Cada guardado que hace el Diseñador queda registrado como perteneciente a su turno, y así es como la acción de deshacer distingue unos de otros. Tampoco se puede deshacer un turno que trasladó un cuestionario a este proyecto desde otro: deshacer no eliminará un cuestionario que ya existía antes del turno, y no tiene constancia de a qué proyecto devolverlo, así que no cambia nada e indica el motivo.
  • En las organizaciones no privadas, el límite del proyecto es también el límite de los documentos: el editor y el Diseñador solo acceden a lo que pertenece al proyecto abierto
  • En las organizaciones privadas, los documentos indexados se comparten en toda la organización, sea cual sea el proyecto en el que trabaje
  • Cada cuestionario conserva un historial de versiones completo; la versión con la que una campaña sale a campo queda fijada y nunca cambia mientras la campaña la usa