Skip to content

Door een nieuwe poging draaide dezelfde stap twee keer

Een time-out, een opnieuw afgeleverde webhook of een uitgeschakelde planning kan dezelfde stap twee keer uitvoeren. Zes controles tegen dubbele runs.

Een time-out vertelt de aanroepende partij maar één ding: er kwam niet op tijd een antwoord. De time-out zegt niet of het werk al is uitgevoerd.

De meeste partijen die een aanvraag versturen, doen vervolgens wat logisch lijkt: ze proberen het opnieuw. Maar als de eerste aanvraag wel is verwerkt, wordt dezelfde stap een tweede keer uitgevoerd. Een klant ontvangt twee e-mails, het CRM krijgt twee records of een betaalde modelaanroep wordt twee keer uitgevoerd. De extra run eindigt meestal met een normale status, omdat er binnen de workflow niets is misgegaan.

Een tweede run kan op verschillende manieren ontstaan: de aanroepende partij probeert het opnieuw, een webhook wordt twee keer afgeleverd of een uitgeschakelde planning wordt toch uitgevoerd. Drie meldingen uit augustus en september 2026 laten zien hoe dat kan gebeuren.

Drie manieren waarop een stap twee keer werd uitgevoerd

De aanroepende partij gaf het op en probeerde het opnieuw. Een gebruiker van de gehoste dienst van een workflowleverancier meldde in augustus 2026 op het communityforum van die leverancier dat een chatassistent een van diens workflows als tool aanriep. De workflow riep een betaald model aan, duurde ongeveer drie minuten en eindigde met de status Success. Na ongeveer 125 seconden kreeg de chatassistent echter een foutmelding. Meteen daarna startte een tweede run met dezelfde invoer. Beide runs gebruikten ongeveer evenveel tokens. De gebruiker stopte met testen, omdat de aanroep geld kostte en één goedgekeurde actie niet twee keer mocht worden uitgevoerd. Een moderator van het forum antwoordde dat de tijdslimiet was ingesteld bij de aanroepende client, die de aanvraag opnieuw had verstuurd. De moderator stelde voor om direct een ID terug te geven en het resultaat met een tweede aanroep op te halen. Een andere gebruiker stelde voor om een controle uit te voeren op basis van een hash van de invoer. De melder wilde beide oplossingen testen.

Eén formulier, twee records in het CRM. Een team met een eigen server vroeg in september 2026 op hetzelfde forum hoe het ervoor kon zorgen dat één toolaanroep maar één keer werd uitgevoerd. De tool stuurde aanvragen naar externe systemen waarbij herhaalde acties niet veilig zijn. Eén formulierinzending had eerder al eens twee records in het CRM aangemaakt. Het team had tijdelijk een kleine beveiliging gebouwd. De reacties kwamen uit op één ontwerp: de aanroepende partij stuurt bij elke actie een unieke sleutel mee, en het ontvangende systeem controleert die sleutel voordat het gegevens opslaat. Eén reageerder beschreef een kleine registratietabel (ledger) vóór het doelsysteem. Die tabel bevat het ID van de aanroep, een hash van de invoer, de status en het ID van het aangemaakte record. Dezelfde reageerder adviseerde om het time-outtraject afzonderlijk te loggen, omdat dubbele acties juist daar onopgemerkt kunnen blijven. De melding werd niet als opgelost gemarkeerd.

Uitgeschakeld, maar de volgende ochtend draaide het toch. Een melder die dezelfde workflowtool op een eigen server gebruikt, opende in september 2026 een issue op de tracker van de tool. Een workflow met een dagelijkse planning was op de eerste dag twee keer uitgevoerd, met 14 seconden ertussen. De melder schakelde de workflow uit. Toch werd deze de volgende ochtend opnieuw uitgevoerd. De workflow maakte een productietoegangstoken aan en las een gedeelde spreadsheet. Er werden geen gegevens geschreven, uitsluitend omdat er die dag geen werk was. Ook archiveren stopte de planning niet. De workflow verwijderen was de enige manier waarop de melder de uitvoering kon stoppen. Elke run toonde de status Success. De melder ontdekte het probleem door de runs via de API op te halen en de uitvoeringstijden te vergelijken met het moment waarop de workflow was uitgeschakeld. Eind september had nog geen maintainer het probleem bevestigd. Een andere gebruiker die de actuele broncode had bekeken, meldde dat er nieuwe beveiligingen waren toegevoegd, maar kon die nog niet koppelen aan het specifieke scenario van de melder.

De status laat het niet zien

In de eerste en derde melding had elke run de status Success. In de tweede melding ontdekte het team de dubbele registratie in het CRM. In geen van de gevallen bleek uit de runstatus zelf dat er een extra uitvoering had plaatsgevonden. Het probleem werd zichtbaar in een extern systeem, in de kosten van een test of door uitvoeringstijden handmatig met elkaar te vergelijken.

De nuttige vraag is dus niet: "Is de run mislukt?" De vraag is: "Kan deze stap twee keer worden uitgevoerd, en wat voorkomt dat?"

Zes controles om te voorkomen dat een stap twee keer wordt uitgevoerd

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

1. Zoek uit wie beslist om een mislukte aanroep opnieuw te proberen

Een mislukte toolaanroep of een toolaanroep met een time-out kan opnieuw worden geprobeerd door het platform, het model of de aanroepende partij. Het is ook mogelijk dat niemand een nieuwe poging doet. Elke situatie brengt een ander risico op dubbele schrijfacties met zich mee.

Stuur bij elke tool die buiten de workflow iets wijzigt een idempotency key (idempotentiesleutel) mee. Dit is een unieke ID voor één actie. Het ontvangende systeem gebruikt deze sleutel om een tweede uitvoering van dezelfde actie te weigeren. Kan het ontvangende systeem de sleutel niet controleren, plaats er dan een kleine registratietabel vóór, zoals in de tweede melding.

In EpicStaff: Een mislukte toolaanroep of een toolaanroep met een time-out wordt als foutmelding teruggestuurd naar het model. Het model kan de tool vervolgens opnieuw aanroepen, tot het budget voor toolaanroepen van de agent is bereikt of de limiet voor opeenvolgende mislukkingen is bereikt.

2. Controleer wat de trigger doet wanneer een gebeurtenis opnieuw wordt afgeleverd

Veel afzenders van webhooks leveren dezelfde gebeurtenis opnieuw af wanneer ze niet op tijd een antwoord ontvangen. Controleer of uw trigger een herhaalde aflevering negeert of er een nieuwe run voor start.

Start de trigger een nieuwe run, dan moet de controle op dubbele gebeurtenissen onderdeel zijn van uw workflow. Sla in de eerste stap het ID van de gebeurtenis of een hash van de invoer op. Beëindig de run als dat ID al eerder is geregistreerd. Lees meer over wie de koppeling tussen een AI agent en uw systemen beheert.

In EpicStaff: Een webhooktrigger antwoordt de aanroepende partij direct en start voor elke aflevering een nieuwe run. De controle op herhaalde afleveringen moet daarom een stap in uw workflow zijn.

3. Controleer wat er na een crash gebeurt met een run die nog niet is afgerond

Een server kan midden in een run stoppen. Wanneer de server weer beschikbaar is, kan het platform de run hervatten, opnieuw vanaf het begin starten of gestopt laten. Bij een nieuwe start worden alle stappen die al gegevens hebben weggeschreven opnieuw uitgevoerd.

Breng na elke herstart eerst de runs in kaart die niet zijn afgerond. Controleer vervolgens in de externe systemen welke acties deze runs al hebben uitgevoerd, voordat u een run opnieuw start. Wat een herstart achterlaat, leest u in De server valt een keertje uit. Wat telt, is wat er behouden blijft.

In EpicStaff: Na een crash of herstart blijft een run die nog niet was afgerond gestopt. Afgeronde stappen worden niet opnieuw uitgevoerd. De run krijgt later de status "Expired".

4. Controleer wat er precies wordt gestopt

Een stopknop beëindigt een run. Controleer wat er gebeurt met de stap die op dat moment wordt uitgevoerd: wordt die afgebroken of mag die doorgaan? Controleer na een stopopdracht of time-out of de stap mogelijk toch is afgerond, voordat u deze opnieuw uitvoert. Limieten die een run stoppen terwijl die nog loopt, leest u in Wie stopt de lus? Limieten die werken tijdens de run.

In EpicStaff: Een gebruiker kan een run stoppen via de UI of de API. De stopopdracht onderbreekt geen modelaanroep of toolaanroep die al wordt uitgevoerd. Die aanroep wordt afgerond, maar het resultaat wordt genegeerd. De run start daarna geen nieuwe aanroep of stap meer.

Een stap die al wordt uitgevoerd, wordt niet onderbroken. Deze loopt op de achtergrond door totdat de uitvoering is afgerond of de eigen limiet van de stap is bereikt. Voor een Python-stap is die limiet standaard 5 minuten.

5. Controleer wat er achterblijft wanneer u een planning uitschakelt

Het uitschakelen van een planning voorkomt dat nieuwe geplande triggers een run starten. Controleer wat er gebeurt met een run die al is aangemaakt of in een wachtrij staat. Zoek na het uitschakelen van de planning naar runs die nog wachten en stop deze. Vergelijk de volgende dag de starttijden van nieuwe runs met het tijdstip waarop u de planning hebt uitgeschakeld, zoals de melder in de derde melding deed.

In EpicStaff: Wanneer een planning wordt uitgeschakeld, start een triggergebeurtenis die de server daarna bereikt geen nieuwe run. Een run die al was aangemaakt of in de wachtrij stond, wordt nog wel uitgevoerd.

6. Zorg ervoor dat dubbele aanroepen zichtbaar zijn

Een dubbele aanroep die niet in het runverslag staat, ontdekt u mogelijk pas later in het externe systeem. Het runverslag moet elke toolaanroep afzonderlijk tonen, inclusief de naam en de invoer. Zo zijn twee identieke aanroepen ook als twee afzonderlijke vermeldingen zichtbaar.

Test dit bewust. Verstuur dezelfde gebeurtenis twee keer, laat een trage tool één keer een time-out veroorzaken en controleer of beide aanroepen in het runverslag staan. Lees ook De AI agent is klaar. Niemand kan zeggen wat hij deed. voor meer informatie over wat een runverslag moet bevatten. Meer over hoe u AI-agentworkflows test.

In EpicStaff: Elke toolaanroep krijgt een eigen vermelding in het runverslag, met de naam van de tool en de invoer. Lange invoer wordt ingekort. Twee identieke aanroepen verschijnen daardoor als twee afzonderlijke vermeldingen.

Stel één vraag bij elke stap die gegevens wegschrijft

Loop uw workflow na en markeer elke stap die buiten de workflow iets wijzigt, zoals een record, een e-mail, een betaling of een betaalde modelaanroep. Beantwoord voor elke stap één vraag: wat gebeurt er als deze stap twee keer wordt uitgevoerd, en wie merkt dat?

Is het antwoord "er ontstaat een dubbele actie en niemand merkt het", dan heeft de stap vóór de livegang een idempotentiesleutel, een ontdubbelstap of een controle na een time-out nodig.

Is het antwoord "er gebeurt niets, omdat de tweede schrijfactie de eerste vervangt", leg dat dan ook vast. Zo is duidelijk waarom de stap veilig is. Ook de volgende persoon die de stap wijzigt, moet die reden kennen.

Vragen & Antwoorden

Waarom wordt mijn webhook-workflow twee keer uitgevoerd?

Meestal komt dat doordat de afzender dezelfde gebeurtenis twee keer heeft afgeleverd. Veel afzenders proberen het opnieuw wanneer ze binnen hun eigen tijdslimiet geen antwoord ontvangen of wanneer de verbinding wordt verbroken. Vergelijk de twee runs. Zijn de invoergegevens hetzelfde en liggen de starttijden slechts enkele seconden of minuten uit elkaar, dan gaat het waarschijnlijk om een herhaalde aflevering. Geef de afzender snel antwoord en voeg een eerste stap toe die het ID van de gebeurtenis opslaat. Beëindig elke run waarvan het ID al eerder is geregistreerd.

Is het veilig om een stap opnieuw te proberen die een e-mail verstuurt of een betaling uitvoert?

Alleen als het ontvangende systeem kan herkennen dat het tweede verzoek een duplicaat is. Controleer of het systeem een idempotency key (idempotentiesleutel) ondersteunt en stuur bij elk verzoek een unieke sleutel mee. Zonder zo'n sleutel kan een nieuwe poging na een time-out een tweede e-mail of betaling veroorzaken. Het eerste verzoek kan namelijk al zijn verwerkt, ook al kwam er geen antwoord terug. Controleer daarom eerst hoe het ontvangende systeem met herhaalde verzoeken omgaat. Beslis daarna of u de actie opnieuw kunt proberen.

Hoe maak ik een toolaanroep van een AI agent idempotent?

Geef elke actie een eigen ID voordat de tool wordt aangeroepen en stuur die ID mee naar het ontvangende systeem. Het ontvangende systeem, of een kleine registratietabel ervoor, slaat de ID samen met het resultaat op en weigert een tweede schrijfactie met dezelfde ID. Als de invoer zelf uniek is, kan een hash van die invoer als ID dienen. Registreer ook elke geweigerde dubbele actie, zodat u kunt zien hoe vaak dit voorkomt.

Probeert EpicStaff een mislukte toolaanroep automatisch opnieuw?

Een mislukte toolaanroep of een toolaanroep met een time-out wordt als foutmelding teruggestuurd naar het model. Het model kan de tool vervolgens opnieuw aanroepen, tot het budget voor toolaanroepen van de agent is bereikt of de limiet voor opeenvolgende mislukkingen is bereikt. Elke toolaanroep krijgt een eigen vermelding in het runverslag, met de naam van de tool en de invoer. Lange invoer wordt ingekort, zodat twee identieke aanroepen als twee afzonderlijke vermeldingen verschijnen. Geeft een tool gegevens door aan een extern systeem, stuur dan een idempotency key (idempotentiesleutel) mee. Zo kan het ontvangende systeem een tweede exemplaar van dezelfde actie weigeren.

Keep reading