🖥️ AI Grafo
Objetivo Principal: Ver en un solo mapa cómo se conectan entre sí los equipos, variables, alarmas, tareas y documentos que el copiloto ha ido relacionando, para que los perfiles de administración entiendan de un vistazo qué conoce y por dónde.
Esta página describe una pantalla que aún no está fotografiada en el manual, así que el despiece no numera los elementos sobre una imagen. Lo que se cuenta aquí está contrastado con la versión 0.4.46 de la aplicación.
Se llega desde la pestaña "AI Grafo" de la barra de pestañas de Cuenta. La pestaña solo aparece —y la página solo se abre— para los perfiles Administrador y Admin Global.
🧩 Despiece de Elementos Funcionales
| Nombre del Elemento | Tipo | Destino / Acción | Descripción Funcional |
|---|---|---|---|
| Pestaña "AI Grafo" | Navegación por pestañas | Abrir el grafo de conocimiento | Punto de entrada a la pantalla desde la barra de pestañas de Cuenta, que se mantiene visible arriba para volver a cualquier otra sección de la cuenta. Solo se muestra a los perfiles Administrador y Admin Global. |
| Cabecera "Grafo de conocimiento" | Encabezado informativo | — | Identifica la pantalla e indica cómo se usa: “Explora como se conectan las entidades. Haz clic en un nodo para ver sus relaciones.”. |
| Contadores de nodos y relaciones | Indicadores | — | Dos etiquetas con el tamaño total del grafo: cuántos nodos y cuántas relaciones tiene. |
| Indicador de almacenamiento | Indicador | — | Etiqueta que dice “persistente” cuando el grafo se conserva entre reinicios de la plataforma o “en memoria” cuando no se está guardando de forma permanente en esa instalación. |
| Botón "Actualizar" | Botón de acción | Recargar el grafo | Vuelve a pedir los datos y redibuja el mapa con las relaciones más recientes. Mientras carga, el lienzo muestra “Cargando grafo...”. |
| Campo "Buscar nodo..." | Campo de búsqueda | Localizar un nodo concreto | Al escribir un texto y pulsar Intro, selecciona el primer nodo cuyo nombre contenga ese texto, lo centra en el lienzo y acerca el zoom sobre él. Busca solo entre los nodos visibles con los filtros activos. |
| Filtros por tipo de entidad | Pastillas conmutables | Mostrar u ocultar un tipo | Una pastilla por cada tipo presente en el grafo, con su color: “Usuario”, “Activo”, “Equipo”, “Variable”, “Alarma”, “Conversacion”, “Herramienta”, “Tarea”, “Documento”, “Concepto” y “Otro”. Al pulsarla, ese tipo se apaga y desaparecen del lienzo sus nodos y las relaciones que llegaban a ellos; al volver a pulsarla, reaparecen. |
| Lienzo del grafo | Mapa interactivo | Explorar las relaciones | Dibuja cada entidad como un círculo del color de su tipo, con su nombre debajo y un tamaño proporcional al número de conexiones que tiene. Los nodos muy relacionados tienden a agruparse. Se puede desplazar y acercar con el zoom, y arrastrar un nodo lo deja fijado en esa posición. |
| Resaltado al pasar el ratón | Comportamiento del lienzo | — | Al situar el puntero sobre un nodo, ese nodo y sus vecinos directos se mantienen a plena intensidad y el resto se atenúa. Las relaciones implicadas se remarcan y muestran su nombre en lenguaje natural: “usa”, “pregunto por”, “tiene tarea”, “documentado en”, “genero”, “menciona”, “relacionado con”, “referencia” o “creo”. |
| Panel de detalle del nodo | Panel emergente | Consultar y recorrer las conexiones | Se abre en la esquina superior derecha al pulsar un nodo. Muestra su nombre, su tipo y su grado —el número de conexiones que tiene—, y la lista “Conexiones (N)” con los nodos vecinos: al pulsar cualquiera de ellos, la selección salta a ese nodo. Si no hay ninguna visible, indica “Sin conexiones visibles.”. Se cierra con su aspa o pulsando sobre el fondo del lienzo. |
| Botón de salto a la sección | Botón de acción | Abrir la pantalla de esa entidad | Aparece en el panel de detalle cuando la entidad tiene una pantalla propia en la plataforma, con el texto correspondiente: “Ver equipo”, “Ver variables”, “Ver alarmas”, “Ver tareas” o “Ver en la wiki”. En los nodos de tipo Herramienta el botón lleva a la sección donde actúa esa herramienta (“Ir a Alarmas”, “Ir a la wiki”, “Ir a Auditoria”, “Ir a Variables”, “Ir a Tareas”, “Ir a Senales” o “Ir a Cuenta”). No todos los nodos tienen destino, así que el botón puede no aparecer. |
| Aviso de grafo vacío | Mensaje de estado | — | Si todavía no hay nada que dibujar, el lienzo muestra “El grafo aun esta vacio” y explica que se poblará con el uso del copiloto —consultas, entidades citadas, tareas— y con la incorporación de fuentes de conocimiento. |
| Aviso de filtros sin resultado | Mensaje de estado | — | Si los filtros dejan el lienzo sin nodos, aparece “Ningun nodo con estos filtros” junto a la indicación de reactivar algún tipo de entidad en los filtros de arriba. |
| Nota de vista de inspección | Mensaje informativo | — | Bajo el lienzo, cuando el grafo completo tiene más relaciones de las que se dibujan, avisa de que se están mostrando las entidades más conectadas y una muestra de relaciones, e indica el total real. |
💡 Guía de Uso
El grafo no se rellena a mano: se va formando solo con el uso del copiloto y con el conocimiento que se le carga. Cada vez que alguien le pregunta por un equipo, cita una variable, genera una tarea o se incorpora un documento, esa entidad y sus relaciones aparecen en el mapa. Por eso, en una cuenta recién estrenada la pantalla muestra “El grafo aun esta vacio”: no es un error, es que todavía no hay actividad de la que partir.
Cuando ya hay contenido, empieza por la vista general. Los círculos más grandes son las entidades con más conexiones y suelen ser los conceptos centrales de la instalación. Pasa el ratón por encima de uno: el resto del mapa se atenúa y quedan a la vista solo sus vecinos, con el nombre de cada relación escrito sobre la línea que los une, de manera que se lee casi como una frase.
Si buscas algo concreto, escríbelo en “Buscar nodo...” y pulsa Intro: el mapa se centra en la primera coincidencia y acerca el zoom. Ten en cuenta que la búsqueda solo mira entre los nodos visibles, así que, si has apagado el tipo al que pertenece, no lo encontrará; vuelve a encender esa pastilla antes de buscar.
Los filtros por tipo son la herramienta para limpiar el ruido. Apaga los tipos que no te interesen para quedarte, por ejemplo, solo con equipos y alarmas, y verás con mucha más claridad qué equipos concentran los avisos. Si te pasas de filtro, el lienzo se queda vacío y la propia pantalla te recuerda que reactives algún tipo.
Al pulsar un nodo se abre su panel de detalle, que es donde el grafo se vuelve operativo: además del tipo y del número de conexiones, lista los vecinos como botones, de forma que se puede recorrer la red saltando de uno a otro sin volver a buscar. Y cuando la entidad corresponde a una pantalla real de la plataforma —un equipo, una variable, una alarma, una tarea o una página de la wiki—, el botón superior lleva directamente hasta ella. Para arrastrar un nodo a un lado y dejarlo fijo mientras exploras, basta con soltarlo donde quieras.
Si sospechas que faltan relaciones recientes, pulsa “Actualizar”: la pantalla no se refresca sola. Si en su lugar aparece un mensaje de error en rojo, el grafo no se ha podido cargar; reintenta con “Actualizar” y, si persiste, avisa al responsable de la plataforma. Y si bajo el lienzo aparece la nota de vista de inspección, recuerda que lo que estás viendo es una muestra —las entidades más conectadas y parte de sus relaciones—, no el grafo completo: los totales reales son los de las etiquetas de la cabecera.
El material que alimenta este mapa se gestiona en las otras dos pestañas del copiloto: la wiki interna en AI Brain y los documentos subidos en Conocimiento IA.