Hoe schrijf je een testcase in gewoon Engels die een AI-agent kan uitvoeren
By Mirko Peters · · Updated
Schrijf testcases in gewoon Engels die een AI-agent kan uitvoeren: één gedrag per test, één actie per stap, benoemde elementen en een duidelijk, controleerbaar verwacht resultaat.
Automatically translated with AI from the original post. Read the English original
Om testcases in gewoon Engels te schrijven die een AI-agent kan uitvoeren, houd je elke test bij één gedrag, elke stap bij één actie en elke controle bij één resultaat dat je op het scherm kunt zien. Deze gids is bedoeld voor QA-leads en testers die willen overstappen van scripts naar geschreven instructies en toch betrouwbare resultaten willen. Je leert de vijf onderdelen van een testcase, de regels die een stap uitvoerbaar maken, een methode om acceptatiecriteria om te zetten in tests, en een uitgewerkt voorbeeld dat je kunt overnemen.
Belangrijkste punten
- Een testcase in gewoon Engels heeft vijf onderdelen: een titel, voorwaarden vooraf, stappen, een verwacht resultaat en de testdata. Een AI-agent heeft alle vijf nodig, volledig uitgeschreven.
- Schrijf één gedrag per test en één actie per stap, want makers van tools melden dat instructies met één stap het nauwkeurigst worden uitgevoerd.
- Benoem elk element zoals een gebruiker het ziet, bijvoorbeeld de knop Inloggen, in plaats van alleen "de knop" of "het veld".
- Geef elke test een verwacht resultaat dat op het scherm te controleren is, zoals een titel of een bedrag. Schrijf nooit "controleer of het werkt".
- Lees wat de agent heeft gegenereerd voordat je een geslaagde test vertrouwt, en herschrijf elke stap die hij anders heeft geïnterpreteerd dan jij bedoelde.
De vijf onderdelen van een testcase in gewoon Engels
Een goede testcase leest als een kort verhaal dat iedereen in het team kan volgen. Bij softwaretesten is het schrijven van effectieve testcases een kernvaardigheid van QA, en handmatige testers schrijven ze al altijd in gewone taal. Nieuw is dat een AI-agent de teststappen nu kan uitvoeren. Dit is vooral belangrijk voor end-to-end testing, waarbij een test een gebruiker door een volledige workflow in een browser volgt. Voor een AI-agent moet elk onderdeel expliciet zijn, omdat de agent je niet kan vragen wat je bedoelde.
- Titel. Eén regel die het gedrag beschrijft, bijvoorbeeld "Een klant kan een vergeten wachtwoord opnieuw instellen". De titel is het eerste wat een lezer in een rapport ziet.
- Voorwaarden vooraf. De staat waarin het product moet verkeren voordat de test begint, bijvoorbeeld "Er bestaat een klantaccount en de klant is uitgelogd".
- Stappen. Wat een gebruiker doet, één actie per regel.
- Verwacht resultaat. Wat de gebruiker daarna moet zien, in termen die je op het scherm kunt controleren.
- Testdata. De exacte waarden die worden gebruikt, zoals een e-mailadres of een ordernummer.
Een gedeelde sjabloon zorgt ervoor dat de testcases van elke tester dezelfde vorm hebben, en een testsuite met één sjabloon is veel makkelijker na te kijken. Een testcase heeft ook een manier nodig om het resultaat te verifiëren, en daarom is het verwachte resultaat belangrijk.
Dit is dezelfde opbouw die behavior-driven development gebruikt. In de Gherkin-taal, zoals uitgelegd op Automation Panda, zet Given de beginsituatie neer, voert When de actie uit die getest wordt, en beschrijft Then het verwachte resultaat. Je hoeft die trefwoorden niet te gebruiken. De drie rollen blijven wel nuttig.
Regels die een stap uitvoerbaar maken voor een AI-agent
Toolmakers publiceren adviezen voor het schrijven van instructies die een AI-agent kan opvolgen. De documentatie van BrowserStack over hun natuurlijketaaltestagent geeft regels die voor de meeste tools gelden:
- Begin met een actiewoord. "Click the Submit button" is duidelijk. "De submit-knop" is geen instructie.
- Gebruik één intentie per commando. Splits taken met meerdere stappen op in afzonderlijke stappen.
- Noem het specifieke element. Schrijf "the Log In button", niet "the button".
- Scroll eerst als een doel buiten beeld staat. Voeg een stap toe vóór de actie.
Op dezelfde pagina staat dat de betrouwbaarheid afneemt naarmate commando's complexer worden, en dat instructies met één stap het nauwkeurigst zijn. Uit eigen ervaring voeg ik drie regels toe:
- Gebruik de woorden die op het scherm staan. Als de knop "Sign in" zegt, schrijf dan niet "Log in".
- Zet waarden in de stap. Schrijf "Type ana@example.com into the Email field", niet "voer een geldig e-mailadres in".
- Vermijd voornaamwoorden en vage woorden. "Het", "daar", "goed" en "correct" verbergen allemaal een beslissing die de agent moet raden.
Hoe je testcases stap voor stap in gewoon Engels schrijft
Volg deze methode om een eis om te zetten in een testcase.
- Start met één acceptatiecriterium. Neem één zin uit de user story, bijvoorbeeld "A customer who forgets a password can set a new one by email".
- Kies één gedrag. Elke testcase controleert één gedrag. In de gids van Automation Panda over goede Gherkin schrijven staat dit als "One Scenario, One Behavior", en wordt gesteld dat een scenario met meerdere When-Then-paren moet worden gesplitst.
- Schrijf de startsituatie. Beschrijf die als een toestand, niet als setupacties. "A customer account exists" is beter dan tien stappen die één account aanmaken.
- Schrijf de gebruikersacties. Elke actie is één korte regel met een werkwoord en een benoemd element.
- Schrijf het verwachte resultaat. Zeg wat er verschijnt: een kop, een melding, een waarde. Gebruik de exacte tekst.
- Voeg de gegevens toe. Zet de waarden in de stappen of in een kleine tabel onder de test.
- Lees het hardop voor. Als een nieuwe collega de test niet handmatig zou kunnen uitvoeren, dan heeft de agent er ook moeite mee.
Dezelfde gids adviseert om scenario's kort te houden, met minder dan tien stappen. Een lange testcase is vaak meerdere testcases die aan elkaar zijn geplakt. Variaties op één gedrag, zoals drie ongeldige wachtwoorden, horen in een datatabel thuis en niet in drie kopieën van dezelfde stappen.
Voorbeeld: een test voor het resetten van een wachtwoord, voor en na
De details zijn verzonnen.
Voor (te vaag). "Controleer of het resetten van het wachtwoord werkt." Een agent heeft dan geen startsituatie, geen acties en geen resultaat om te controleren. Hij kan om de verkeerde reden slagen.
Na (uitvoerbaar).
- Titel: Een klant kan een link voor het resetten van het wachtwoord aanvragen.
- Preconditie: Er bestaat een klantaccount voor ana@example.com, en de klant is afgemeld.
- Stap 1: Open de pagina Sign in.
- Stap 2: Klik op de link "Forgot password".
- Stap 3: Type ana@example.com into the Email field.
- Stap 4: Klik op de knop "Send reset link".
- Verwacht resultaat: De pagina toont de melding "Check your email".
De versie "na" heeft één gedrag, vijf korte acties en één zichtbaar resultaat. Als je product ook vereist dat de link in de e-mail werkt, schrijf dan een tweede testcase voor dat gedrag. Breid de eerste niet uit.
Voer hem nu uit en lees het logboek. Stel dat de agent correct op "Forgot password" klikte, maar het adres in een zoekvak typte. Het logboek laat de fout zien, en je herschrijft stap 3 als "Type ana@example.com into the Email field on the reset form". Het Cypress-team adviseert dezelfde werkwijze voor hun eigen tool met gewone Engelse taal: controleer elke gegenereerde stap, en ga over op vaste code wanneer je een stabiele test nodig hebt.
Variaties: gebruik een datatabel, geen kopieën
Veel testcases controleren hetzelfde gedrag met verschillende waarden. Een aanmeldformulier moet een e-mailadres weigeren zonder @-teken, een zonder domein en een met spaties. Schrijf geen drie testcases met identieke stappen.
De Automation Panda-gids merkt op dat Gherkin geen "Or"-stap kent. Voor variaties op één gedrag adviseert die een Scenario Outline met een Examples-tabel, en raadt aan alleen de variaties op te nemen die je echt nodig hebt, omdat extra rijen de uitvoeringstijd verlengen. Je kunt hetzelfde idee gebruiken in gewoon Engels. Schrijf de stappen één keer met een plaatshouder, zoals "Type {email} into the Email field", en voeg daaronder een kleine tabel toe.
Voorbeeldtabel, verzonnen: {email} is "ana.example.com" en het verwachte bericht is "Enter a valid email address"; {email} is "ana@" en het bericht is hetzelfde; {email} is leeg en het bericht is "Email is required". Drie rijen, één set stappen, drie duidelijke resultaten. Als één rij faalt, laat het rapport zien welke waarde de regel heeft doorbroken.
Een controlelijst voor je de test uitvoert
Gebruik deze lijst voor elke nieuwe testcase:
- De titel beschrijft één gedrag.
- De startsituatie is een toestand, geen lijst met instelklikken.
- Elke stap begint met een werkwoord en noemt een element zoals het scherm het toont.
- Alle waarden zijn volledig uitgeschreven.
- Het verwachte resultaat is zichtbaar te controleren en heeft exacte tekst of een exact getal.
- Er zijn minder dan tien stappen.
- Iemand anders heeft de test gelezen.
Veelgemaakte fouten
- Meerdere gedragingen in één testcase combineren. Als de test faalt, weet je niet welk deel er kapot is gegaan.
- Beschrijven hoe in plaats van wat. Tien stappen met toetsaanslagen verbergen de bedoeling. Beschrijf de actie op het niveau waarop een gebruiker die zou uitvoeren.
- Het verwachte resultaat overslaan. Een testcase zonder controle kan slagen zonder iets te bewijzen.
- Interne namen gebruiken. Test-ID's en CSS-klassen veranderen. Gebruik de labels die gebruikers zien.
- Laten dat generatieve AI tests opstelt en die ongelezen accepteren. Een model kan stappen verzinnen die je product niet heeft.
- Data aan het toeval overlaten. Als een waarde niet is vastgelegd, kiest de agent er zelf een, en de test is misschien niet herhaalbaar.
Hoe software kan helpen
Een gedeelde spreadsheet of een wikipagina is genoeg om te beginnen. Schrijf elke test in de vijfdelige vorm en review hem zoals code. Als je een testmanagementtool gebruikt, houd dan één test per record aan en koppel die aan de eis. Een tool voor tests in natuurlijke taal leest dan dezelfde tekst. Veel teams houden ook een korte stijlgids bij met de bovenstaande regels, zodat elke nieuwe tester stappen op dezelfde manier schrijft.
Volgende stap
Neem drie acceptatiecriteria uit je huidige sprint en schrijf voor elk een testcase in de vijfdelige vorm. Voer ze uit in de tool van je keuze om testcases in gewoon Engels te schrijven die een agent kan uitvoeren, en corrigeer daarna elke stap die het logboek als verkeerd geïnterpreteerd toont.