feat: integración de Asistente IA contextual con Llama.cpp Qwen3 Coder 30B (SDD-009, v3.8.24)

This commit is contained in:
2026-10-27 07:37:00 -03:00
parent 502865e45b
commit 4125f7f7bd
20 changed files with 1692 additions and 16 deletions
@@ -88,6 +88,11 @@
<i class="bi bi-window-desktop me-2 text-primary"></i>Interfaz & Dashboard
</button>
</li>
<li class="nav-item" role="presentation">
<button class="nav-link" id="tab-ai-btn" data-bs-toggle="tab" data-bs-target="#tab-ai" type="button" role="tab">
<i class="bi bi-cpu me-2 text-success"></i>Asistente IA &amp; LLM Local
</button>
</li>
<li class="nav-item" role="presentation">
<button class="nav-link text-danger" id="tab-maintenance-btn" data-bs-toggle="tab" data-bs-target="#tab-maintenance" type="button" role="tab">
<i class="bi bi-radioactive me-2 text-danger"></i>Mantenimiento &amp; Reinicio
@@ -555,7 +560,165 @@
</div>
<!-- ========================================== -->
<!-- PESTAÑA 5: MANTENIMIENTO & REINICIO -->
<!-- PESTAÑA 5: ASISTENTE IA & LLM LOCAL (SDD-009) -->
<!-- ========================================== -->
<div class="tab-pane fade" id="tab-ai" role="tabpanel">
<div class="row g-4">
<div class="col-lg-8">
<form id="aiConfigForm" onsubmit="saveAiConfig(event)">
<!-- Estado General del Asistente -->
<div class="card border shadow-none bg-body-tertiary p-3 mb-4 rounded-3">
<h6 class="fw-bold mb-3 d-flex align-items-center">
<i class="bi bi-robot text-success me-2"></i>Estado del Tutor Inteligente
</h6>
<div class="form-check form-switch p-0 d-flex align-items-center justify-content-between mb-3 border rounded p-3 bg-body">
<div class="pe-3">
<label class="form-check-label fw-bold mb-1 d-block text-body" for="ai_enabled_switch">
Habilitar Asistente IA Conversacional en la Plataforma
</label>
<div class="text-muted small">
Despliega el widget de chat contextual flotante en la interfaz para todos los perfiles de usuario autenticados (Docentes, Alumnos y Bedelía).
</div>
</div>
<input class="form-check-input ms-2 fs-4" type="checkbox" role="switch" id="ai_enabled_switch"
{% if not settings or not settings.ai or settings.ai.enabled %}checked{% endif %}>
</div>
</div>
<!-- Parámetros de Conexión Llama.cpp / OpenAI Compatible -->
<div class="card border shadow-none bg-body-tertiary p-3 mb-4 rounded-3">
<h6 class="fw-bold mb-3 d-flex align-items-center">
<i class="bi bi-hdd-network text-primary me-2"></i>Conexión al Servidor de Inferencia Local
</h6>
<div class="row g-3">
<div class="col-md-8">
<label class="form-label small fw-semibold" for="ai_base_url">URL Base de la API (Endpoint v1)</label>
<div class="input-group input-group-sm">
<span class="input-group-text"><i class="bi bi-link-45deg"></i></span>
<input type="url" class="form-control" id="ai_base_url" name="base_url"
placeholder="http://10.0.0.214:8080/v1"
value="{{ settings.ai.base_url if settings and settings.ai else 'http://10.0.0.214:8080/v1' }}" required>
</div>
<div class="form-text small">Endpoint compatible con OpenAI expuesto por Llama.cpp en la red local institucional.</div>
</div>
<div class="col-md-4">
<label class="form-label small fw-semibold" for="ai_api_key">Clave API (API Key)</label>
<div class="input-group input-group-sm">
<span class="input-group-text"><i class="bi bi-key"></i></span>
<input type="password" class="form-control" id="ai_api_key" name="api_key"
placeholder="••••••••••••"
value="{{ settings.ai.api_key if settings and settings.ai else 'llama' }}">
</div>
<div class="form-text small">Token Bearer para autorización con el motor de IA.</div>
</div>
</div>
</div>
<!-- Configuración del Modelo y Límites de Contexto -->
<div class="card border shadow-none bg-body-tertiary p-3 mb-4 rounded-3">
<h6 class="fw-bold mb-3 d-flex align-items-center">
<i class="bi bi-cpu-fill text-info me-2"></i>Modelo de Lenguaje & Parámetros de Generación
</h6>
<div class="row g-3 mb-3">
<div class="col-md-6">
<label class="form-label small fw-semibold" for="ai_model">ID del Modelo (Llama.cpp / Ollama)</label>
<input type="text" class="form-control form-control-sm" id="ai_model" name="model"
placeholder="qwen3-coder:30b"
value="{{ settings.ai.model if settings and settings.ai else 'qwen3-coder:30b' }}" required>
<div class="form-text small">Identificador exacto configurado en el servidor de inferencia.</div>
</div>
<div class="col-md-6">
<label class="form-label small fw-semibold" for="ai_model_name">Nombre Descriptivo</label>
<input type="text" class="form-control form-control-sm" id="ai_model_name" name="model_name"
placeholder="Qwen3 Coder 30B-A3B (Llama.cpp)"
value="{{ settings.ai.model_name if settings and settings.ai else 'Qwen3 Coder 30B-A3B (Llama.cpp)' }}">
<div class="form-text small">Etiqueta mostrada en el encabezado del widget de chat.</div>
</div>
</div>
<div class="row g-3">
<div class="col-md-3">
<label class="form-label small fw-semibold" for="ai_temperature">Temperatura</label>
<input type="number" step="0.05" min="0.0" max="2.0" class="form-control form-control-sm" id="ai_temperature" name="temperature"
value="{{ settings.ai.temperature if settings and settings.ai else '0.3' }}" required>
<div class="form-text small">0.3 recomendado para respuestas técnicas exactas.</div>
</div>
<div class="col-md-3">
<label class="form-label small fw-semibold" for="ai_timeout">Timeout (Segundos)</label>
<input type="number" min="5" max="600" class="form-control form-control-sm" id="ai_timeout" name="timeout"
value="{{ settings.ai.timeout if settings and settings.ai else '60' }}" required>
<div class="form-text small">Tiempo límite para inferencias asíncronas no bloqueantes.</div>
</div>
<div class="col-md-3">
<label class="form-label small fw-semibold" for="ai_context_limit">Tokens Contexto</label>
<input type="number" class="form-control form-control-sm" id="ai_context_limit" name="context_limit"
value="{{ settings.ai.context_limit if settings and settings.ai else '65536' }}">
<div class="form-text small">Ventana máxima de contexto del modelo (KV Cache).</div>
</div>
<div class="col-md-3">
<label class="form-label small fw-semibold" for="ai_output_limit">Tokens Salida</label>
<input type="number" class="form-control form-control-sm" id="ai_output_limit" name="output_limit"
value="{{ settings.ai.output_limit if settings and settings.ai else '65536' }}">
<div class="form-text small">Límite de tokens de la respuesta generada.</div>
</div>
</div>
</div>
<!-- Contenedor de Resultado de Prueba -->
<div id="aiTestResult" class="mb-3"></div>
<!-- Acciones del Formulario -->
<div class="d-flex justify-content-between flex-wrap gap-2">
<button type="button" class="btn btn-outline-info btn-sm px-3" id="btnTestAi" onclick="testAiConnection()">
<i class="bi bi-activity me-1"></i>Probar Conexión con Llama.cpp
</button>
<button type="submit" class="btn btn-success btn-sm px-4" id="btnSaveAi">
<i class="bi bi-check2-circle me-1"></i>Guardar Configuración de IA
</button>
</div>
</form>
</div>
<!-- Panel Lateral: Arquitectura y Roles del Agente -->
<div class="col-lg-4">
<div class="card border-0 bg-success-subtle text-success-emphasis p-3 rounded-3 mb-3 shadow-sm">
<h6 class="fw-bold mb-2"><i class="bi bi-shield-check me-2"></i>Arquitectura de Seguridad & Roles</h6>
<p class="small mb-2">
El backend inyecta automáticamente un <strong>System Prompt contextual</strong> según el rol del usuario autenticado:
</p>
<ul class="small mb-2 ps-3">
<li><strong>Docente:</strong> Guía de reserva de aulas, actas en Gradebook y enlaces de Google Meet.</li>
<li><strong>Alumno:</strong> Guía de cursada, aulas del día y horarios. <em>Prohibición total de funciones de gestión.</em></li>
<li><strong>Bedelía / Admin:</strong> Soporte Nivel 1 en el flujo de 9 pasos, resolución de colisiones y Moodle 4.1.</li>
</ul>
<div class="text-success small fw-semibold">
<i class="bi bi-lightning-charge me-1"></i>Inferencia 100% asíncrona no bloqueante con <code>httpx</code>.
</div>
</div>
<div class="card border-0 bg-body-tertiary p-3 rounded-3">
<h6 class="fw-bold mb-2"><i class="bi bi-server me-1"></i>Topología del Servidor Local</h6>
<div class="small text-muted mb-2">
<strong>Host:</strong> <code>10.0.0.214:8080</code><br>
<strong>Motor:</strong> Llama.cpp Server (OpenAI Compatible)<br>
<strong>Modelo Oficial:</strong> Qwen3 Coder 30B-A3B<br>
<strong>Hardware:</strong> Servidor Dedicado GPU UniCABA
</div>
</div>
</div>
</div>
</div>
<!-- ========================================== -->
<!-- PESTAÑA 6: MANTENIMIENTO & REINICIO -->
<!-- ========================================== -->
<div class="tab-pane fade" id="tab-maintenance" role="tabpanel">
<div class="row g-4">
@@ -1251,6 +1414,92 @@ async function saveUiConfig(e) {
}
}
// -------------------------------------------------------------
// Guardar Configuración del Asistente IA (Llama.cpp)
// -------------------------------------------------------------
async function saveAiConfig(e) {
e.preventDefault();
const btn = document.getElementById('btnSaveAi');
btn.disabled = true;
btn.innerHTML = '<span class="spinner-border spinner-border-sm me-1"></span>Guardando...';
const payload = {
enabled: document.getElementById('ai_enabled_switch').checked,
base_url: document.getElementById('ai_base_url').value.trim(),
api_key: document.getElementById('ai_api_key').value.trim(),
model: document.getElementById('ai_model').value.trim(),
model_name: document.getElementById('ai_model_name').value.trim(),
temperature: parseFloat(document.getElementById('ai_temperature').value) || 0.3,
timeout: parseInt(document.getElementById('ai_timeout').value, 10) || 60,
context_limit: parseInt(document.getElementById('ai_context_limit').value, 10) || 65536,
output_limit: parseInt(document.getElementById('ai_output_limit').value, 10) || 65536
};
try {
const res = await fetch('/admin/settings/ai', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(payload)
});
const data = await res.json();
if (res.ok && data.status === 'success') {
showAlert(data.message || 'Configuración de Asistente IA guardada correctamente.', 'success');
} else {
showAlert(data.message || 'Error al guardar la configuración de IA.', 'danger');
}
} catch (err) {
showAlert('Error de comunicación con el servidor: ' + err.message, 'danger');
} finally {
btn.disabled = false;
btn.innerHTML = '<i class="bi bi-check2-circle me-1"></i>Guardar Configuración de IA';
}
}
// -------------------------------------------------------------
// Probar Conexión con Servidor Llama.cpp Local
// -------------------------------------------------------------
async function testAiConnection() {
const btn = document.getElementById('btnTestAi');
const resultBox = document.getElementById('aiTestResult');
btn.disabled = true;
btn.innerHTML = '<span class="spinner-border spinner-border-sm me-1"></span>Conectando...';
resultBox.innerHTML = '<div class="alert alert-info py-2 px-3 small mb-0"><span class="spinner-border spinner-border-sm me-2"></span>Verificando disponibilidad de Llama.cpp y consultando endpoint de modelos...</div>';
const payload = {
base_url: document.getElementById('ai_base_url').value.trim(),
api_key: document.getElementById('ai_api_key').value.trim()
};
try {
const res = await fetch('/admin/settings/ai/test', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(payload)
});
const data = await res.json();
if (res.ok && data.status === 'success') {
const modelsList = (data.models && data.models.length > 0) ? ` Modelos detectados: <code>${data.models.join(', ')}</code>` : '';
resultBox.innerHTML = `
<div class="alert alert-success py-2 px-3 small mb-0 d-flex align-items-center justify-content-between">
<div>
<i class="bi bi-check-circle-fill me-2"></i><strong>${data.message}</strong>${modelsList}
</div>
<span class="badge bg-success-subtle text-success-emphasis border border-success-subtle font-monospace">${data.latency_ms || 0} ms</span>
</div>`;
} else if (data.status === 'warning') {
resultBox.innerHTML = `<div class="alert alert-warning py-2 px-3 small mb-0"><i class="bi bi-exclamation-triangle-fill me-2"></i><strong>Aviso:</strong> ${data.message}</div>`;
} else {
resultBox.innerHTML = `<div class="alert alert-danger py-2 px-3 small mb-0"><i class="bi bi-x-circle-fill me-2"></i><strong>Fallo de conexión:</strong> ${data.message || 'No se pudo contactar al servidor Llama.cpp.'}</div>`;
}
} catch (err) {
resultBox.innerHTML = `<div class="alert alert-danger py-2 px-3 small mb-0"><i class="bi bi-x-circle-fill me-2"></i><strong>Error de red:</strong> ${err.message}</div>`;
} finally {
btn.disabled = false;
btn.innerHTML = '<i class="bi bi-activity me-1"></i>Probar Conexión con Llama.cpp';
}
}
// -------------------------------------------------------------
// Reinicialización Total del Sistema (Requiere Contraseña Admin)
// -------------------------------------------------------------