Mastra Studio erhält Thread View: Agentengespräche neben den Traces lesen
Mastra hat Mastra Studio um die Thread View erweitert. Entwicklerinnen und Entwickler können damit das Gespräch eines Agenten neben dem Trace lesen, der es erzeugt hat. Laut Mastra lässt sich ein Agenten-Trace öffnen, dessen Nachrichten neben den dahinterliegenden Schritten anzeigen und anschließend der vollständige Thread aufrufen, um das gesamte Gespräch in der richtigen Reihenfolge zu verfolgen.
- Mastra Studio zeigt Agentennachrichten jetzt neben den Trace-Schritten, die sie erzeugt haben.
- Über den vollständigen Thread lässt sich das gesamte Gespräch in der richtigen Reihenfolge ansehen.
- Agenten, die bereits Memory und MastraStorageExporter nutzen, brauchen keine zusätzliche Einrichtung.
- Die Funktion setzt [email protected] oder neuer voraus und erscheint nur bei Traces, die zu einem Thread gehören.
- Wer mit der Maus über eine Nachricht fährt und Highlight spans wählt, blendet den Rest des Span-Baums aus.
Vom Gespräch ausgehen statt vom Baum
Agentenaktivität wird meist als Baum aus verschachtelten Schritten, Modellaufrufen und Zeitstempeln nachverfolgt. Mastra zufolge ist eine Baumansicht zwar präzise, aber schwer zu deuten, weil man das Gespräch erst rekonstruieren muss, um zu verstehen, was passiert ist.
Die Thread View kehrt diesen Ansatz um. Laut Mastra beginnt man bei den Nachrichten und geht erst dann in die dahinterliegenden Schritte, wenn etwas nicht stimmt. Das Unternehmen argumentiert, dass Traces dadurch leichter zu lesen, nachzuvollziehen und zu durchsuchen seien.
Mit der Länge einer Session wächst das Problem. Mastra weist darauf hin, dass eine einzelne Session dutzende Nachrichten umfassen kann, und je länger ein Agent läuft, desto schwieriger wird es, den richtigen Schritt zu finden. Beim Debugging wollen Entwickler nachvollziehen, was der Nutzer gefragt hat, was der Agent entschieden hat und welche Tools er aufgerufen hat. Die Thread View soll es ermöglichen, einen Trace im Kontext des gesamten Gesprächs zu untersuchen.
Mastra nennt außerdem eine zweite Zielgruppe: Fachexperten, die das Verhalten eines Agenten prüfen müssen, ihn aber nicht selbst gebaut haben.
So richten Sie die Funktion ein
Teams, deren Agenten bereits Memory nutzen und Traces mit MastraStorageExporter speichern, brauchen laut Mastra keine zusätzliche Einrichtung. Die Thread View funktioniert mit den bereits gespeicherten Traces.
Für neue Projekte nennt Mastra einen Installationsbefehl für die Pakete mastra@latest, @mastra/core, @mastra/observability, @mastra/memory und @mastra/libsql. Die Funktion setzt [email protected] oder neuer voraus und wurde mit PR #25812 hinzugefügt. Die Thread View erscheint nur bei Agenten-Traces, die zu einem Thread gehören.
Das Beispiel in der Ankündigung umfasst drei Schritte:
- Es definiert einen Agenten mit aktiviertem Memory.
- Es konfiguriert eine Mastra-Instanz mit LibSQL-Storage und einem Observability-Setup, das MastraStorageExporter verwendet.
- Es ruft den Agenten sowohl mit einer Thread- als auch mit einer Ressourcenkennung auf.
Jeder Aufruf wird zu einem Gesprächsbeitrag im Thread und zu einem Trace in Studio.
Die Thread View in Studio nutzen
Nach der Einrichtung starten Entwickler mastra dev, öffnen in Studio den Bereich Traces und wählen einen Agentenlauf aus. Das Gespräch für diesen Durchgang erscheint neben dem Span-Baum.
Fährt man mit der Maus über eine Nachricht und wählt Highlight spans, werden die Schritte hinter dieser Nachricht hervorgehoben, während der Rest des Baums ausgeblendet wird. Mit Open full thread wird das gesamte Gespräch angezeigt.
Für alle Konfigurationsoptionen verweist Mastra auf seine Dokumentation, darunter Seiten zu Studio-Observability, Tracing und Memory.
Was das für Teams bedeutet, die Agenten entwickeln
Für Entwickler, die bereits Traces mit aktiviertem Memory speichern, ist über eine kompatible Mastra-Version hinaus keine neue Konfiguration nötig. Das Debugging kann bei dem beginnen, was Nutzer und Agent tatsächlich gesagt haben, statt bei einem verschachtelten Span-Baum. Da die Funktion an Threads gebunden ist, zeigen Agenten, die ohne Thread aufgerufen werden, sie nicht an.
Der Fokus auf Prüfer, die den Agenten nicht selbst gebaut haben, deutet darauf hin, dass die Funktion auch auf breitere Team-Workflows zielt, in denen Personen, die das Agentenverhalten kontrollieren, mit den Tracing-Interna weniger vertraut sind.
