Skip to main content

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.

El Agente Inteligente para Expedientes Docentes es un sistema desarrollado en Python para la Universidad Nacional Experimental de Guayana (UNEG) que automatiza la recepción, clasificación y almacenamiento de documentos académicos. Cuatro agentes autónomos encadenados —monitoreo IMAP, OCR, clasificación LLM y almacenamiento MongoDB— procesan los documentos sin intervención manual, expuestos a través de una API REST completa y una interfaz web integrada.

Inicio Rápido

Levanta el sistema en minutos con Docker o en modo desarrollo local.

Arquitectura

Entiende el pipeline de cuatro agentes y cómo fluyen los documentos.

API Reference

Explora los más de 37 endpoints REST con ejemplos de petición y respuesta.

Proveedores LLM

Configura OpenRouter para producción u Ollama para desarrollo local sin costo.

​
¿Cómo funciona?

El sistema opera a través de un pipeline lineal de cuatro agentes que se encadenan automáticamente:
1

WatcherAgent monitorea el correo IMAP

Conecta a Gmail u otro servidor IMAP y descarga adjuntos (PDF, JPG) de correos que coincidan con palabras clave configuradas. Deduplica por UID de correo y huella SHA-256 del contenido.
2

OcrAgent extrae el texto

Procesa cada archivo con docTR (modelo ~500 MB), produciendo texto completo, JSON estructurado por bloques y confianza promedio por página. Salta archivos ya procesados por hash.
3

ClassifierAgent identifica el tipo de documento

Envía el JSON ligero al LLM configurado (OpenRouter o Ollama) y recibe el tipo de documento (uno de 22 categorías), campos extraídos, nivel de confianza y metadatos del modelo.
4

StorageAgent persiste en MongoDB

Verifica duplicados, crea o recupera el perfil del docente, inserta el documento, actualiza la completitud del expediente y mueve el archivo comprimido a data/storage/.

​
Capacidades del sistema

22 Tipos de Documentos

Cédula, RIF, títulos universitarios, certificados de notas, resoluciones de nombramiento, CV y más — clasificados automáticamente por el LLM.

Chat IA sobre Expedientes

Endpoint POST /expedientes/{cedula}/chat con contexto RAG desde MongoDB. Responde preguntas sobre el docente, sus documentos y completitud del expediente.

Exportación Multi-formato

Descarga expedientes completos en JSON, XML o CSV con un solo endpoint, incluyendo metadatos OCR opcionales.

Logs en Tiempo Real

Streaming de eventos SSE en /logs/stream con filtros por agente y nivel. Descarga completa del audit.jsonl en cualquier momento.

Dos Proveedores LLM

OpenRouter para producción con rotación automática entre modelos fallback. Ollama para desarrollo local sin costo ni API key.

Compresión Automática

PDFs comprimidos con Ghostscript (/ebook) e imágenes con Pillow (JPEG 85%). Si la compresión produce un archivo mayor, se usa el original.

​
Despliegue rápido con Docker

git clone https://github.com/gcapella0/agente-inteligente-expedientes.git
cd agente-inteligente-expedientes
cp .env.example .env
# Edita .env con JWT_SECRET_KEY, MAIL_USER, MAIL_PASS, OPENROUTER_API_KEY
docker compose build && docker compose up -d
curl http://localhost:8000/health
La interfaz web estará disponible en http://localhost:8000/ui y la documentación Swagger en http://localhost:8000/docs.
Las credenciales por defecto al iniciar por primera vez son admin@uneg.edu.ve / admin123. Cámbialas inmediatamente en producción.

Build docs developers (and LLMs) love

Get started for freeTalk to us