Je AI-medewerker verbeteren
Feedback op reacties
Elk antwoord dat je medewerker geeft, heeft een onopvallende duim omhoog/duim omlaag
eronder in de chatwidget. Beoordelingen komen terecht op de pagina
‘Bezoekersfeedback’
van de medewerker (Kennis › Bezoekersfeedback, voorheen Reactiefeedback) op
/app/agents/{agent}/feedback
, waar een duim omlaag
wordt uitgesplitst naar wat
voor soort
fout het was — en dat is precies wat
je vertelt of je de kennisbank of de crawl moet aanpassen.
Dit is de door bezoekers aangestuurde helft van de zelfverbeteringscyclus. Inhoudslekken vangen de vragen op die je medewerker wist niet te beantwoorden; feedback op reacties vangt de vragen op die hij vol vertrouwen maar verkeerd beantwoordde — de fouten die geen enkele automatische detector kan zien.
Wat de bezoeker ziet
- Onder elk voltooid antwoord van de assistent verschijnen twee grijze duimpjes. Ze verschijnen nooit bij een antwoord dat nog wordt weergegeven, bij een foutmelding of bij een bericht dat door een menselijke medewerker is getypt.
- Een duim omhoog wordt meteen verzonden en verandert in een kort berichtje: „Bedankt voor je feedback!”.
- Een duim omlaag wordt ook meteen verzonden, waarna er een klein formulier opent: vier reden-chips (Niet correct, Niet wat ik vroeg, Onvolledig, Iets anders) plus een optioneel vrij-tekstveld.
De volgorde is belangrijk. De meeste bezoekers haken af bij een feedbackformulier, dus de negatieve beoordeling wordt vastgelegd voordat we vragen waarom — een beoordeling die je hebt, is beter dan een reden die je nooit krijgt. Elke latere interactie (een chip kiezen, een opmerking sturen) werkt hetzelfde record bij in plaats van een nieuw record aan te maken.
Het eindpunt
POST /api/v1/widget/messages/feedback
, geauthenticeerd door
de JWT van de widget, net als elk ander bezoekers-eindpunt, met een limiet van
120 verzoeken per minuut per bezoekerssessie.
{
"message_id": "0198e4...", // the assistant message being rated
"rating": "negative", // positive | negative
"reason": "incorrect", // optional: incorrect | irrelevant | incomplete | other
"comment": "It only goes to 46.", // optional, max 2000 chars
"page_url": "https://example.com/boston"
}
Het gesprek wordt gelezen uit het ondertekende token, nooit uit
de request body, en het bericht moet bij dat gesprek horen —
dus een bezoeker kan alleen een reactie uit zijn eigen thread beoordelen. Een
onbekende bericht-id levert 404 message_not_found op.
Het zit niet op het hot path. De beoordeling is een apart verzoek; niets in de SSE-stream wacht hierop, en een mislukte POST wordt opgeslokt door de widget in plaats van als fout weergegeven.
Waar de bericht-ID vandaan komt
De start-gebeurtenis van de stream bevat al de
message_id van de server, die vóór het eerste token wordt verzonden. De widget
koppelt deze tijdens het streamen aan de ballon, zodat de feedbackknop een
echte id heeft tegen de tijd dat het antwoord klaar is. Antwoorden die worden hersteld uit
de geschiedenis bij het herladen van de pagina hebben hun id al, dus ook oudere beurten kunnen
worden beoordeeld.
Wat wordt opgeslagen
Eén rij per beoordeeld bericht in message_feedback, beperkt tot
de agent (en dus de werkruimte) en met daarin:
- de beoordeling, de redencategorie en de opmerking van de bezoeker;
- momentopnames van zowel de vraag als het antwoord — het record moet leesbaar blijven nadat het gesprek is opgeschoond, want “precies dit antwoord was fout” heeft geen zin meer zodra de tekst weg is;
- de pagina waar de bezoeker op zat, en de gespreks-id voor de deep link.
message_id
is uniek, dus een bezoeker die van
gedachten verandert, werkt zijn bestaande rij bij in plaats van duplicaten op te stapelen.
De pagina lezen
- Belangrijkste statistieken — totaal aantal beoordelingen, nuttig, niet nuttig, en het percentage negatieve beoordelingen, met de verandering ten opzichte van het vorige venster van dezelfde lengte. Deze staan altijd na het datumvenster en negeren de beoordelings- en redenballonnen, zodat het percentage zinvol blijft terwijl je filtert.
- Waarom bezoekers ontevreden waren — de uitsplitsing per reden en de snelste diagnose op de pagina. Een stijgend 'Niet correct' betekent dat er iets fouts in de kennisbank staat; een stijgend 'Onvolledig' betekent meestal dat een pagina nooit is gecrawld. Klik op een categorie om daarop te filteren.
- De lijst — vraag, antwoord, reden, opmerking en pagina voor elke beoordeling, met de nieuwste bovenaan, maximaal 100 rijen. Standaard worden alleen negatieve beoordelingen getoond, want daar moet aan gewerkt worden.
De cirkel rond maken
Elke negatieve rij biedt de optie Schrijf een samengesteld antwoord, waardoor het formulier voor samengestelde antwoorden van de medewerker wordt geopend met de afgewezen vraag al ingevuld. Sla het op en de volgende bezoeker die die vraag stelt, krijgt het vastgezette antwoord in plaats van de LLM — hetzelfde pad dat ‘Inhoudslekken’ gebruikt om een klacht om te zetten in een oplossing.
Er wordt bewust geen e-mail verstuurd bij elke slechte beoordeling: meldingen over hiaten geven al aan dat er “iets aandacht nodig heeft”, en één melding per duim omlaag zou alleen maar ruis zijn. De pagina is het wekelijkse overzicht.