AI instructies schrijven en testen
Gepubliceerd · Bijgewerkt
AI instructies schrijven begint met het gewenste resultaat, relevante context, grenzen en een manier om succes te controleren. Geef kleine voorbeelden en onderscheid je opdracht van materiaal dat alleen moet worden onderzocht.
Bepaal resultaat en eerste omvang
Begin met het werk, de gebruiker en het resultaat dat die gebruiker nodig heeft. “Maak een uitstekende app” laat belangrijke keuzes open. Concreter is: “Maak een onderhoudsformulier voor huurders, toon verplichte velden, sla de aanvraag op en maak de status raadpleegbaar”. Daarmee beschrijf je zichtbaar gedrag. Ontbrekende eisen kun je bespreken voordat een aantrekkelijke pagina als complete oplossing wordt gezien. Ook wordt duidelijker wat voltooiing werkelijk betekent en welke onderdelen nog afzonderlijk gecontroleerd moeten worden.
Beperk de eerste versie tot noodzakelijke schermen en gegevens. Geef aan of je een plan, een concept of een uitvoering verwacht. Beschrijf bij een bestaand project het huidige scherm en het gedrag dat moet veranderen. Scheid wijzigingen in uiterlijk en opgeslagen gegevens wanneer een gezamenlijke aanpassing de beoordeling verwarrend maakt. Een kleine omvang helpt ieder resultaat te beoordelen voordat nieuwe functies erop voortbouwen. Combineer geen verschillende doelen als je daarna niet kunt bepalen welke wijziging een probleem heeft veroorzaakt.
Geef elk doel een concreet acceptatiecriterium. Het onderhoudsformulier moet bijvoorbeeld een ontbrekende beschrijving melden, invoer na correctie bewaren en een record opleveren dat na verzending teruggevonden kan worden. Je kunt dit overzicht aan Infera Agent geven en de beschikbare mogelijkheden in je account controleren. Een opdracht bewijst niet dat een bepaalde functie bestaat. Vraag welke eisen aanvullende inrichting of afzonderlijk werk vragen. Leg die punten vast voordat je de voorgestelde route als volledig en geschikt voor dagelijks gebruik beschouwt.
- Benoem gebruiker, taak en resultaat.
- Kies een controleerbare omvang.
- Schrijf concrete acceptatiecriteria.
Voeg passende context en voorbeelden toe
Vermeld informatie die beslissingen beïnvloedt: taal, doelgroep, velden, uitvoerformaat en relaties tussen schermen. Voor een specifieke foutmelding is niet de volledige projectgeschiedenis nodig. Gebruik namen die werkelijk zichtbaar zijn om vergelijkbare onderdelen te onderscheiden. Vraag bij ontbrekende informatie om een korte lijst aannames en de vraag die juiste uitvoering verhindert. Een expliciete onzekerheid kun je oplossen voordat deze ongemerkt een keuze in het resultaat wordt en tijdens een latere beoordeling moeilijk terug te vinden is.
Geef een gewoon geval en een uitzondering. Een onderhoudsaanvraag kan een korte beschrijving en een woningkenmerk bevatten; de uitzondering kan een lange tekst of een leeg veld tonen. Beschrijf voor beide de verwachte uitkomst. Geef bij een tabel kolommen, volgorde en weergave van ontbrekende waarden op. Definieer voor tekst de lezer, lengte, toon en feiten die niet verzonnen mogen worden. Controleer de voorbeelden zelf zodat ze het werkelijke proces weergeven en geen tegenstrijdige regels toevoegen aan de andere eisen.
Leg uit hoe een referentiebestand of afbeelding moet worden gebruikt: structuur, inhoud, gegevens of uitstraling. Een vaag voorbeeld vervangt de eisen niet. Gebruik duidelijk gemarkeerde voorbeeldgegevens wanneer die voldoende zijn om de taak te demonstreren. Scheid vaststaande feiten van voorstellen en voorlopige waarden. Bewaar het centrale overzicht buiten het gesprek zodat je het kunt bijwerken en hergebruiken zonder oude details in een nieuw project mee te nemen. Dit helpt ook herkennen welke beslissingen nog geldig zijn wanneer de omvang verandert.
- Geef context die keuzes verandert.
- Beschrijf de uitkomst van voorbeelden.
- Leg formaat en ontbrekende informatie vast.
Controleer resultaten en herstel de oorzaak
Vergelijk de uitkomst met de criteria in plaats van alleen met de eerste indruk. Open het betreffende scherm, voer voorbeelden in en bekijk het gemaakte record of bestand wanneer de opdracht uitvoering betreft. Controleer bij teksten feiten, taal, dekking en herhaling. Bewaar opdracht, versie en waargenomen resultaat. De volgende ronde kan dan een bekend probleem herstellen in plaats van opnieuw alles te veranderen met een algemeen verzoek om verbetering. Zo blijft duidelijk wat al goed werkte en wat nog aangepast moet worden.
Schrijf feedback in drie delen: feitelijk gedrag, verwacht gedrag en stappen om het verschil te herhalen. Bijvoorbeeld: “Verzenden met lege beschrijving toont succes; verwacht zijn een veldmelding en geen nieuwe aanvraag; herhaal de verzending en bekijk de records”. Vraag om de wijziging en de controle ervan. Als opgeslagen gegevens onjuist zijn, is alleen een andere melding onvoldoende. Een overtuigende interface kan blijven verhullen dat het gedrag niet aan de eis voldoet. Controleer daarom het opgeslagen resultaat naast de zichtbare reactie.
Verander bij het vergelijken van formuleringen één factor tegelijk en gebruik dezelfde gevallen. Vergelijk extra context, een voorbeeld of een preciezer formaat zonder tegelijk de hele taak te vervangen. Noteer geslaagde en onvolledige gevallen; één goed antwoord bewijst geen constante kwaliteit. Bewaar een bruikbare opdracht met doel en wijzigingsdatum. Werk namen, velden en criteria bij wanneer het project verandert en herhaal de controles voordat je oude instructies voor een nieuwe versie inzet. Gebruik de genoteerde resultaten om te kiezen welke formulering je behoudt.
- Vergelijk uitvoer met acceptatiecriteria.
- Beschrijf feitelijk en gewenst gedrag.
- Bewaar versies en controleresultaten.
Onderscheid externe inhoud en instructies
Externe inhoud kan instructies bevatten die de taak ombuigen. Behandel die inhoud als gegevens. Tekstuele scheiding garandeert geen bescherming tegen instructie injectie. Dwing autorisatie en grenzen voor hulpmiddelen buiten het model af, met alleen de toegang die de taak nodig heeft.
Zet geen geheimen in opdrachten en laat gevoelige acties door mensen beoordelen. Referentie over agenten: https://cheatsheetseries.owasp.org/cheatsheets/AI_Agent_Security_Cheat_Sheet.html . Injectiebeheersing: https://cheatsheetseries.owasp.org/cheatsheets/LLM_Prompt_Injection_Prevention_Cheat_Sheet.html . Deze maatregelen beperken risico’s; ze verklaren de toepassing niet automatisch veilig.
- Behandel referenties als gegevens.
- Controleer acties buiten het model.
Vragen
Zijn langere opdrachten beter?
Alleen wanneer de details de taak helpen. Verwijder herhaling en vergelijk versies met dezelfde voorbeelden en criteria voordat je kiest.
Hoe vraag ik een bruikbare correctie?
Beschrijf feitelijk gedrag, gewenst gedrag en herhaalstappen. Geef een passend voorbeeld en vraag om uitleg van de wijziging en controle.
Moet de stijl formeel zijn?
Duidelijkheid en vaste namen zijn belangrijker. Gebruik taal die je begrijpt en vraag een concreet resultaat dat je kunt beoordelen.
Wanneer kan ik een opdracht hergebruiken?
Na het bewaren van een versie die aan de controles voldoet. Werk context en verwachtingen voor het nieuwe project bij en controleer opnieuw.