Asistente de IA

El chat de IA de la Academia combina dos plugins de terceros con código propio:

ProveedorCopy Anchor Link

configure-ai-groq.php configura una instancia del conector chatgpt de local_ai_manager apuntando a la API compatible con OpenAI de Groq, con el modelo openai/gpt-oss-20b y la clave tomada de la variable GROQ_API_KEY. Es idempotente (actualiza la instancia existente en vez de duplicarla). moodle-config.sh lo ejecuta en cada despliegue como paso critico cuando GROQ_API_KEY está definida, antes de las cuotas de IA: cambiar la clave en Coolify y hacer Redeploy basta. Sin la variable, el paso no corre y se conservan la instancia y la clave guardadas en la base de datos; si se ejecuta a mano sin la variable, también conserva la clave ya guardada. configure-ai-manager.php es el script anterior para Gemini (clave GEMINI_API_KEY). Las clases propias localizan la instancia buscando el conector chatgpt con un endpoint que contenga groq, o la instancia llamada "Chat IA - Academia Deltamontero".

Perfil del usuario en el chat: ai_role_injectorCopy Anchor Link

El parche patch-ai-role-injection.php inserta en local_ai_manager/classes/external/submit_query.php, justo después de decodificar $options, una llamada a ai_role_injector::inject($options).

inject() busca el perfil delta_* del usuario (primero en contexto de sistema, luego en cualquier curso; el más reciente) y agrega al mensaje con sender = 'system' de options['conversationcontext'] un bloque de contexto con la descripción del perfil (ROLE_LABELS) e instrucciones: responder si su perfil le permite o no una acción, sin remitirlo a otro rol y sin conceder accesos. Si no hay mensaje de sistema, lo crea. No actúa con invitados ni sin perfil.

Agente de acciones: ai_agentCopy Anchor Link

El parche patch-ai-agent.php agrega, después del bloque anterior, un cortocircuito: si ai_agent::maybe_handle($prompt, $options, $contextid) devuelve texto, submit_query responde ese texto; si devuelve null, sigue el chat informativo normal.

Regla de diseño del código: la IA propone, Moodle dispone. Cada herramienta se ejecuta como el usuario conectado, vuelve a validar sus capacidades en el servidor y nunca hace más de lo que esa persona podría hacer a mano.

HerramientasCopy Anchor Link

SalvaguardasCopy Anchor Link

• Confirmación determinista: una escritura nunca se ejecuta porque lo pida el modelo. Se muestra un resumen y la acción queda en $SESSION->deltaagent_pending; solo si el siguiente mensaje del usuario es afirmativo (is_affirmative) el código la ejecuta directamente.
• Cuentas protegidas (target_denied): la propia cuenta, los super administradores y, si quien pide no es super administrador, las cuentas de gestión no se modifican desde el chat.
• Credenciales: la contraseña temporal la muestra el código (credentials_box), no el texto del modelo. Si el correo está configurado, al crear un colaborador no se muestra contraseña: se envía el correo de activación.
• Postulantes: reciben siempre "El asistente de IA no está disponible durante el proceso de selección" (además el botón del chat está oculto para ellos).
• Atajos sin modelo: pedir crear un usuario sin datos muestra la guía de campos y cargos; pedir "un reporte" sin precisar muestra el menú de reportes; responder solo un formato ("en PDF") devuelve el archivo del último reporte ($SESSION->deltaagent_report_last).
• Datos personales ocultos al proveedor: ver la sección siguiente.

Cédulas, RUC y correos fuera del proveedor (pii_hide y pii_restore)Copy Anchor Link

Antes de enviar nada a Groq, el agente reemplaza en el texto los datos identificativos por marcadores:

• pii_hide() se aplica al mensaje actual, a cada mensaje del historial (build_messages) y al resultado de cada herramienta antes de devolverlo al modelo. El mismo dato recibe siempre el mismo marcador.
• La tabla marcador → dato real vive solo en la sesión de la plataforma ($SESSION->deltaagent_pii); no se guarda en la base de datos ni se envía al proveedor.
• pii_restore() devuelve el dato real en dos puntos: en los argumentos de cada herramienta al inicio de run_tool (para que la búsqueda, la creación o la asignación de cédula usen el dato verdadero) y en la respuesta final que ve la persona. Reemplaza primero los marcadores más largos (CEDULA_10 antes que CEDULA_1).
• El mensaje de sistema del agente y las descripciones de las herramientas crear_colaborador y asignar_cedula le indican al modelo que los marcadores son datos válidos y que debe pasarlos tal cual.
• Los nombres sí viajan al proveedor: hacen falta para buscar a las personas y para responder.

Niveles de cuota: ai_tiersCopy Anchor Link

Las cuotas (chat_max_requests_basic, chat_max_requests_extended, periodo de 86.400 s) las fija configure-ai-quotas-and-persona.php en cada despliegue, que además crea la "persona" plantilla del chat con el mensaje de sistema de la Academia y llama a ai_tiers::apply_all().

ai_tiers::apply_user($userid) toma el nivel más alto de los perfiles de la persona. Si no tiene fila en local_ai_manager_userinfo, la crea con ese nivel sin aceptar los términos por ella. Si el nivel actual lo puso este código (registro en la configuración aitier_applied), lo actualiza; si lo cambió una persona en Configuración IA, lo respeta. Nunca desbloquea a alguien bloqueado a mano. Se llama también desde staff_manager::assign_cargo().

Otros ajustes del chatCopy Anchor Link

Configuración IA: aiconfig.phpCopy Anchor Link

Administración del sitio → Configuración IA (categoría propia creada en settings.php si existe local/ai_manager/tenant_config.php), capacidad local/ai_manager:manage. Pestañas: