Agente IA (Alcance 3)

Spec: Definición de alcance integración IA–Moodle (docx) Estado: Decidido — pendiente de construcción

Propósito

Dar a un tutor de IA externo acceso seguro y de solo lectura al contexto del estudiante (progreso, completaciones, calificaciones, alertas). El agente consume únicamente un endpoint REST de Moodle con autenticación por token y verificación de capacidades — nunca consulta tablas mdl_* directamente.

Arquitectura decidida

Según ADR-001: funciones externas (Web Services) implementadas dentro de local_pccntr8203403_dashboard, reutilizando su capa de datos.

Pieza	Estado
Capa de datos serializable (course_stats, student_stats, academic_alerts retornan arrays planos)	Implementada — ver local_pccntr8203403_dashboard
db/services.php (declaración del servicio y funciones)	Pendiente
classes/external/ (funciones externas con external_api)	Pendiente
Servicio externo + token para el agente	Parcial — en Pruebas existe el servicio "Componente IA Externo" con funciones core y token; la capacidad propia del plugin sigue pendiente

Relacionados

• Servicio "Componente IA Externo" — servicio de Web Services configurado en Pruebas con las funciones core que consume el agente, y demo de las respuestas JSON por trigger.
• Drawer IA — nombre de la interfaz conversacional del agente; corresponde al elemento Aside - NavigationDrawer (AI Assistant Chat Panel) del diseño en Figma.
• Chat embebido (prueba de concepto) — POC de asistente conversacional flotante en theme_cdigital, independiente de la capa de datos de este alcance; exploración previa del Drawer IA.
• Proveedores de IA (core_ai) — subsistema nativo de Moodle 5.1; independiente de esta capa de datos, pero parte del ecosistema IA del campus.
• Insignia #12 "Aliado Inteligente" (Insignias) — diferida hasta que exista la tutora IA.

El estado consolidado por requerimiento está en Alcances y desarrollos.