> For the complete documentation index, see [llms.txt](https://docs.artific.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.artific.nl/voor-beheerders/kwaliteitscontrole/runs.md).

# Runs en resultaten

Lezen wat de kwaliteitscontrole heeft gevonden. Te vinden op het tabblad **Testgeschiedenis** van een kwaliteitscontrole.

## De lijst met runs

Elke run verschijnt met de datum, de assistent of het element dat is getest, hoe lang het duurde, de score en de status.

| Status                            | Betekenis                             | Wat te doen                            |
| --------------------------------- | ------------------------------------- | -------------------------------------- |
| **OK**                            | Alles wat verplicht was, is geslaagd. | Niets.                                 |
| **Waarschuwing**                  | Optionele controles zijn mislukt.     | Kijk ernaar en bepaal of het uitmaakt. |
| **Problemen**                     | Verplichte controles zijn mislukt.    | Onderzoek het.                         |
| **Bezig**                         | Loopt nog, met een stappenteller.     | Wachten.                               |
| **In wachtrij**                   | Staat in de wachtrij.                 | Wachten.                               |
| **Geannuleerd** / **Onderbroken** | Niet afgerond.                        | Voer hem opnieuw uit.                  |

## Een run lezen

Open een run om elk scenario te zien, uitklapbaar naar de stappen. Elke stap toont de vraag, het antwoord dat de assistent daadwerkelijk gaf, wat er werd verwacht, en elke controle met de score en de reden erachter.

De vergelijking tussen **Werkelijk antwoord** en **Verwacht** is waar de bruikbare informatie zit. Lees het werkelijke antwoord goed door in plaats van alleen naar geslaagd of mislukt te kijken. Een antwoord kan technisch gezien elke controle doorstaan en toch slecht zijn.

## Als een controle niet kon worden beoordeeld

Sommige uitkomsten zijn geen tekortkoming van de assistent, maar van de test:

| Melding                                             | Wat het betekent                                                                       |
| --------------------------------------------------- | -------------------------------------------------------------------------------------- |
| De assistent gaf geen antwoord                      | Er kwam niets terug. Meestal een probleem met een model of een tool.                   |
| Er is geen responstijd vastgelegd                   | Een tijdcontrole had niets om te meten.                                                |
| Het beoordelingsmodel deed er te lang over          | De beoordelaar liep in een time-out. Voer hem opnieuw uit.                             |
| Het beoordelingsmodel was niet bereikbaar           | Een tijdelijk probleem. Voer hem opnieuw uit.                                          |
| Het beoordelingsmodel is tijdelijk niet beschikbaar | Er is een gebruikslimiet bereikt. Probeer het later.                                   |
| Het beoordelingsmodel gaf geen bruikbaar resultaat  | Voer hem opnieuw uit; blijft het gebeuren, maak de beoordelingsprompt dan eenvoudiger. |

Een stap kan ook zijn **overgeslagen omdat een eerdere stap is mislukt**. Stappen lopen op volgorde, dus één mislukking stopt de rest van dat scenario. Los de eerste mislukking eerst op; de rest is er vaak een gevolg van.

## Van een mislukking naar een oplossing

Werk het in deze volgorde af:

1. **Lees het werkelijke antwoord.** Is het echt verkeerd, of is de controle te streng? Een te strenge controle is de meest voorkomende oorzaak van een rode run, en de oplossing zit in de controle.
2. **Is het antwoord verkeerd, zoek dan uit waarom.**
   * Ontbrekende informatie → de kennisbank is niet compleet of het document is niet goed geïndexeerd. Controleer de status van het document.
   * Verkeerde informatie → er staat nog een achterhaald document in de collectie. Verwijder het.
   * Juiste feiten, verkeerd gedrag → de instructies. Wees specifieker.
   * Er is geen tool gebruikt terwijl dat wel moest → de beschrijving van de tool.
3. **Los het op en voer de test opnieuw uit** om het te bevestigen.
4. **Behoud het scenario.** Het beschermt je nu tegen precies die regressie.

## Het als routine gebruiken

* Zet **Elke dag automatisch uitvoeren** aan voor alles wat ertoe doet.
* Bekijk de resultaten na elke wijziging in instructies, kennis of model.
* Volg de score over langere tijd. Een langzame daling betekent meestal dat de kennisbank veroudert, en niet dat er iets plotselings aan de hand is.
* Gaat een run rood om een reden die je acceptabel vindt, pas de controle dan aan de nieuwe werkelijkheid aan. Bekende mislukkingen laten staan, leert iedereen om de resultaten te negeren.
