Skip to content

De agent bereikte zijn limiet en meldde toch dat hij klaar was

Een agent die bij zijn stappen- of toolaanroeplimiet stopt, kan toch een normaal ogend antwoord geven. Zes controles voor runlimieten van AI agents.

Het testrapport toonde nul runs die waren mislukt. Toch was een van die runs bij het bereiken van zijn limiet gestopt, zonder een verklaring te geven.

Agentplatforms stellen limieten in voor runs, bijvoorbeeld voor het aantal stappen, de looptijd, het aantal toolaanroepen en het aantal opeenvolgende mislukkingen. Zo'n limiet stopt een run die anders te lang zou duren of te veel zou kosten. Het moeilijke deel komt daarna: wat geeft de agent terug en wat zegt de runstatus daarover?

Drie meldingen uit 2026 laten zien waar het mis kan gaan.

Drie meldingen over runlimieten

Geen mislukte runs, maar wel een leeg antwoord. Een team dat zijn eigen workflowserver beheert, meldde in september 2026 op de issuetracker van de tool dat het een agent met vier tools had getest aan de hand van 25 vragen, in twee rondes. Er kwamen vijftig antwoorden terug en geen enkele run werd als mislukt gemarkeerd. Toch was één vraag in een lus terechtgekomen: de agent riep het model 25 keer aan met dezelfde prompt. Er werd geen tool uitgevoerd en er kwam geen tekst terug. Toen het team die vraag opnieuw uitvoerde, stopte de run bij de limiet van 25 iteraties (max iterations), zonder een antwoord te geven. De run werd niet als mislukt gemarkeerd. De melder vond de oorzaak in de broncode: door het kopiëren was een toolstap hernoemd. Het model vroeg daardoor om een tool die niet meer bestond. De agent negeerde dat verzoek zonder het in de log vast te leggen. Een tweede gebruiker meldde hetzelfde resultaat. Eind september had nog geen maintainer dit bevestigd.

Niets in de log. Een andere melder beschreef in augustus 2026 een vergelijkbaar patroon op dezelfde issuetracker, eveneens op een zelfgehoste server. De agent had één zoektool en een limiet van 12 iteraties. Na één tot drie toolaanroepen bleef het model om een tool vragen. De agent voerde geen tool uit, voegde niets toe aan het gesprek en stuurde dezelfde prompt opnieuw, totdat de limiet was bereikt. Bij gebruik van een andere modelfamilie vielen in plaats daarvan de meeste modelantwoorden weg. De run werd uiteindelijk wel afgerond, maar daarvoor waren ongeveer vijf keer zoveel modelaanroepen nodig als gebruikelijk. Volgens de melder werd er op geen enkel niveau iets vastgelegd: geen fout en geen waarschuwing. Op het moment dat de pagina werd geraadpleegd, had geen maintainer gereageerd.

Een limiet die nooit ingreep. Een ontwikkelaar beschreef in juni 2026 op een forum een agent met een tool die pdf-bestanden leest. Bij één vraag las de agent hetzelfde document van 200 pagina's meer dan 60 keer. De agent had een limiet van 15 iteraties. Volgens de ontwikkelaar begon de teller bij elke toolaanroep opnieuw bij één. Daardoor greep de limiet nooit in. De ontwikkelaar zag de kosten in ongeveer tien minuten oplopen tot enkele honderden dollars en stopte het script vervolgens handmatig.

Wat de drie meldingen gemeen hebben

In alle drie de meldingen was een limiet ingesteld. In de eerste twee werd die limiet bereikt, maar zag de run er niet uit als een probleem: de ene run werd niet als mislukt gemarkeerd, terwijl de log van de andere geen informatie bevatte. In de derde melding telde de limiet iets anders dan de ontwikkelaar verwachtte. Daardoor greep de limiet helemaal niet in.

Een limiet beschermt uw budget. Hij bewijst niet dat het werk is afgerond. Meer over runs die succes melden zonder dat de taak daadwerkelijk is voltooid, leest u in AI agent of automatisering: een groen vinkje betekent niet dat de taak is afgerond.

Zes controles voor runlimieten van agents

Deze controles gelden voor elk platform waarop agents draaien, dus ook voor EpicStaff. Waar EpicStaff een antwoord heeft, vindt u dat onder de betreffende controle.

1. Breng per agent de limieten in kaart en controleer wat elke limiet telt

Nuttige limieten zijn die voor het aantal stappen, de looptijd, het aantal toolaanroepen, de tijd per toolaanroep en het aantal opeenvolgende mislukkingen. Controleer per limiet wat er precies wordt geteld. Een stap kan één modelaanroep zijn, één toolaanroep of één ronde waarin beide plaatsvinden. Een limiet waarvan de teller tijdens de run opnieuw bij nul begint, zoals in de derde melding, houdt niets tegen.

Limieten die een run stoppen terwijl die nog loopt, leest u in Wie stopt de lus? Limieten die werken tijdens de run.

In EpicStaff: Stel per agent een limiet voor het aantal stappen, een tijdslimiet voor elke taak van de agent, een budget voor toolaanroepen, een time-out per tool en een limiet voor het aantal opeenvolgende mislukkingen in. Het runverslag legt vast welke limiet de run heeft gestopt. U vindt deze vijf velden op het tabblad Execution onder de aanvullende instellingen (additional settings) van de agent.

2. Controleer welke standaardwaarden gelden als u geen limiet instelt

Veel agents gaan live met limieten die niemand bewust heeft ingesteld. Controleer wat de standaardwaarde is wanneer een veld leeg blijft en of die standaardwaarde voor elke agent binnen de installatie hetzelfde is. Bepaal vervolgens per agent of de standaardinstellingen passen bij het werk dat de agent moet uitvoeren.

In EpicStaff: Als een veld leeg is, vult een standaardwaarde voor de hele installatie het vóór elke run in: 25 stappen, 15 toolaanroepen, 300 seconden per toolaanroep en 3 opeenvolgende mislukkingen. Elke agent heeft daarnaast een tijdbudget per taak, standaard 10 minuten. U kunt dit instellen op 1 tot 30 minuten via het tabblad Execution. Wanneer het tijdbudget op is, mislukt de stap en eindigt de run met de status "error".

3. Controleer wat de agent teruggeeft wanneer hij een limiet bereikt

Een platform kan een run bij het bereiken van een limiet beëindigen met een foutmelding, zonder iets terug te geven of met het beste antwoord dat de agent op dat moment kan geven. Dat beste antwoord kan nuttig zijn, omdat een deel van het werk mogelijk al is uitgevoerd. Het kan er echter ook uitzien als een volledig antwoord. Controleer daarom wat uw platform bij elke limiet doet en zorg ervoor dat de volgende stap in uw proces onderscheid kan maken tussen een volledig resultaat en een antwoord dat bij een limiet is gegenereerd.

In EpicStaff: Bereikt de agent zijn budget voor toolaanroepen of zijn limiet voor opeenvolgende mislukkingen, dan vraagt het platform de agent om het beste antwoord te geven dat hij op dat moment kan leveren. Dat antwoord wordt vervolgens de output.

4. Controleer of een run die bij een limiet stopt, eruitziet als een voltooide run

Vergelijk de status van een run die bij het bereiken van een limiet is gestopt met de status van een run die de taak volledig heeft afgerond. Zijn de statussen hetzelfde? Controleer dan ook de reden waarom de run is gestopt (zie controle 5).

In EpicStaff: Een run waarin de agent de limiet voor het aantal stappen, het budget voor toolaanroepen of de limiet voor opeenvolgende mislukkingen bereikt, kan nog steeds normaal eindigen. Bij een time-out van de agent of een fout van het model mislukt de run en krijgt deze een foutstatus. Overschrijdt een run de totale tijdslimiet, dan krijgt deze de status expired.

5. Zoek op waar de reden voor het stoppen wordt vastgelegd

De reden waarom een run is gestopt, maakt het verschil tussen een run die bij een limiet is beëindigd en een run die de taak heeft voltooid. Zoek uit waar uw platform deze reden vastlegt, samen met het aantal stappen en toolaanroepen dat de run heeft gebruikt. Neem die informatie op in uw controles. Wat er verder in een runverslag moet staan, leest u in De AI agent is klaar. Niemand kan zeggen wat hij deed.

In EpicStaff: De reden waarom de run is gestopt, het aantal stappen en het aantal toolaanroepen worden opgeslagen in het eindverslag van de agent en in de sessie-export (JSON). Controleer daar de stopreden en vertrouw niet alleen op de runstatus.

6. Laat de agent vóór de livegang bewust elke limiet bereiken

Maak een kopie van de agent en laat die kopie achtereenvolgens tegen elke limiet aanlopen. Test bijvoorbeeld een taak waarvoor te veel stappen nodig zijn, een tool die steeds mislukt, een trage tool en een taak die te lang duurt. Noteer bij elke test wat de agent teruggeeft, welke status de run krijgt en waar de reden voor het stoppen wordt vastgelegd. Lees ook meer over hoe u AI-agentworkflows test.

Houd bij hoeveel runs op een limiet eindigen

De meeste teams rapporteren over hun agents aan de hand van twee getallen: het aantal geslaagde runs en het aantal mislukte runs. Voeg daar een derde getal aan toe: het aantal runs dat bij het bereiken van een limiet is gestopt. Haal dit getal per agent uit de stopreden en houd het wekelijks bij.

Een paar runs die op een limiet eindigen, is normaal. Daar zijn limieten immers voor bedoeld. Een stijgend aantal kan erop wijzen dat het werk is uitgebreid, dat een tool is veranderd of dat een agent in een lus terechtkomt. In de eerste melding had dit derde getal de ene run zichtbaar gemaakt die niet naar voren kwam in het aantal mislukte runs.

Vragen & Antwoorden

Wat betekent "max iterations reached" bij een AI agent?

Dit betekent dat de agent alle stappen heeft gebruikt die hij mocht uitvoeren voordat de taak was afgerond. Eén iteratie is meestal één modelaanroep, vaak in combinatie met een toolaanroep. De limiet stopt een run die anders in een lus terecht zou komen of te lang zou duren. Controleer wat de agent heeft teruggegeven en zoek uit waarom hij zoveel stappen nodig had. Mogelijke oorzaken zijn een lus, een tool die niet werkt of een taak die meer stappen vereist dan de ingestelde limiet toestaat.

Moet een run van een AI agent die zijn limiet bereikt, als mislukt worden gemarkeerd?

Beide keuzes zijn verdedigbaar. De status "mislukt" maakt zichtbaar dat de run voortijdig is gestopt. De status "geslaagd", in combinatie met het beste antwoord dat de agent kon geven, behoudt het deel van het werk dat al is uitgevoerd. Welke keuze uw platform ook maakt, zorg ervoor dat de reden waarom de run is gestopt, wordt vastgelegd. Laat de volgende stap die reden controleren voordat de output wordt gebruikt.

Hoe kies ik een stappenlimiet voor een AI agent?

Begin met meten. Laat de agent een reeks normale taken uitvoeren en noteer hoeveel stappen elke taak nodig heeft. Stel de limiet iets hoger in dan het hoogste aantal stappen dat een normale run nodig had. Zo voorkomt u dat de limiet normaal werk onderbreekt, terwijl deze wel kan ingrijpen wanneer de agent in een lus terechtkomt. Herhaal de meting wanneer u het model, de tools of de instructies wijzigt. Elk van deze wijzigingen kan namelijk invloed hebben op het aantal stappen dat een taak vereist.

Wat gebeurt er als een EpicStaff-agent een van zijn runlimieten bereikt?

Bereikt de agent zijn budget voor toolaanroepen of zijn limiet voor opeenvolgende mislukkingen, dan vraagt het platform de agent om het beste antwoord te geven dat hij op dat moment kan leveren. Dat antwoord wordt vervolgens de output. Een run waarin de agent de limiet voor het aantal stappen, het budget voor toolaanroepen of de limiet voor opeenvolgende mislukkingen bereikt, kan nog steeds normaal eindigen. Het runverslag legt vast welke limiet de run heeft gestopt. U vindt de reden voor het stoppen in het eindverslag van de agent of in de sessie-export (JSON).

Keep reading