Consola — Explorar

Vista Explorar de la Consola (http://localhost:8093 en Development). El canvas (librería de grafos en el navegador) pinta un snapshot recalculado de la base viva: no es un grafo persistente. Cada petición a society-telemetry reconstruye nodos y aristas.

Relacionado: índice Consola — Operar · capas de conocimiento Conceptos.

Qué es y qué no es

Sí es	No es
Grafo operacional vivo (hosts, agentes, tasks, chats, RAG, skills…)	Banco de ontología (Ontología → banco de ontología en otra pestaña)
Snapshot recalculado en cada refresh	Grafo del código del repo (code-graph-out/ / grafo compilado del código)
Panel de operación para admins con institution:read	Catálogo RDF/SHACL del cliente

El vocabulario del grafo vivo está cerrado. ci-check corre tools/check_vocabulario_del_grafo.py y tools/check_shacl.py (pyshacl, inference=none). Un tipo emitido y no declarado falla CI.

Prerrequisitos

Requisito	Qué comprobar	Si falla
Stack R6	curl -sf http://localhost:8093/healthz → 200	make up
Auth proveedor de identidad (OIDC)	Abrir http://localhost:8093 (localhost, no 127.0.0.1)	Redirect URI en proveedor de identidad (OIDC)
Rol / scope	Ves Explorar arriba y el grafo carga (sin banner 401)	Rol con institution:read
Institución con datos	Contadores del canvas > 0 (p. ej. LDTeam provisionada)	Catálogo + Provisionamiento

Backend del snapshot: society-telemetry (:8091), proxy vía Consola en /api/telemetry/….

Entrar en Explorar

1. Abre http://localhost:8093 y autentica con proveedor de identidad (OIDC) (Iniciar sesión si la landing lo pide).
2. Arriba, entre Ontología y Operar, pulsa Explorar.
3. (Opcional) ES / EN arriba a la derecha — la guía usa capturas en ES.

La barra superior del canvas resume contadores por familia (hosts, agents, tasks, chats, rag, …) y la hora del último snapshot.

Panel izquierdo — pestaña Control

Selector de vista del grafo

El desplegable Global Graph cambia el recorte del snapshot (GRAPH_VIEW_OPTIONS):

Valor interno	Etiqueta UI	Qué muestra
global	Global Graph	Todo el snapshot: hosts, agentes, chats, tasks, artifacts y memoria visible
runtime	Runtime Graph	Canvas de ejecución: chats, goals, tasks, runs, artifacts y participantes conectados
inventory	Society Inventory	Sociedad en reposo: hosts, agentes, RAG, sesiones y capacidades base
agent-knowledge	Agent Knowledge	Identidad/conocimiento por profile; no incluye chat threads
society-knowledge	Society Knowledge	Grafo global de conocimiento sanitizado (perfiles, SOUL, memoria, RAG, skills)
chat-threads	Chat Threads	Conversaciones, turnos, humanos, agentes y candidatos a goal

Federated (próximamente): opción deshabilitada en el selector; hoy el snapshot es por institución activa.

Explorar por niveles (drill-down)

El grafo llega plegado a sus raíces:

1. Doble clic en un nodo → expande o colapsa lo que cuelga de él; el badge +N indica hijos sin abrir.
2. Expandir todo / Colapsar todo — atajos masivos.
3. Sueltos (N) — muestra nodos sin arista al componente principal.
4. Contador «N nodos sin mostrar» — drill-down activo u ocultos por filtros.

Filtros y búsqueda

Control	Efecto
Refresh	Recarga manual del snapshot
Poll 3s	Auto-refresh cada 3 segundos
Buscar	Filtra por profile, task, artifact…
Live + histórico / Solo live / Solo histórico	Filtra aristas por temporalidad
Goals / Tasks	Acota a un goal o task concreta
Ventana temporal	Últimos 15 min … última semana
Top K	Top 25/50/100 nodos por actividad
Tipos de nodo / arista / status	Checkboxes por familia de la taxonomía
Limpiar filtros	Restaura vista por defecto

Panel izquierdo — pestaña Layout

Define cómo se acomoda lo que ya ves (no qué datos entran):

Acción	Uso
Guardar layout / Usar fijado	Persiste posiciones en localStorage del navegador
Recalcular / Reset layout	Vuelve al layout automático
Enfocar nodo / Salir foco	Zoom semántico a un nodo elegido
Clusters	Agrupa por comunidad detectada
Topológico	Jerarquía de ejecución (live)
Organigrama	Árbol organizacional de arriba abajo
Replay temporal	Reconstruye el grafo por rango de timestamps (barra de reproducción)

Canvas y etiquetas

• Zoom — controles + / − abajo-derecha del canvas; rueda del ratón.
• Centrar (fit) — icono de encuadre junto al zoom.
• Humano / Técnico — alterna etiquetas legibles vs ids técnicos en los nodos.

Inspector (panel derecho)

1. Clic en un nodo o arista del canvas.
2. El panel Inspector muestra kind, type, status, id, enlace SOUL (Raw) si aplica, y metadatos.

En la captura anterior el grafo ya está cargado (contadores Nodes / Edges / Live arriba); tras clic en un nodo, el bloque SELECTION muestra kind, type, status, id y enlace SOUL (Raw) si aplica.

Lente causal

Con un nodo seleccionado en Explorar, puedes activar la lente causal (banner sobre el canvas):

• Dirección atrás / adelante / ambas respecto al nodo raíz.
• Salir restaura el snapshot completo.

Útil para trazar dependencias (p. ej. task → assignee → host).

Copilot integrado

La burbuja teal abajo-derecha abre el copilot de Consola (misma sesión proveedor de identidad (OIDC)). Lee el snapshot actual y puede navegar a vistas de Operar. Ver Chat — Widget.

Solución de problemas

Síntoma	Causa probable	Qué hacer
Banner 401 Unauthorized / snapshot vacío	Sesión proveedor de identidad (OIDC) caducada o scope institution:read ausente	Cierra sesión, vuelve a entrar por localhost:8093 (no 127.0.0.1)
Grafo vacío (0 nodos)	Institución sin hosts vivos o sin eventos	Provisiona preset (Provisionamiento)
Ontología inerte	Sin dev:write o banco de ontología no desplegada localmente	Ontología
Tipos desconocidos en warnings	Emisor fuera del vocabulario cerrado	Corregir telemetría o ampliar ontología SiS en repo

Regenerar capturas (operadores)

Script interno (credenciales solo por env, nunca en el repo):

cd website
SIS_CAPTURE_EMAIL=... SIS_CAPTURE_PASSWORD=... \
  node scripts/capture-explorar-chat.mjs

Salida: static/img/operar/es/explorar-step-*.png y static/img/chat/es/chat-step-01-copilot-widget.png.