feat: integración de Asistente IA contextual con Llama.cpp Qwen3 Coder 30B (SDD-009, v3.8.24)
This commit is contained in:
@@ -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 & 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 & 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)
|
||||
// -------------------------------------------------------------
|
||||
|
||||
Reference in New Issue
Block a user