core_ai es el subsistema de IA generativa que trae Moodle 5.1 de serie. Es independiente del
Alcance 3 de este proyecto: la capa de datos para el agente IA externo y el
Drawer IA no lo usan. No se entrega ninguna configuración de core_ai ni
figura en el plan de despliegue.
Se documenta como contexto de plataforma. Ver Agente IA para lo que sí forma parte de la entrega.
Proveedores de IA — Subsistema AI de Moodle 5.1
Administracion: Administracion del sitio > IA (/admin/category.php?category=ai)
Estado: Subsistema instalado y activo. Proveedores disponibles, pendientes de configurar credenciales para activacion en produccion.
Que es el subsistema AI de Moodle 5.1
Moodle 5.1 incluye de serie un subsistema nativo de IA (core_ai) que permite integrar modelos de lenguaje externos para asistir a estudiantes y docentes directamente desde la plataforma, sin plugins de terceros. Gestiona:
- Proveedores (
aiprovider_*): conectores a APIs externas de IA. - Ubicaciones (
aiplacement_*): puntos de la UI donde se expone la IA al usuario. - Politica de uso: aceptacion obligatoria por el usuario antes de usar cualquier funcion de IA.
- Registro de acciones: log auditado de cada llamada a la API de IA.
Proveedores instalados
Los cuatro proveedores incluidos en Moodle 5.1 estan instalados en la plataforma:
| Plugin | Proveedor | Version instalada |
|---|---|---|
aiprovider_openai | OpenAI (GPT-4o, GPT-4, GPT-3.5) | 2025100600 |
aiprovider_azureai | Azure OpenAI Service | 2025100600 |
aiprovider_ollama | Ollama (modelos locales: Llama, Mistral, etc.) | 2025100600 |
aiprovider_deepseek | DeepSeek | 2025100600 |
Estado actual: Todos los proveedores estan instalados. La activacion requiere configurar la API key correspondiente desde la UI de administracion y habilitar el proveedor. El orden de proveedores (
core_ai / provider_order) esta pendiente de configurar.
Ubicaciones de IA habilitadas
Las ubicaciones definen donde aparecen las funciones de IA en la interfaz de Moodle:
| Plugin | Ubicacion | Funciones disponibles |
|---|---|---|
aiplacement_courseassist | Asistente en vista de curso | Resumir contenido, generar texto, explicar |
aiplacement_editor | Editor de texto Moodle (Atto/TinyMCE) | Generar texto, reformular |
tiny_aiplacement | Editor TinyMCE (integrado) | Generar texto, resumir desde el editor |
Acciones de IA registradas
El subsistema registra cada uso de IA en tablas auditables:
| Tabla | Accion registrada |
|---|---|
mdl_ai_action_generate_text | Generacion de texto |
mdl_ai_action_summarise_text | Resumen de contenido |
mdl_ai_action_explain_text | Explicacion de conceptos |
mdl_ai_action_generate_image | Generacion de imagenes |
mdl_ai_action_register | Registro global de todas las acciones |
mdl_ai_policy_register | Aceptaciones de politica de uso por usuario |
mdl_ai_providers | Proveedores configurados y su estado |
Como activar un proveedor
- Ir a Administracion del sitio > IA > Proveedores de IA.
- Seleccionar el proveedor deseado (ej. OpenAI).
- Introducir la API key y el modelo (ej.
gpt-4o). - Habilitar las acciones permitidas (generar texto, resumir, explicar, generar imagen).
- Guardar y verificar la conexion con el boton de prueba.
- Ajustar el orden de proveedores si hay mas de uno activo.
Configuracion minima por proveedor
| Proveedor | Parametros requeridos |
|---|---|
| OpenAI | API key, modelo (ej. gpt-4o), organizacion (opcional) |
| Azure OpenAI | Endpoint, API key, nombre del deployment, version de API |
| Ollama | URL del servidor Ollama (ej. http://localhost:11434), modelo |
| DeepSeek | API key, modelo |
Politica de uso
Moodle requiere que cada usuario acepte la politica de uso de IA antes de poder usar cualquier funcion. La politica se configura en Administracion del sitio > IA > Politica de IA y puede incluir texto personalizado sobre el uso de datos y limitaciones de la IA.
Relacion con el Scope 3 (Agente IA)
El subsistema nativo de IA de Moodle 5.1 es independiente del Scope 3 del proyecto (capa de datos para agente IA externo). El Scope 3 expone datos de progreso via Web Services para un tutor externo; el subsistema core_ai integra IA generativa dentro de la propia interfaz de Moodle para estudiantes y docentes.
Ambos pueden coexistir sin conflicto.
Verificacion
# Ver todos los registros de la tabla ai_providers
docker exec colombiaaprende_db sh -c \
'exec mariadb -umoodle -p"$MYSQL_PASSWORD" moodle -e "SELECT id, component, name, enabled FROM mdl_ai_providers;"'
# Ver cuantos usuarios han aceptado la politica de IA
docker exec colombiaaprende_db sh -c \
'exec mariadb -umoodle -p"$MYSQL_PASSWORD" moodle -e "SELECT COUNT(*) FROM mdl_ai_policy_register;"'
# Ver ultimas acciones de IA registradas
docker exec colombiaaprende_db sh -c \
'exec mariadb -umoodle -p"$MYSQL_PASSWORD" moodle -e \
"SELECT actionname, success, timecreated FROM mdl_ai_action_register ORDER BY timecreated DESC LIMIT 20;"'