Saltar al contenido principal

Ajustes del tutor IA (local_pccntr8203403_aitutor)

Configuración de administración del proxy del tutor IA que alimenta el Drawer IA. Sin estos ajustes el drawer se muestra pero las respuestas del tutor fallan (el plugin no tiene endpoint al cual reenviar los mensajes).

Ruta: Administración del sitio → Extensiones → Extensiones locales → Tutor IA (o buscar "aitutor" en el buscador de administración).

Ajustes​

AjusteClaveValorNotas
URL del servidorserverurlURL base del servicio externo de tutoríaHTTPS obligatorio. El plugin le añade la ruta y llama POST {serverurl}/webhook/v1/campus/tutor
Token de autenticacióntokenToken Bearer del servicio externoSe almacena como contraseña enmascarada; solo visible para el administrador, nunca llega al navegador
Límite de frecuenciaratelimitSegundos mínimos entre peticiones por usuario (defecto 2)0 desactiva el límite; usa caché MUC, no base de datos
Tiempo de esperatimeoutTimeout de cURL en segundos (defecto 60, rango 5-120)Subirlo solo si el servicio externo responde lento de forma consistente

Detalle técnico de cada ajuste y del flujo completo: ficha del plugin.

Verificación​

  1. Purgar cachés (php /var/www/admin/cli/purge_caches.php).
  2. Como estudiante matriculado, abrir cualquier página del campus y desplegar el Drawer IA (botón flotante del tutor).
  3. Enviar un mensaje y confirmar respuesta del servicio externo.
  4. Enviar dos mensajes seguidos en menos del ratelimit configurado: el segundo debe rechazarse con el aviso de frecuencia.

Problemas comunes​

  • El drawer responde con error genérico: revisar serverurl y que el token sea vigente. En serverurl va solo la base (esquema y host, HTTPS): el plugin añade por su cuenta /webhook/v1/campus/tutor. Si se incluye esa ruta en el ajuste, la petición se construye duplicada y falla.
  • Respuestas truncadas o timeout: aumentar timeout dentro del rango permitido y revisar la latencia del servicio externo.
  • El drawer no aparece: es renderizado por theme_cdigital (standard_after_main_region_html()); confirmar que el tema activo es cdigital y que el usuario está autenticado.