Grafo de Red

El Grafo de Red en app.jamjet.dev/projects/<id>/graph es un lienzo que se actualiza en vivo y muestra cómo se relacionan los agentes en tu sistema. Responde las preguntas que los logs no pueden: qué agente delegó a qué otro agente, cuántos saltos tomó una solicitud, dónde en la cadena una política bloqueó una llamada a herramienta y qué agentes están más conectados.

Leer el grafo

Cada nodo en el lienzo representa un agente nombrado — una identidad distinta que declaras con agent(). Cada arista representa una interacción: una llamada a herramienta de un agente a otro, un span emitido mientras un agente se ejecutaba dentro del alcance de otro, o una delegación explícita en un flujo de trabajo multiagente.

El tamaño del nodo escala con el volumen de spans. Aristas más gruesas significan más interacciones entre esos dos agentes en la ventana de tiempo seleccionada. Un nodo sin aristas salientes es un agente hoja — consume contexto pero no delega más.

Hacer clic en un nodo abre el panel de detalles del agente: una lista cronológica de cada span que ese agente emitió en la ventana de tiempo actual, con costo, modelo, latencia y resultado de política para cada uno. Hacer clic en una arista abre el panel de detalles de arista: el subconjunto de spans que cruzaron ese límite específico agente-a-agente, ordenados por tiempo.

Alcance de rango temporal

El selector de rango temporal en la esquina superior derecha del grafo controla qué spans se incluyen. Ventanas disponibles:

• Última 1 hora — predeterminado. Útil durante desarrollo activo o triaje de incidentes.
• Últimas 24 horas — vista amplia del tráfico de un solo día.
• Últimos 7 días — revisión de arquitectura y análisis de incidentes de mayor duración.
• Rango personalizado — elige cualquier tiempo de inicio y fin. El grafo se recalcula para esa ventana.

Reducir el rango temporal es la forma más efectiva de aislar un incidente: configura la ventana al intervalo exacto donde ocurrió el comportamiento anómalo, luego inspecciona qué agentes estaban activos y qué aristas estaban activas.

Filtros

Tres controles de filtrado están ubicados sobre el lienzo:

• Filtro de agente — muestra únicamente el o los agentes seleccionados y sus vecinos directos. Útil cuando tienes muchos agentes y quieres enfocarte en un límite de servicio específico.
• Filtro de usuario — muestra únicamente las cadenas de llamadas que atendieron a un usuario final específico. Requiere que el SDK configure el Contexto de Usuario. Cuando hay un filtro de usuario activo, los enlaces y nodos no tocados por ningún span atribuido a ese usuario aparecen atenuados.
• Filtro de entorno — si etiquetas spans con environment mediante Contexto de Proceso, puedes restringir el grafo a production, staging o cualquier otro valor que uses.

Los filtros se componen: puedes mostrar al usuario u_123 en el entorno production durante las últimas 24 horas simultáneamente.

Anotaciones de puntuación del coordinador

Cuando tu cadena de llamadas incluye un Nodo Coordinador de código abierto de JamJet, el panel renderiza anotaciones adicionales en los enlaces que fluyen a través de él. Estas anotaciones muestran el delta de puntuación que el coordinador calculó al seleccionar a qué agente descendente delegar — la diferencia numérica entre el agente mejor clasificado y la siguiente alternativa.

Un delta grande indica que el coordinador tenía alta confianza en su decisión de enrutamiento. Un delta pequeño significa que fue una decisión ajustada — vale la pena revisar si el agente descendente tuvo bajo rendimiento. Las anotaciones solo son visibles cuando el coordinador emite spans de puntuación estructurados; el enrutamiento puramente heurístico no los produce.