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.
Resumen
Sección titulada «Resumen»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.
Capacidades clave
Sección titulada «Capacidades clave»- 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
Dominios de investigación admitidos
Sección titulada «Dominios de investigación admitidos»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 |
Arquitectura del Diseñador
Sección titulada «Arquitectura del Diseñador»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.
Ideación: dónde empieza un proyecto
Sección titulada «Ideación: dónde empieza un proyecto»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.
Subir un documento más tarde
Sección titulada «Subir un documento más tarde»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:
- Mencionarlo directamente en la conversación. El Diseñador incorpora los pasajes pertinentes y sigue perfeccionando el artículo existente.
- 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.
Proceso de indexación de documentos
Sección titulada «Proceso de indexación de documentos»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.
Indexación semántica
Sección titulada «Indexación semántica»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:
- 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
- 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
- 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)
- 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
- 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.
Aislamiento de documentos por proyecto
Sección titulada «Aislamiento de documentos por proyecto»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.
Herramientas MCP de documentos
Sección titulada «Herramientas MCP de documentos»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 |
Incorporación de documentos
Sección titulada «Incorporación de documentos»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:
- Indexa todos los documentos con fragmentación semántica y embeddings vectoriales
- Identifica los tipos de documento (normativos, académicos, operativos, etc.)
- Establece referencias cruzadas entre documentos relacionados
- Los prioriza por pertinencia respecto al artículo de investigación mediante búsqueda por similitud del coseno
Extracción de conceptos
Sección titulada «Extracción de conceptos»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) │└─────────────────────────────┴────────────────────────────────────┘Identificación de capítulos
Sección titulada «Identificación de capítulos»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?Alineación con el investigador
Sección titulada «Alineación con el investigador»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.
Preguntas aclaratorias
Sección titulada «Preguntas aclaratorias»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 paperEtapa 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.
Planificación del cuestionario
Sección titulada «Planificación del cuestionario»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.
Redacción y validación del QML
Sección titulada «Redacción y validación del QML»Siguiendo el plan sección por sección, el Diseñador:
- Genera ítems QML que abordan los requisitos de la sección
- Valida cada ítem frente a las restricciones formales con el solucionador SMT (Z3) mediante las herramientas MCP de Askalot
- Corrige automáticamente los problemas de validación que encuentra antes de continuar
- 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.
Generación de QML
Sección titulada «Generación de QML»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"Validación SMT
Sección titulada «Validación SMT»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:
Nivel 1: validación por ítem
Sección titulada «Nivel 1: validación por ítem»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 questionNivel 2: coherencia global
Sección titulada «Nivel 2: coherencia global»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) ...Nivel 3: validación basada en caminos
Sección titulada «Nivel 3: validación basada en caminos»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 0Corrección automática
Sección titulada «Corrección automática»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 validIteración hasta la validez
Sección titulada «Iteración hasta la validez»El ciclo de generación de cada bloque continúa hasta que:
- Se superan todas las validaciones por ítem del bloque
- Se confirma la coherencia global
- 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.Regeneración del QML
Sección titulada «Regeneración del QML»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:
- 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
- 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
- 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.
Traducir el cuestionario
Sección titulada «Traducir el cuestionario»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.
Ciclo de comentarios del cliente
Sección titulada «Ciclo de comentarios del cliente»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.
Pruebas en SirWay
Sección titulada «Pruebas en SirWay»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.Incorporación de los comentarios
Sección titulada «Incorporación de los comentarios»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 logicBuenas prácticas de QML aplicadas
Sección titulada «Buenas prácticas de QML aplicadas»El agente Diseñador aplica las buenas prácticas de la guía Creación de encuestas:
Diseño de las preguntas
Sección titulada «Diseño de las preguntas»| 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 |
Gestión de dependencias
Sección titulada «Gestión de dependencias»| 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 |
Estrategia de validación
Sección titulada «Estrategia de validación»| 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 |
Ejemplo completo del flujo de trabajo
Sección titulada «Ejemplo completo del flujo de trabajo»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?Integración con Armiger
Sección titulada «Integración con Armiger»La generación asistida por IA se integra sin fisuras con Armiger, el entorno de desarrollo de QML basado en el navegador:

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).
Abrir un proyecto
Sección titulada «Abrir un proyecto»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.
Panel Proyecto
Sección titulada «Panel Proyecto»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.
Crear un cuestionario
Sección titulada «Crear un cuestionario»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.
Edición y guardado
Sección titulada «Edición y guardado»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.
Documentos, enlaces y búsqueda
Sección titulada «Documentos, enlaces y búsqueda»- 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.
Proyectos de solo lectura
Sección titulada «Proyectos de solo lectura»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.
Funciones del panel de IA
Sección titulada «Funciones del panel de IA»| 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 |
Colaborar con el Diseñador en tiempo real
Sección titulada «Colaborar con el Diseñador en tiempo real»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.
Proyectos y límites de los documentos
Sección titulada «Proyectos y límites de los documentos»- 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
Documentación relacionada
Sección titulada «Documentación relacionada»- Referencia de la sintaxis de QML: especificación completa del lenguaje QML
- Creación de encuestas: guía para crear encuestas manualmente
- Uso compartido de datos según la organización: aislamiento de los documentos por proyecto
- Análisis de cuestionarios: fundamentos matemáticos
- Validación integral: teoría de la validación
- Gestión de campañas asistida por IA: usar la IA para preparar campañas