> 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/assistenten/runs.md).

# Runs en de Cockpit

Het werk dat assistenten zelfstandig doen volgen, controleren en beheren. De **Cockpit** in het hoofdmenu toont de runs van alle assistenten; het tabblad **Runs** van een assistent toont de runs van die assistent.

## Wat een run is

Een run is één klus die een assistent zelfstandig uitvoert, gestart door een [trigger](https://docs.artific.nl/voor-beheerders/assistenten/triggers.md). Omdat er niemand meekijkt terwijl het gebeurt, wordt alles wat een run doet vastgelegd: wat hem gevraagd werd, welke stappen hij zette, wie wat goedkeurde, en wat eruit kwam.

## De Cockpit

De tegels bovenaan tellen de runs die er het meest toe doen:

| Tegel              | Wat hij telt                                            |
| ------------------ | ------------------------------------------------------- |
| **wachten op jou** | Runs die jouw goedkeuring of een antwoord nodig hebben. |
| **mislukt**        | Runs die in de gekozen periode zijn mislukt.            |
| **draaien nu**     | Runs die bezig zijn.                                    |
| **afgerond**       | Runs die in de gekozen periode klaar zijn.              |

Selecteer een tegel om alleen die runs te tonen. Onder de tegels staat elke run met zijn status en tijd, en met de kosten als kosteninformatie voor je organisatie beschikbaar is.

### Een run terugvinden

| Filter        | Mogelijkheden                                                                                      |
| ------------- | -------------------------------------------------------------------------------------------------- |
| **Periode**   | **Vandaag**, **Deze week**, **Deze maand**, **Afgelopen 12 maanden**, of een **Aangepast bereik…** |
| **Assistent** | Eén assistent, of **Alle assistenten**.                                                            |
| **Status**    | Eén status, of **Alle statussen**.                                                                 |
| **Zoeken**    | Vrije tekst, zoals een ordernummer.                                                                |

**Filters wissen** zet ze terug.

### Statussen

| Status                                   | Betekenis                                                          |
| ---------------------------------------- | ------------------------------------------------------------------ |
| **Draait nu**                            | De run is bezig.                                                   |
| **Wacht op jou**                         | De run wacht op goedkeuring of informatie van een mens.            |
| **Gepauzeerd**                           | Iemand heeft de run gepauzeerd. Met **Hervatten** gaat hij verder. |
| **Afgerond**                             | De run is klaar.                                                   |
| **Mislukt**                              | De run is gestopt. De reden staat bij de run.                      |
| **Mislukt: criteria niet gehaald**       | Het resultaat voldeed niet aan de criteria van de trigger.         |
| **Mislukt: criteria niet gecontroleerd** | Het resultaat is niet aan de criteria getoetst.                    |
| **Geannuleerd**                          | Iemand heeft de run gestopt.                                       |

Bij een run die op een mens wacht, staat **Beoordelen**. Als je die opent, kun je meteen goedkeuren, afkeuren of antwoorden, waarna de run verdergaat waar hij gebleven was.

## Acties op een run

Het menu bij elke run biedt:

| Actie                 | Wat het doet                                                                                                                                                                                                |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Opnieuw uitvoeren** | Start een nieuwe poging. Die wordt gemarkeerd als nieuwe poging van de eerdere run.                                                                                                                         |
| **Hervatten**         | Laat een gepauzeerde run verdergaan na de laatste afgeronde stap. Wat al is opgehaald en gewogen, wordt niet opnieuw gedaan. Je kunt een bericht meegeven, zoals *Sla de leverancierscheck deze keer over*. |
| **Stoppen**           | Stopt alleen deze run.                                                                                                                                                                                      |
| **Verwijderen**       | Haalt de run, zijn stappen en zijn antwoord weg.                                                                                                                                                            |

**Stoppen** breekt de lopende actie af en verstuurt verder niets; wat al gedaan is, blijft bewaard. De trigger zelf blijft aan, dus een volgende run start gewoon. Zet de trigger uit als je dat niet wilt.

{% hint style="danger" %}
Een run verwijderen haalt zijn stappen en antwoord definitief weg. Bewaar runs die je later misschien moet kunnen verantwoorden.
{% endhint %}

## In een run

Als je een run opent, zie je:

* **Instructie**: wat de run moest doen.
* **Antwoord**: het resultaat, zodra de run klaar is.
* **Rundetails**: de run-ID, assistent, trigger, status, wanneer hij klaar was, de actieve tijd en de modellen die hij gebruikte.
* **Stappen**: alles wat de run deed, op volgorde.

## Stappen: wat de assistent deed

**Stappen** is het verslag van de run. Het toont op volgorde elke modelaanroep, elke tool die de assistent gebruikte, elke zoekopdracht in de kennisbank, elke toetsing aan de criteria, en elk moment waarop iemand goedkeurde, afkeurde of antwoordde, met wie dat was. Is er een connector gebruikt, dan zie je wiens koppeling. Selecteer een stap voor alle details, ook wat hij kostte.

Zo wordt een run verantwoordbaar. Achteraf kun je altijd nagaan waarom hij tot een resultaat kwam. Dat helpt bij het verbeteren van de opdracht, en als je moet uitleggen wat de assistent heeft gedaan.

**Technische details** exporteert alles wat de run verklaart: wat elke modelaanroep kreeg en teruggaf, welke tools beschikbaar waren, de instellingen van de run, en elk verzoek aan een persoon met het antwoord. Handig als je een melding tot op de bodem uitzoekt.

Dezelfde stap-voor-stapweergave is er ook voor gewone gesprekken, in de [chathistorie](https://docs.artific.nl/voor-beheerders/assistenten/sessie-logs.md) van een assistent.

{% hint style="info" %}
Stappen tonen alles wat een run deed, en zijn daarom alleen beschikbaar voor mensen die er toegang toe hebben gekregen. Zonder die toegang zie je de rest van de run gewoon.
{% endhint %}

## Als een run mislukt

Een mislukte run zegt waarom. De meest voorkomende redenen, en wat je eraan doet:

| Reden                                                                                                              | Wat je doet                                                                                                                                        |
| ------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| tijdslimiet overschreden                                                                                           | Verhoog de tijdslimiet van de trigger, of maak de opdracht kleiner.                                                                                |
| kostenlimiet overschreden                                                                                          | Verhoog de kostenlimiet, of maak de opdracht kleiner.                                                                                              |
| stappenlimiet overschreden                                                                                         | Verhoog het maximaal aantal acties, of maak de opdracht directer.                                                                                  |
| bleef dezelfde aanroep herhalen                                                                                    | Zet in de opdracht wat de assistent moet doen als een tool niet teruggeeft wat hij verwacht.                                                       |
| niemand heeft op tijd geantwoord                                                                                   | Een verzoek is onbeantwoord verlopen. Controleer wie de notificaties krijgt.                                                                       |
| het organisatiebudget was bereikt, of het budget van de assistent was bereikt                                      | Zie [Budgetten](https://docs.artific.nl/voor-beheerders/organisatie/budgetten.md).                                                                 |
| het dienstaccount bestaat niet meer of is uitgeschakeld, of het serviceaccount heeft geen toegang tot de assistent | Controleer **Werkt als** bij de trigger.                                                                                                           |
| het resultaat eindigt met een vraag die niemand kon beantwoorden                                                   | De assistent stelde zijn vraag in het resultaat in plaats van aan een persoon. Voer de run opnieuw uit, of zet in de opdracht hoe hij moet kiezen. |
| het resultaat voldeed niet aan zijn criteria                                                                       | Lees het antwoord en de stappen. Óf de opdracht óf de criteria moeten beter.                                                                       |
| gestopt na te veel toolfouten                                                                                      | Controleer de tool of connector die de run gebruikt.                                                                                               |
| gestopt door een persoon                                                                                           | Iemand koos **Stoppen**.                                                                                                                           |

## Wie wat ziet

| Scherm                              | Wie                                          |
| ----------------------------------- | -------------------------------------------- |
| **Cockpit** en het tabblad **Runs** | Mensen met rechten om runs te bekijken.      |
| **Stappen** in een run              | Mensen die daar toegang toe hebben gekregen. |
| Het tabblad **Triggers**            | Mensen die de assistent mogen bewerken.      |

Rechten komen, zoals overal in het platform, uit gebruikersgroepen. Zie [Rollen en rechten](https://docs.artific.nl/voor-beheerders/toegang/rollen.md).

## Runs in de gaten houden

* **Kijk de eerste weken dagelijks naar mislukte runs** nadat een trigger live is gegaan. Een patroon in de fouten wijst meestal naar één zin in de opdracht.
* **Lees ook de stappen van een paar geslaagde runs.** Een run kan klaar zijn en toch een omweg maken die je liever niet ziet.
* **Laat verzoeken niet oplopen.** Een run die op een mens wacht, houdt zijn eigen werk op, en een onbeantwoord verzoek verloopt uiteindelijk.
