← Zum Glossar

Betrieb, Observability und Produktbegriffe

Trace

Aufzeichnung der Schritte eines Modell- oder Agentenlaufs.

Ein Trace ist die vollständige Aufzeichnung eines Vorgangs, zerlegt in einzelne Abschnitte mit Anfang, Ende und Verschachtelung. In verteilten Systemen zeigt er den Weg einer Anfrage durch mehrere Dienste. OpenTelemetry

Bei Agenten ist der Verlauf die eigentliche Information

Für einen einzelnen Modellaufruf genügt ein Abschnitt mit Prompt, Antwort und Tokenzahlen. Bei einem Agenten mit mehreren Schritten entsteht ein Baum: der Gesamtauftrag, darunter jede Runde, darunter Modellaufrufe und Werkzeugaufrufe mit ihren Ergebnissen. OpenTelemetry: Generative KI

Erst diese Struktur macht Fehlersuche möglich. Die Frage lautet selten „warum war die Antwort falsch", sondern „an welchem Schritt ist es gekippt": beim Abruf der falschen Quelle, beim Werkzeugaufruf mit falschem Argument oder erst bei der Zusammenfassung.

So kannst du dir das vorstellen

Ein Wegeprotokoll mit Zwischenstopps und Zeitangaben statt nur der Endnotiz „angekommen" oder „nicht angekommen". Das Bild erklärt den Wert der Zwischenschritte, es beschreibt kein konkretes Format.

Was es in der Praxis konkret bedeutet

Sorge dafür, dass jeder Lauf eine eindeutige Kennung hat, die auch beim Nutzer ankommt, etwa in einer Fehlermeldung. Dann lässt sich eine Beschwerde direkt dem Verlauf zuordnen, statt in Protokollen zu suchen. Speichere bei Werkzeugaufrufen Argumente und Rückgaben, nicht nur den Namen des Werkzeugs, denn dort stecken die meisten Fehlerursachen.

Wo es verwechselt wird

Ein Trace ist etwas anderes als eine Protokollzeile: Er hat Struktur und Dauer, während Protokolle einzelne Ereignisse festhalten. Und die Gedankenkette eines Modells ist kein Trace, sondern Teil der Ausgabe, die darin aufgezeichnet werden kann.

Verwandte Begriffe

LLM Observability, Trace Analytics, OpenTelemetry, Agent Loop, Tool Calling, Stall Detection.

Quellen