El Agente Inteligente para Expedientes Docentes es un sistema Python diseñado para la Universidad Nacional Experimental de Guayana (UNEG) que automatiza íntegramente la gestión de expedientes del personal docente. A través de un pipeline de cuatro agentes autónomos, el sistema recibe correos electrónicos con documentos adjuntos, extrae su contenido mediante OCR, los clasifica con un modelo de lenguaje (LLM) y los almacena organizadamente en MongoDB — eliminando la carga administrativa manual y garantizando trazabilidad completa de cada expediente.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/gcapella0/agente-inteligente-expedientes/llms.txt
Use this file to discover all available pages before exploring further.
Pipeline de cuatro agentes
El corazón del sistema es un pipeline secuencial donde cada agente tiene una responsabilidad única y bien delimitada:WatcherAgent
Monitorea una bandeja de correo institucional vía IMAP. Detecta mensajes nuevos con documentos adjuntos (PDF, imágenes), los descarga al directorio de entrada y dispara el pipeline de procesamiento.
OcrAgent
Aplica OCR a cada archivo recibido usando docTR (
python-doctr[torch]). Extrae el texto completo de PDFs escaneados e imágenes, generando un artefacto de texto estructurado listo para clasificación.ClassifierAgent
Envía el texto extraído a un LLM (OpenRouter, OpenAI u Ollama) con un prompt especializado. El modelo determina el tipo de documento, el RIF del docente y otros metadatos clave de forma automática.
StorageAgent
Persiste el documento, su texto OCR y los metadatos clasificados en MongoDB. Organiza los archivos físicos en una estructura de directorios por docente y tipo, manteniendo el expediente siempre actualizado.
Tipos de documentos soportados
El sistema reconoce y clasifica 22 tipos de documentos definidos en el enumeradoTipoDocumento:
| Código | Descripción |
|---|---|
cedula_identidad | Cédula de identidad |
rif | Registro de Información Fiscal |
partida_nacimiento | Partida de nacimiento |
titulo_bachiller | Título de bachiller |
titulo_universitario | Título universitario de pregrado |
titulo_postgrado | Título de postgrado (especialización, maestría, doctorado) |
certificado_notas_bachillerato | Certificado de notas de bachillerato |
certificado_notas_pregrado | Certificado de notas de pregrado |
certificado_notas_postgrado | Certificado de notas de postgrado |
acta_grado | Acta de grado |
fondo_negro_titulo | Fondo negro del título |
nostrificacion | Nostrificación de títulos extranjeros |
resolucion_nombramiento | Resolución de nombramiento institucional |
evaluacion_docente | Evaluación del desempeño docente |
diploma_curso | Diploma de curso de formación |
diploma_taller | Diploma de taller |
diploma_congreso | Diploma o constancia de congreso |
constancia_trabajo | Constancia de trabajo |
constancia_estudio | Constancia de estudio |
carta_recomendacion | Carta de recomendación |
curriculo_vitae | Currículum vítae |
otro | Documento no clasificado en las categorías anteriores |
Arquitectura y API REST
El sistema expone una API REST construida con FastAPI, protegida con JWT, que permite gestionar docentes, consultar expedientes, subir documentos manualmente y ejecutar el pipeline de agentes bajo demanda. Una interfaz web integrada (/ui) facilita la operación sin necesidad de herramientas externas.
Inicio rápido
Despliega el sistema con Docker o en modo de desarrollo local en menos de cinco minutos.
Arquitectura del sistema
Diagrama detallado del pipeline de agentes, flujo de datos y decisiones de diseño.
Autenticación API
Cómo obtener y usar tokens JWT para interactuar con todos los endpoints protegidos.
Proveedores LLM
Configura OpenRouter, OpenAI u Ollama como backend de clasificación inteligente.
Las credenciales por defecto del administrador son
admin@uneg.edu.ve con contraseña admin123. Cambia esta contraseña inmediatamente después del primer inicio de sesión en cualquier entorno de producción.El sistema está diseñado para integrarse con la infraestructura existente de la UNEG. Todos los modelos de datos, tipos de documentos y flujos de trabajo reflejan los requisitos reales del departamento de gestión docente universitaria.