Portal administracion de vFlow v01.04

1 Manual de usuario — VFlow (Portal de IA)

Versión de la aplicación: v01.04.09 · © 2026 MDtel

---

1.1 1. Introducción

VFlow es el portal de administración y analítica de los agentes de IA de MDtel. Desde una única interfaz web permite:

• Consultar métricas de uso (tokens, peticiones, sesiones y tiempos de respuesta) por modelo y periodo.
• Revisar el historial de peticiones y el detalle de las conversaciones de cada sesión.
• Gestionar la base de conocimiento RAG (almacenes de documentos y loaders).
• Administrar los componentes del sistema: plataformas, agentes, orquestadores, usuarios y parámetros globales.
• Mantener objetos de datos estructurados (Metabase de datos).

El manual recorre todas las pantallas en el orden en el que aparecen en el menú lateral.

---

1.2 2. Acceso a la aplicación (Login)

Al abrir https://labvflow/vflow la aplicación redirige a la pantalla de inicio de sesión.

Pasos para iniciar sesión:

1. Introduce tu Usuario en el primer campo.
2. Introduce tu Contraseña.
3. Pulsa el botón Entrar.

El acceso está restringido a usuarios expresamente autorizados. Si las credenciales son incorrectas, la aplicación no permitirá el acceso y permanecerá en esta pantalla.

Una vez autenticado, se accede al Panel (dashboard) principal.

---

1.3 3. Estructura general y menú de navegación

Tras iniciar sesión, la interfaz se organiza en dos zonas:

• Barra lateral izquierda: menú de navegación por iconos. Al pasar el ratón se muestra el nombre de cada sección.
• Área de contenido: muestra la pantalla de la sección seleccionada.

El menú lateral contiene las siguientes secciones (de arriba a abajo):

Icono	Sección	Descripción
📊	Panel	Analítica y métricas de uso (dashboard).
📋	Peticiones	Historial de todas las peticiones realizadas.
💬	Sesiones	Historial de sesiones y detalle de conversaciones.
🗄️	Gestión RAG	Documentos y versiones de los almacenes RAG.
🛡️	Administración	Panel de administración de todos los componentes.
⚙️	Configuración	Ajustes de la interfaz (tema, idioma, etiquetas).
⤺	Salir	Cierra la sesión.

En la esquina inferior izquierda se muestra siempre la versión de la aplicación (v01.04.09) y el aviso de copyright.

---

1.4 4. Panel (Dashboard)

Ruta: /vflow/dashboard

Es la pantalla de inicio. Muestra el análisis y las métricas de uso del sistema.

Elementos de la cabecera:

• Total de tokens, Total de peticiones y Chats únicos: contadores globales del periodo seleccionado.
• Gráficas (desplegable): permite mostrar/ocultar las gráficas disponibles.
• Periodo (desplegable): filtra todas las métricas por el rango de fechas elegido.
• + Añadir gráfica: abre el asistente para crear una gráfica personalizada (ver 4.1).

Gráficas incluidas por defecto:

• Tokens por Modelo — tabla con el total de tokens consumidos por cada modelo.
• Evolución de Peticiones — evolución temporal del número de peticiones.
• Peticiones por Modelo — comparativa de peticiones por modelo.
• Evolución de Tokens — evolución temporal del consumo de tokens.
• Llamadas LLM por Día, Tiempo de respuesta por modelo (ms) y Peticiones por hora del día (más abajo en la página).

Cada gráfica dispone del botón ⚙ Configuración de Gráficos y de una leyenda con los modelos, donde se puede quitar un modelo pulsando la ✕ de su etiqueta.

1.4.1 4.1 Añadir una gráfica personalizada

Al pulsar + Añadir gráfica se abre el asistente Crear gráfica personalizada:

Opciones de configuración:

• Nombre de la gráfica: título que se mostrará.
• Fuente de datos: origen de los datos (p. ej. Consumos (DAT_CONSUMOS)).
• Agrupar por: dimensión de agrupación (p. ej. Por Modelo).
• Métrica: valor a representar (p. ej. Número de llamadas).
• Tipo de gráfica: Barras, Horizontal, Línea, Área, Circular, Donut, KPI, Radar, Mapa de calor, Medidor, Histograma, Treemap o Dispersión.
• Color, Estilo (mostrar leyenda, opacidad), rangos Y mínimo / Y máximo y Umbral de alerta.

A la derecha se muestra una Vista previa en tiempo real. Pulsa Guardar gráfica para añadirla al panel o Cancelar para descartar.

Nota: la creación de gráficas personalizadas puede estar limitada por rol (ver 8.5 Configuración del sistema → Overrides por rol).

---

1.5 5. Peticiones

Ruta: /vflow/requests

Muestra el Historial de Peticiones: la lista completa de todas las peticiones realizadas al sistema.

Filtros (parte superior):

• Plataformas, Agentes, Orquestadores: desplegables para filtrar por cada componente.
• Periodo: filtra por rango de fechas.

Tabla de Peticiones:

• Campo de Búsqueda y selector de Registros por página (10 por defecto).
• Columnas: Message ID, ID de sesión, Fecha, Pregunta y Respuesta.
• Indicador "Mostrando 1 a 10 de N resultados" y paginación en la parte inferior.

Es la vista de referencia para auditar de forma tabular qué se preguntó, cuándo y qué respondió el agente.

---

1.6 6. Sesiones

Ruta: /vflow/conversations

Muestra el Historial de sesiones. Cada sesión agrupa los mensajes de una conversación.

Panel izquierdo (listado):

• Buscador "Buscar por ID de sesión o texto".
• Botón Cargar más para paginar resultados.
• Cada tarjeta muestra: plataforma (p. ej. omsui_1), fecha/hora, agente e ID de sesión, y el número de mensajes (N msg).
• Filtros superiores: Plataformas, Agentes, Orquestadores, Sesiones y Periodo.

Panel derecho (detalle): al seleccionar una sesión se muestra la conversación completa en formato chat.

En el detalle se ven, en orden cronológico, los mensajes del usuario (a la derecha) y las respuestas del agente (a la izquierda, con el nombre del agente), junto con la cabecera de la sesión (plataforma, agente e ID).

---

1.7 7. Gestión RAG

Ruta: /vflow/rag-management

Permite gestionar los documentos del sistema RAG (Retrieval-Augmented Generation), organizados por almacén (store).

• Cada bloque corresponde a un RAG Store (p. ej. ARA002, General, DS_ARA) e indica su UUID y un estado (ACTUALIZADO).
• Al expandir un store (flecha ▾) se muestran sus documentos/loaders. Para cada documento:
  • Nombre del documento (p. ej. ARA002_ld1).
  • Versión activa (etiqueta, p. ej. v3).
  • Acciones: subir/actualizar (icono nube) y eliminar (icono papelera).

Esta pantalla es la vista operativa del contenido RAG. La definición de los stores y loaders se realiza en Administración (ver 8.6 y 8.7).

---

1.8 8. Administración

Ruta: /vflow/admin

Panel central para administrar y configurar todos los componentes del sistema VFlow. Se presenta como una cuadrícula de tarjetas de acceso.

Tarjetas disponibles:

Tarjeta	Función
Plataformas	Gestión de plataformas.
Agentes	Gestión de agentes.
Orquestadores	Gestión de orquestadores.
Usuarios	Gestión de usuarios.
Configuración del sistema	Parámetros y ajustes globales.
RAG Stores	Almacenes de documentos RAG.
RAG Loaders	Loaders de documentos RAG.
Metabase de datos	Objetos, campos y registros estructurados.

Aviso mostrado en la propia pantalla: "Desde este panel puedes administrar todas las configuraciones críticas del sistema VFlow. Asegúrate de tener los permisos necesarios antes de realizar cambios."

En todas las subpantallas de administración el botón ← Volver regresa a este panel.

1.8.1 8.1 Plataformas

Ruta: /vflow/admin/plataformas

Listado de plataformas conectadas (p. ej. VIVAit, OmniSuite).

• Columnas: Nombre, Identificador (UUID), Descripción, Tipo (vivait, omniSuite…), Max Sesiones y Acciones (editar ✏️ / eliminar 🗑️).
• Botón + Crear para dar de alta una plataforma.

Formulario de creación/edición:

Campos:

• Nombre (obligatorio).
• Tipo (obligatorio): selector de tipo de plataforma.
• Descripción.
• Max Sesiones Abiertas, Max Peticiones Simultáneas, Max Peticiones/Min/Sesión: límites de capacidad.

Pulsa Guardar para confirmar o Cancelar para descartar.

1.8.2 8.2 Agentes

Ruta: /vflow/admin/agentes

Gestión de los agentes de IA.

• Columnas: Nombre, Descripción, Plataformas, Orquestadores, IDs entorno (PRO / PRE / PRU) y Acciones.
• Los IDs entorno muestran el identificador del agente en cada entorno: PRO (Producción), PRE (Preproducción) y PRU (Pruebas).
• Botón + Nuevo Agente.

Formulario de agente:

Campos:

• Nombre (obligatorio).
• ID Agente Producción (obligatorio), ID Agente Preproducción, ID Agente Pruebas: identificadores del agente en cada entorno.
• Descripción.
• Plataformas (obligatorio) y Orquestadores (obligatorio): selección del componente asociado.
• Timeout Respuesta (ms): tiempo máximo de espera de respuesta (30000 por defecto).

Los campos marcados con * son obligatorios. Pulsa Guardar.

1.8.3 8.3 Orquestadores

Ruta: /vflow/admin/orquestadores

Gestión de los orquestadores (motores que enrutan/ejecutan las peticiones, p. ej. Flowise, Bucle).

• Columnas: Nombre, Descripción, Tipo (Bucle, Flowise…), URL Conexión y Acciones.
• Botón + Crear.

Formulario de orquestador:

Campos:

• Nombre (obligatorio) y Tipo (obligatorio).
• URL Conexión (obligatorio): endpoint del orquestador.
• URL Proxy (opcional), URL RAG.
• Cadena de Autenticación: Bearer token o API Key.
• Usuario (opcional) y Contraseña (opcional).
• Descripción.

1.8.4 8.4 Usuarios

Ruta: /vflow/admin/usuarios

Gestión de las cuentas de usuario de VFlow.

• Columnas: Nombre, Cuenta (login), Rol (Invitado, Usuario, Administrador), Activo y Acciones.
• Botón + Crear.

Formulario de usuario:

Campos:

• Nombre (obligatorio), Primer Apellido, Segundo Apellido.
• Email (obligatorio), Móvil, Cuenta (login) (obligatorio).
• Contraseña (obligatorio).
• Rol (obligatorio): perfil de permisos.
• Modo de Login: Local (u otros modos disponibles, p. ej. SSO).

1.8.5 8.5 Configuración del sistema

Ruta: /vflow/admin/configuracion

Parámetros y ajustes globales del sistema. Está organizada en pestañas. Los cambios se confirman con el botón Guardar Configuración (abajo a la derecha).

Pestaña Monitorización — estado general e incidencias recientes del frontend:

Muestra tarjetas de estado: Estado (Backend disponible), Nivel de log, Stores pendientes, Histórico de sincronización, Errores recientes, Warnings recientes y Última comprobación. El botón Actualizar estado refresca los datos. Debajo se listan los stores pendientes de sincronización y el histórico de sincronización.

Indicación en pantalla: los logs de frontend se ven en F12 > Consola; los del backend en /opt/tomcat11/logs/catalina.out.

Pestaña Tarificación:

• Peticiones por Bloque a Tarificar y Segundos por Bloque a Tarificar.

Pestaña Configuración runtime — se guarda en vflow-config.json y se aplica al refrescar la aplicación:

• URL de la API backend (p. ej. /vflow/api): ruta que usa el frontend para llamar al backend.
• Tamaño de página de sesiones: nº de sesiones por tanda en la pantalla de conversaciones.
• Nivel de log: DEBUG muestra todo, ERROR solo fallos.
• Overrides por rol: permite ajustar 2FA y la visibilidad del dashboard por perfil (Administrador, Invitado, Usuario), incluyendo qué gráficas ve cada rol y si puede crear gráficas personalizadas.

Pestaña Rutas de Archivos — configuradas en servidor, no editables desde la interfaz:

• Ruta de Documentos (p. ej. /etc/MDtel/vFlow/Documentos/).
• Ruta API Loader (p. ej. /var/www/html/storages/).

Pestaña Timeouts de Sesión (segundos):

• Dormir Sesión, Sesión Voz, Sesión Chat y Sesión Email: tiempos de expiración por tipo de sesión.

1.8.6 8.6 RAG Stores

Ruta: /vflow/admin/rag-stores

Gestión de los almacenes de documentos RAG.

• Columnas: Nombre, Descripción, Plataformas, ID Store Producción, ID Store Preproducción, ID Store Pruebas y Acciones.
• Botón + Nuevo RAG Store.

Formulario de RAG Store:

Campos:

• Nombre (obligatorio), Plataformas (obligatorio), Orquestadores (obligatorio).
• Descripción.
• ID Store Producción (obligatorio), ID Store Preproducción, ID Store Pruebas: identificadores del Document Store en cada entorno.

1.8.7 8.7 RAG Loaders

Ruta: /vflow/admin/rag-loaders

Gestión de los loaders (cargadores de documentos) asociados a los RAG Stores.

• Columnas: Nombre, RAG Stores, Interno (gestionado por VFlow), Configuración JSON y Acciones (eliminar).
• Botón + Añadir loader.

Formulario de loader:

Campos:

• Nombre (obligatorio).
• Descripción.
• Nombre del archivo (obligatorio).
• Seleccione un RAG Store (obligatorio): store al que se asocia.
• Contenido detectado del archivo base: área de texto con el contenido.

Pulsa Crear para añadirlo.

1.8.8 8.8 Metabase de datos

Ruta: /vflow/metadata

Gestión de objetos de datos estructurados (tablas de datos que puede usar el sistema: clientes, doctores, etc.).

• Cada tarjeta representa un objeto (p. ej. Clientes, Doctores) e indica su descripción, el JSON asociado y la Ruta.
• Acciones por objeto: Editar objeto (definición/estructura) y Editar/Ver datos (registros).
• Botones superiores: ↻ (refrescar) y + Nuevo objeto.

Nuevo objeto / Editar objeto — define la estructura del objeto:

Campos:

• Nombre (obligatorio), Descripción.
• Nombre del JSON y Ruta de upload.
• Campos: definición de los campos del objeto (botón + Añadir campo).
• A la derecha se muestra una vista previa del JSON resultante.

Editar/Ver datos — gestiona los registros del objeto:

• Tabla paginada con los registros y sus columnas (Id, Nombre, Fecha, Dirección, Localidad, Teléfono, Email, etc.).
• Acciones por fila: editar ✏️ y eliminar 🗑️.
• Botones superiores: ← Volver, ↻ refrescar, ⤒ Importar, Generar JSON, Eliminar todo y + Nuevo registro.

---

1.9 9. Configuración de la interfaz

Al pulsar el icono ⚙ Configuración de la barra lateral (parte inferior) se despliega un pequeño menú de ajustes de la interfaz:

Opciones:

• Tema Claro / Oscuro: interruptor para cambiar el aspecto visual.
• Idioma: selector de idioma (p. ej. ES).
• Etiquetas de navegación: interruptor para mostrar u ocultar los textos junto a los iconos del menú lateral.

Estos ajustes afectan únicamente a la visualización de la interfaz para el usuario actual.

---

1.10 10. Salir de la aplicación

Para cerrar la sesión, pulsa el icono ⤺ Salir situado en la parte inferior de la barra lateral. La aplicación cerrará la sesión y volverá a la pantalla de Login.

---

1.11 Anexo — Rutas de la aplicación

Sección	Ruta
Login	/vflow/login
Panel	/vflow/dashboard
Peticiones	/vflow/requests
Sesiones	/vflow/conversations
Gestión RAG	/vflow/rag-management
Administración	/vflow/admin
Plataformas	/vflow/admin/plataformas
Agentes	/vflow/admin/agentes
Orquestadores	/vflow/admin/orquestadores
Usuarios	/vflow/admin/usuarios
Configuración del sistema	/vflow/admin/configuracion
RAG Stores	/vflow/admin/rag-stores
RAG Loaders	/vflow/admin/rag-loaders
Metabase de datos	/vflow/metadata

---

Manual generado para su publicación en MediaWiki. Las imágenes se encuentran en la carpeta img/.