Instalación y Configuración de Plugins

Este documento describe el proceso de instalación y la configuración paso a paso de dos plugins locales desarrollados por CEDIA para la plataforma Moodle:

1. ELSA ITS (Chatbot / Tutor Inteligente): - Permite la generación de preguntas y respuestas, la elaboración de pruebas, la creación de casos de estudio y la producción de guías de estudio. - Funciona como un sistema avanzado de tutoría inteligente, aprovechando técnicas de aprendizaje automático para ofrecer una experiencia educativa adaptativa.

2. Guide My Learning (Analíticas de Rendimiento): - Servicio que proporciona analíticas detalladas sobre el progreso de los usuarios en cada curso. - Ayuda a los docentes a obtener una visión clara del rendimiento de sus estudiantes, identificando áreas de mejora y reforzando el proceso formativo. - Depende de ELSA ITS para su correcto funcionamiento, validándose a través del mismo token de seguridad otorgado por CEDIA y configurado en el plugin de ELSA ITS.

Requisitos Previos y Configuraciones Adicionales

Para garantizar el correcto funcionamiento de los plugins, se deben cumplir los siguientes requisitos:

1. Configuración del Cron de Moodle - El cron de tipo adhoc debe estar configurado y activo - El scheduler de Moodle debe estar funcionando correctamente - Verificar la ejecución periódica mediante: php admin/cli/cron.php

2. Permisos de Carpetas - La carpeta de instalación debe tener permisos adecuados para el usuario Apache:

   chown -R apache:apache /ruta/carpeta/moodle

   • Asegurar permisos de escritura: chmod -R 755 /ruta/carpeta/moodle

3. Configuración de Proxy - Si se utiliza un proxy inverso (HA Proxy), actualizar la configuración para permitir el acceso a los nuevos endpoints - Agregar las rutas necesarias para ELSA ITS y GML - Verificar que no haya restricciones de firewall que bloqueen las conexiones

4. Tokens y Seguridad - Habilitar el acceso mediante tokens externos en Moodle:

   Administración del sitio > Características avanzadas > Habilitar servicios web

   • Configurar la política de tokens en: Administración del sitio > Plugins > Servicios web > Administrar tokens

   • La clave de acceso debe enviarse de manera confidencial al correo: info@cedia.org.ec

Importante: Sin estas configuraciones previas, los plugins no funcionarán correctamente. Asegúrese de verificar cada punto antes de continuar con la instalación. 🔧

Instalación de los Plugins

1. Solicitar los Plugins - Obtener los paquetes .zip correspondientes a ELSA ITS y Guide My Learning, provistos por CEDIA.

2. Subida de los Plugins a Moodle - Ingresar al panel de administración de Moodle con privilegios de “Site Administrator”. - Dirigirse a: `Administración del sitio > Plugins > Instalar plugins` - Seleccionar cada archivo .zip (primero ELSA ITS y luego Guide My Learning) y pulsar en “Instalar plugin desde un archivo ZIP”.

3. Verificación e Instalación - Moodle analizará ambos paquetes y mostrará la información de cada plugin. - Si no se presentan errores, hacer clic en “Continuar” para completar cada instalación. - Al finalizar, Moodle redirige a la pantalla de notificaciones/actualizaciones para confirmar que los plugins se han instalado correctamente.

Configuración Inicial de ELSA ITS

Importante: Se recomienda configurar ELSA ITS primero, dado que Guide My Learning depende del token de seguridad establecido en ELSA ITS para su funcionamiento.

1. Recepción del Token - El administrador de ELSA ITS en CEDIA genera un token único. - Dicho código se envía por correo electrónico/otro medio al administrador de Moodle.

2. Acceso a la Sección de Configuración - Ingresar a:` Administración del sitio > Plugins > Local plugins > ELSA` - Se presentará la pantalla de ajustes de ELSA ITS dentro de Moodle.

3. Parámetros Clave de ELSA ITS

   • Server URL - Indicar la dirección del servidor ELSA ITS. - Ejemplo: https://elsaits.cedia.edu.ec/

   • Token - Pegar el token recibido por correo electrónico. - Este código asegura el acceso a las funcionalidades de ELSA ITS y deberá mantenerse confidencial.

   • Session ID Handling - Utiliza un identificador de sesión en lugar de cookies para mayor seguridad.

   • Chat History - Permite guardar (o no) el historial de conversación con el tutor.

   • Max Queries per User - Establece la cantidad máxima de consultas permitidas por usuario, evitando abusos o saturaciones.

   • Translation - Opción para traducir automáticamente el contenido, soportando experiencias multilingües.

   • Responses based on LLM and course content knowledge - Habilita la combinación del conocimiento del modelo de lenguaje con información del curso.

   • Character Limit - Determina la longitud máxima de caracteres que se analizarán en cada pregunta.

   • Number of Questions for Test - Indica cuántas preguntas generará ELSA ITS para la elaboración de evaluaciones rápidas.

   • Chatbot Header Color - Define el color del encabezado del chatbot. - Ejemplo: #4A90E2 (formato hexadecimal)

   • Chatbot Button Color - Establece el color del botón principal del chatbot. - Ejemplo: #2ECC71 (formato hexadecimal)

   • Chatbot Button Text Color - Determina el color del texto en los botones del chatbot. - Ejemplo: #FFFFFF (formato hexadecimal)

4. Guardar la Configuración - Al terminar de ajustar los campos, presionar “Save changes”. - Moodle confirmará que los cambios se han aplicado correctamente.

Configuración de Guide My Learning

Una vez configurado ELSA ITS, se procede a Guide My Learning, el plugin que ofrece analíticas detalladas sobre el rendimiento de los estudiantes:

1. Acceder a la Sección de Configuración - Desde el panel de administración, ir a: `Administración del sitio > Plugins > Local plugins > Guide My Learning`

2. Guardado de Cambios - Hacer clic en “Save changes” para aplicar la configuración. - Cualquier error en la validación del token o la URL será mostrado en esta pantalla.

Prueba de Funcionamiento

1. Verificar Conexión con ELSA ITS - Ingresar a un curso y hacer uso de las funcionalidades de tutor inteligente de ELSA ITS (por ejemplo, realizar preguntas o generar guías de estudio). - Confirmar que el sistema responda de manera adecuada.

2. Comprobar Analíticas en Guide My Learning - Revisar los reportes y estadísticas disponibles para el curso. - Asegurarse de que la información se actualice y refleje el uso real de ELSA ITS por parte de docentes y estudiantes.

3. Consideración Importante sobre la Eliminación de Recursos - Si el Recycle Bin (Papelera de Reciclaje) de Moodle está activado:

   • Los recursos no se eliminarán inmediatamente de la base de conocimiento de ELSA ITS

   • La eliminación definitiva ocurrirá cuando se cumpla el período configurado en la papelera de reciclaje

   Recomendaciones para la eliminación de recursos:

   • Método Preferido: - Desactivar la aceptación de términos dentro del propio recurso antes de eliminarlo - Esto asegura una eliminación inmediata de la base de conocimiento

   • Método Alternativo: - Esperar a que se cumpla el período configurado en la papelera de reciclaje - El recurso se eliminará automáticamente tanto de Moodle como de la base de conocimiento de ELSA ITS