📘 Guía de Usuario

MAX Authoring Tool — Sistema de Generación de Preguntas SaberPro

Volver al inicio

1. Cómo ingresar

  1. Abre el enlace de la aplicación en tu navegador (Chrome o Edge recomendado).
  2. Ingresa tu correo electrónico y contraseña proporcionados por el administrador.
  3. Haz clic en "Ingresar".
  4. Si el acceso es correcto, verás la página principal con las opciones disponibles según tu rol.

💡 Tip: Si tienes problemas para ingresar, verifica que estés usando el correo exacto con el que te registraron y asegúrate de que tu conexión a internet sea estable.

3. Generar una pregunta

3.1 Seleccionar el módulo

Elige el módulo correspondiente a la pregunta que deseas crear:

📖 Lectura Crítica🔢 Razonamiento Cuantitativo🏛️ Competencias Ciudadanas✍️ Comunicación Escrita🌐 Inglés

3.2 Completar parámetros

  • Competencia: qué se evalúa (ej. "Identifica y entiende los contenidos explícitos de un texto").
  • Componente: dimensión asociada (ej. "Dimensión textual evidente").
  • Dificultad: Baja, Media o Alta.
  • Respuesta Correcta: A, B, C o D.
  • Afirmaciones, Evidencias, Tareas (opcionales según aplique).

3.3 Buscar contenido (opcional)

Si activas "Buscar contenido de fuentes primarias", escribe un tema y la app traerá textos base de fuentes confiables (DANE, UNESCO, etc.). Muy útil para Lectura Crítica.

3.4 Generar

  1. Haz clic en "Generar Pregunta".
  2. Espera mientras la IA genera la pregunta (puede tardar unos segundos).
  3. Revisa: Contexto, Enunciado, Opciones A–D, Respuesta correcta y Justificación.

4. Gestionar preguntas

📋 Ver listado

En "Mis Preguntas" verás todas tus preguntas con su estado, módulo y dificultad. Usa los filtros por Estado, Módulo y Dificultad para encontrar rápidamente lo que necesitas.

👁️ Ver detalles

Haz clic en "Ver Detalles" para ver el contenido completo de una pregunta.

✏️ Editar (solo borradores)

Abre el detalle → Clic en Editar → Ajusta contexto, enunciado, opciones y justificación → Guarda cambios.

✅ Aprobar

Una vez revisada, haz clic en Aprobar. ⚠️ Una vez aprobada, la pregunta NO se puede editar.

🗑️ Eliminar

Solo preguntas en borrador. Esta acción es permanente.

5. Criterios de construcción de ítems

Las preguntas generadas siguen las plantillas oficiales de construcción del ICFES con 16 criterios, organizados en fases:

📌 Fase 1: Preparación — Elementos de la Rejilla

Antes de construir la pregunta se extraen estos elementos:

  • Clave: Letra de la respuesta correcta (A, B, C o D).
  • Competencia: Lo que se evalúa.
  • Tarea: El verbo/acción que el estudiante debe realizar — es el elemento más importante.
  • Dificultad: Baja, Media o Alta.

📄 Fase 2: Construcción del Contexto

El contexto es la información que se entrega al estudiante. Debe cumplir:

1. Información suficiente y necesaria:

Suficiente para que el estudiante pueda responder. Solo lo que realmente se necesita, sin información extra.

2. Debe contener el componente:

La información debe estar relacionada con el componente definido en la rejilla.

3. Evitar nombres propios:

No usar nombres de empresas, partidos políticos u organizaciones específicas. Ej: en vez de "Coca-Cola", usar "una empresa de bebidas gaseosas".

4. Citar la fuente:

Usar fuentes primarias (DANE, UNESCO, artículos académicos). Indicar "Tomado de" o "Adaptado de" según corresponda.

5. Adecuar al nivel de dificultad:

Baja = lenguaje sencillo, una variable. Media = términos técnicos, múltiples variables. Alta = vocabulario muy técnico, análisis complejo.

❓ Fase 3: Construcción del Enunciado

  • Debe evidenciar la tarea: La tarea de la rejilla debe estar reflejada en el enunciado (parafraseada).
  • Debe ser corto: Máximo 2 renglones. Ejemplos: "Según la tabla, una conclusión sería:", "De acuerdo con los datos, una posible afirmación sería:"

🔤 Fase 4: Construcción del Campo de Respuesta (A, B, C, D)

Es el elemento con más criterios. Se deben crear 4 opciones:

1. Estructura gramatical consistente:

Todas las opciones con la misma estructura. Si una inicia con verbo, todas deben iniciar con verbo.

2. Continuidad con el enunciado:

El enunciado + cada opción forman una sola frase. Las opciones inician en minúscula.

3. Longitud similar:

Todas deben tener longitud comparable. Nunca dejar la respuesta correcta más larga que las demás.

4. Lenguaje según dificultad:

Baja = cotidiano. Media = técnico disciplinar. Alta = vocabulario muy específico.

5. Opciones mutuamente excluyentes:

Ninguna opción debe contener a otra. No usar "todas las anteriores".

6. Técnica de falseamiento:

Primero se elabora la respuesta correcta. Luego se crean las falsas cambiando información del contexto (no inventando temas diferentes).

7. Referencia al mismo contexto:

Todas las opciones deben hablar del mismo tema/contenido.

8. Coherencia:

Leer el enunciado completo con cada opción debe formar una frase coherente.

6. Competencias y módulos

MAX Authoring Tool genera preguntas para los 5 módulos genéricos de SaberPro:

📖 Lectura Crítica

Evalúa la capacidad de comprender, interpretar y evaluar textos. Incluye dimensión textual evidente, dimensión intertextual y dimensión enunciativa. Utiliza textos de fuentes primarias como base.

🔢 Razonamiento Cuantitativo

Evalúa la capacidad de interpretar, representar y resolver problemas cuantitativos. Incluye interpretación de datos, formulación y validación. Trabaja con tablas, gráficas y datos estadísticos.

🏛️ Competencias Ciudadanas

Evalúa conocimiento y pensamiento ciudadano. Incluye comprensión de la constitución, análisis de situaciones sociales y toma de decisiones éticas.

✍️ Comunicación Escrita

Evalúa la capacidad de comunicar ideas por escrito. Incluye planificación, organización y revisión textual con coherencia y cohesión.

🌐 Inglés

Evalúa la competencia en lengua inglesa alineada con el Marco Común Europeo de Referencia (niveles A1 a B2).

7. Niveles de dificultad

🟢 Baja

  • Objetivo: Que el 70-100% de evaluados responda correctamente.
  • Contexto: Una sola variable, lenguaje muy sencillo, información cotidiana.
  • Opciones: Lenguaje común y simple.
  • Análisis: Básico y directo.

🟡 Media

  • Objetivo: Que aproximadamente la mitad de estudiantes responda.
  • Contexto: Múltiples variables, términos técnicos disciplinares, tablas de doble entrada.
  • Opciones: Términos técnicos del campo disciplinar.
  • Análisis: Disciplinar y multidisciplinar.

🔴 Alta

  • Objetivo: Solo un pequeño porcentaje responda.
  • Contexto: Muy estructurado, vocabulario técnico muy específico, múltiples variables.
  • Opciones: Justificaciones complejas, análisis profundo.
  • Análisis: Muy amplio y profundo.

8. Buenas prácticas

✅ Antes de aprobar, verifica:

  • Coherencia del contexto con la pregunta.
  • Claridad del enunciado.
  • Que solo UNA opción sea claramente correcta.
  • Consistencia y plausibilidad de los distractores.
  • Que la respuesta correcta coincida con la letra seleccionada.

📝 Redacción:

  • Formal, clara y sin ambigüedades.
  • Opciones de longitud similar.
  • Evitar pistas evidentes ("todas las anteriores").
  • Usar fuentes primarias y citarlas.
  • Evitar nombres propios de empresas o personas.

⚠️ Errores comunes a evitar:

  • Dejar la respuesta correcta más larga que las demás (da pista al estudiante).
  • Opciones con estructura gramatical inconsistente.
  • Distractores que hablan de un tema diferente al contexto.
  • Enunciados demasiado largos (máximo 2 renglones).
  • Usar fuentes no primarias (blogs, Wikipedia).

🔧 9. Solución de problemas

"No se pudieron generar opciones A–D válidas"

→ Reintenta la generación. Si persiste, cambia ligeramente el enunciado o baja la dificultad.

No aparecen opciones (A, B, C, D)

→ Si es una pregunta antigua, pudo guardarse incompleta. Genera una nueva.

"No se encontraron preguntas"

→ Revisa los filtros activos (Estado/Módulo/Dificultad). Cambia Módulo a "Todos".

"No hay perfil de usuario cargado"

→ Cierra sesión y vuelve a entrar. Si persiste, contacta a soporte.

📞 10. Soporte

Si necesitas ayuda, envía a soporte la siguiente información:

  • Tu correo de usuario.
  • Módulo y dificultad que estabas usando.
  • Qué estabas intentando hacer.
  • Captura de pantalla (si aplica).
  • Fecha y hora aproximada del problema.