Thread View érkezett a Mastra megfigyelési felületére
A Mastra Studio új Thread View nézete az ügynökök beszélgetéseit a létrehozásukhoz vezető lépésekkel és eszközhívásokkal együtt mutatja meg. A fejlesztők így az egyes üzenetektől indulva vizsgálhatják meg, mi történt a háttérben.
- A Thread View az ügynökbeszélgetéseket a nyomkövetési lépésekkel együtt jeleníti meg.
- A teljes beszélgetés időrendi sorrendben is megnyitható.
- Az üzenetekhez tartozó lépések a Highlight spans paranccsal emelhetők ki.
- Meglévő memóriával és MastraStorageExporterrel nincs szükség további beállításra.
- A funkcióhoz legalább a [email protected] verzió szükséges.
A beszélgetés kerül a hibakeresés középpontjába
A Mastra október 12-én bemutatott Thread View funkciójával az ügynök nyomkövetései (trace) mellett az üzenetek is megjelennek a Mastra Studio felületén. Egy ügynök nyomkövetését megnyitva láthatóvá válik, milyen üzenetek kapcsolódnak az egyes lépésekhez, a teljes szál megnyitásával pedig a beszélgetés időrendi sorrendben tekinthető át.
A Mastra szerint egy ügynök működésének vizsgálatakor fontos követni, mit kérdezett a felhasználó, milyen döntést hozott az ügynök, és mely eszközöket hívta meg. Egy hosszabb futás során akár több tucat üzenet is létrejöhet, ezért nehezebb megtalálni azt a lépést, amely a problémához vezetett.
Az üzenetektől lehet eljutni a háttérlépésekhez
Az ügynökök tevékenységét általában egymásba ágyazott lépésekből, modellhívásokból és időbélyegekből álló fa ábrázolja. A Mastra közlése szerint ez a nézet pontos, de az értelmezéséhez a felhasználónak magának kell rekonstruálnia a beszélgetést.
A Thread View megfordítja ezt a folyamatot. A vizsgálat a beszélgetés üzeneteivel kezdődik, és amikor valamelyik elem problémásnak tűnik, a felhasználó megnyithatja a mögötte lévő lépéseket. A Studio felületén egy üzenet fölé húzva az egeret elérhető a Highlight spans lehetőség, amely kiemeli az adott üzenethez tartozó lépéseket, miközben a fa többi része elhalványul. Az Open full thread paranccsal a teljes beszélgetés nyitható meg.
A funkciót olyan szakterületi szakértők is használhatják, akik nem vettek részt az ügynök létrehozásában, de át szeretnék tekinteni a működését.
Meglévő tárolt nyomkövetésekkel is működik
Ha az ügynök már használ memóriát, és a nyomkövetéseket a MastraStorageExporter segítségével menti, nincs szükség további beállításra. A Thread View a meglévő tárolt nyomkövetésekkel is működik, és azoknál az ügynök-nyomkövetéseknél jelenik meg, amelyek egy beszélgetési szálhoz tartoznak.
A nulláról induló projektekhez a Mastra az observability, a memory és a storage csomagok telepítését írja elő. A dokumentációban szereplő parancs a következő:
npm install mastra@latest @mastra/core @mastra/observability @mastra/memory @mastra/libsql
A funkció használatához a forrás szerint legalább a [email protected] verzió szükséges, a Thread View a #25812 számú pull requestben került be.
Minden hívás külön fordulóként jelenik meg
A beállítás után az ügynököt egy szál- és egy erőforrás-azonosítóval kell meghívni. A Mastra példája a thread-123 szálat és a user-456 erőforrást használja. A leírás szerint minden hívás a szál egy fordulója, a Studio felületén pedig egy nyomkövetésként jelenik meg.
A használathoz a fejlesztő elindíthatja a mastra dev parancsot, majd a Studio Traces részében kiválaszthat egy ügynökfuttatást. Az adott forduló beszélgetése ekkor a spanfával együtt látható. A Mastra a részletes konfigurációhoz a Studio observability, a Tracing overview és a Memory overview dokumentációkat jelöli meg.
