HTTP-s végponttal kérdezhető le a felhasználói visszajelzés a Mastrában
A Mastra új Feedback API-végpontot vezetett be, amellyel HTTP-lekérdezésekkel szűrhetők és értékelhetők az emberektől származó visszajelzések. A megoldás régió, környezet, szál, forrás, nyomkövetés, entitás és kísérlet alapján is képes finomhangolt lekérdezésekre.
- A Mastra új Feedback API-végpontja emberi visszajelzések lekérdezését támogatja.
- A lekérdezések többek között környezet, trace, entitás és kísérlet szerint szűrhetők.
- Az API nyelvfüggetlen, a TypeScript API az @mastra/[email protected] verzióban jelent meg.
- Az OLAP-végpontok átlagokat, csoportosításokat, idősorokat és percentiliseket kezelnek.
- Az HTTP API jelenleg csak olvasási műveletekre használható.
Lekérdezhetővé váltak az emberi értékelések
A Mastra szeptember 18-i bejelentése szerint a Feedback API az ügynökök valós környezetben nyújtott teljesítményének vizsgálatához használható. Az emberi visszajelzés többféle formában érkezhet, például tetszik vagy nem tetszik jelzésként, csillagos értékelésként vagy részletes szöveges megjegyzésként.
Az új végpont szabványos HTTP-végpontokat és lekérdezési paramétereket használ. A lekérdezések egyetlen szűrőt is alkalmazhatnak, de több feltétel kombinálásával részletesebb eredményeket lehet kérni. Szűrhető többek között a környezet, a szolgáltatás neve, a beszélgetési szál, a felhasználó vagy munkamenet azonosítója, valamint a trace és a futtatás azonosítója.
Nyelvfüggetlen HTTP API és TypeScript-támogatás
A Feedback API nyelvfüggetlen, ezért más szolgáltatásokból is meghívható. A TypeScript API az @mastra/[email protected] kiadásban jelent meg, a hozzá kapcsolódó pull request száma #14842.
A használathoz minden kérésben szükség van egy régióhoz tartozó végpontra és egy projektazonosítóra, továbbá két fejlécet kell megadni. Ezek közül az egyik a Mastra platform hozzáférési tokenje, a másik az X-Mastra-Project-Id fejléc. A platform jelenleg két régiót támogat: az európai végpont a https://observability.eu.mastra.ai/api/observability, az egyesült államokbeli pedig a https://observability.mastra.ai/api/observability.
A megoldás jelenleg csak olvasási műveleteket támogat. Új visszajelzések létrehozásához, a felülvizsgálati állapot módosításához és törléshez továbbra is a TypeScript API használható.
Átlagok, bontások és idősoros elemzés
A Feedback API az alapvető listázás mellett OLAP-lekérdezéseket is kínál. Ezek POST-kérések, amelyek JSON-törzsében egy szűrőobjektum és az adott művelet paraméterei szerepelnek. Az aggregálás az átlag, összeg, minimum, maximum vagy elemszám kiszámítását támogatja.
Egy production környezetből származó, felhasználói ratingek átlagát például az avg aggregációval lehet lekérni. A Breakdown művelet az eredményeket egy vagy több szempont szerint csoportosítja, például a visszajelzés forrása, típusa, az entitás neve vagy a környezet alapján.
A Timeseries végpont időbeli bontást ad, így a ratingek napi, órás, 15 perces, 5 perces vagy 1 perces intervallumokban vizsgálhatók. A Percentiles művelet a p50, p90, p95 és p99 értékek lekérésére szolgál, szintén választható időintervallummal.
A bejelentés a fejlesztők számára olyan HTTP-alapú hozzáférést ad a visszajelzésekhez, amelyből különböző szolgáltatásokkal és elemzési folyamatokkal is lekérdezhetővé válik az ügynökök értékelése. A Mastra a teljes konfigurációhoz a Feedback API HTTP-útvonalainak, a típustárnak és a visszajelzési szűrők dokumentációjának használatát javasolja.
