Netzwerkgraph

Der Netzwerkgraph unter app.jamjet.dev/projects/<id>/graph ist eine Echtzeit-Canvas, die zeigt, wie Agenten in Ihrem System miteinander verbunden sind. Er beantwortet Fragen, die Logs nicht beantworten können: welcher Agent an welchen anderen Agent übergeben hat, wie viele Hops eine Anfrage durchlaufen hat, wo in der Kette eine Policy einen Tool-Aufruf blockiert hat und welche Agenten am stärksten vernetzt sind.

Graph lesen

Jeder Knoten auf der Canvas repräsentiert einen benannten Agenten — eine eindeutige Identität, die Sie mit agent() deklarieren. Jede Kante repräsentiert eine Interaktion: einen Tool-Aufruf von einem Agenten zu einem anderen, einen Span, der emittiert wurde, während ein Agent im Scope eines anderen lief, oder eine explizite Übergabe in einem Multi-Agenten-Workflow.

Die Knotengröße skaliert mit dem Span-Volumen. Dickere Kanten bedeuten mehr Interaktionen zwischen diesen beiden Agenten im ausgewählten Zeitfenster. Ein Knoten ohne ausgehende Kanten ist ein Blatt-Agent — er konsumiert Kontext, delegiert aber nicht weiter.

Durch Klicken auf einen Knoten öffnet sich das Agenten-Detailpanel: eine chronologische Liste aller Spans, die dieser Agent im aktuellen Zeitfenster emittiert hat, mit Kosten, Modell, Latenz und Policy-Ergebnis für jeden Span. Durch Klicken auf eine Kante öffnet sich das Kanten-Detailpanel: die Teilmenge der Spans, die diese spezifische Agent-zu-Agent-Grenze überschritten haben, sortiert nach Zeit.

Zeitbereichs-Scoping

Der Zeitbereichs-Picker oben rechts im Graphen steuert, welche Spans einbezogen werden. Verfügbare Fenster:

• Letzte Stunde — Standard. Nützlich während aktiver Entwicklung oder Incident-Triage.
• Letzte 24 Stunden — breiter Überblick über den Traffic eines einzelnen Tages.
• Letzte 7 Tage — Architektur-Review und längerfristige Incident-Analyse.
• Benutzerdefinierter Bereich — wählen Sie beliebige Start- und Endzeiten. Der Graph wird für dieses Fenster neu berechnet.

Das Eingrenzen des Zeitbereichs ist der effektivste Weg, einen Incident zu isolieren: setzen Sie das Fenster auf das exakte Intervall, in dem anomales Verhalten auftrat, und prüfen Sie dann, welche Agenten aktiv waren und welche Kanten heiß liefen.

Filter

Drei Filtersteuerungen befinden sich oberhalb des Canvas:

• Agent-Filter — zeigt nur die ausgewählten Agenten und ihre direkten Nachbarn an. Nützlich, wenn viele Agenten vorhanden sind und man sich auf eine Service-Grenze konzentrieren möchte.
• Nutzer-Filter — zeigt nur die Call-Chains an, die einen bestimmten Endnutzer bedient haben. Setzt voraus, dass der User Context durch das SDK gesetzt wurde. Wenn ein Nutzer-Filter aktiv ist, werden Kanten und Knoten, die von keinem Span dieses Nutzers berührt wurden, ausgegraut.
• Environment-Filter — wenn Spans mit environment über Process Context getaggt werden, lässt sich der Graph auf production, staging oder einen anderen verwendeten Wert beschränken.

Filter lassen sich kombinieren: Es ist möglich, gleichzeitig Nutzer u_123 in der production-Umgebung über die letzten 24 Stunden anzuzeigen.

Coordinator-Scoring-Annotationen

Wenn die Call-Chain einen JamJet Open-Source Coordinator Node enthält, rendert das Dashboard zusätzliche Annotationen auf den Kanten, die durch ihn verlaufen. Diese Annotationen zeigen das Scoring-Delta, das der Coordinator beim Auswählen des nachgelagerten Agenten berechnet hat — die numerische Differenz zwischen dem bestplatzierten Agenten und der nächsten Alternative.

Ein großes Delta signalisiert, dass der Coordinator hohe Zuversicht in seiner Routing-Entscheidung hatte. Ein kleines Delta bedeutet, dass die Wahl knapp war — lohnenswert zu prüfen, falls der nachgelagerte Agent unterdurchschnittlich performt hat. Die Annotationen sind nur sichtbar, wenn der Coordinator strukturierte Scoring-Spans ausgibt; rein heuristisches Routing erzeugt sie nicht.