Agents
Een opdracht die een agent afmaakt
Met zes korte antwoorden vooraf maakt een agent zijn werk af, ook bij een lange klus. Je schrijft ze op een opdrachtkaart voordat de agent begint. Onderaan laat je de AI die kaart met je invullen.
Beantwoord zes vragen vooraf
De opdrachtkaart heeft zes vakken. Schrijf in elk vak één of twee zinnen, in deze volgorde:
- Doel: wat moet er aan het eind zijn? Schrijf het als resultaat, zoals "een werkende pagina".
- Plek: welke map en welke bestanden? Zo zoekt de agent niet op de verkeerde plek.
- Mag wel/mag niet: wat doet de agent zelf, en waarvoor vraagt hij eerst jouw akkoord?
- Oplevering: wat krijg je terug, en in welke vorm? Een bestand, een screenshot, een link of een kort verslag.
- Stoppen: wanneer is het klaar, en wanneer stopt de agent om jou iets te vragen?
- Controle: welke controle moet slagen? Laat de agent het resultaat testen en laten zien.
Ontbreekt het doel of de controle? Dan stopt de agent en vraagt hij die. Hij verzint ze niet. Leg vast wat echt telt: het doel, de grenzen en de controle. Laat de weg ernaartoe open.
Zet bij lang werk een logboek in de map
Een chat wordt te lang, valt weg of begint opnieuw. Met een logboek in je projectmap weet elke agent waar het werk staat. Vier afspraken houden een lange klus bij elkaar:
- Het logboek is een bestand zoals CHECKPOINT.md. Daarin staan het doel, wat af is, de volgende stap en wat de controle liet zien. De agent werkt het bij na elke stap.
- De takenlijst staat op volgorde en elke taak heeft een eigen controle. De agent werkt van boven naar beneden en vinkt pas af als de controle slaagt.
- Eén agent stuurt het werk. Bij de eindtijd schrijft hij op waar hij is en stopt hij.
- Werk dat jouw ja nodig heeft, zoals publiceren of geld uitgeven, zet de agent op een lijst. De rest van het werk gaat door.
Zo ging het mis bij mijn trailer
Voor RoadKit, mijn plugin voor Roblox Studio, maakte ik met AI-agents een trailer. Na 13 versies keurde ik hem goed. Toch klopte hij niet: te veel losse geluiden, geen logo en een volgorde zonder verhaal. De meeste fouten kwamen uit mijn eigen opdrachten.
Het logo had ik wel goedgekeurd, maar het stond niet in de opdracht. Een agent ziet alleen wat daarin staat. Mijn notitie "zo'n 50% zachter" stond er wel in, en toch bleef de muziek te hard. Zo'n zin is een gevoel dat niemand kan nameten.
Wat ik nu anders vraag, staat op de pagina Een trailer met AI-agents. Daar lees je ook hoe een script nu het geluid over de hele trailer controleert.
Laat de AI je kaart invullen
Kopieer de opdracht hieronder in je AI-tool en vul je klus in. De AI stelt de vragen één voor één. Je krijgt een kaart die je bij de eerstvolgende klus aan een agent geeft.
Je helpt me een opdrachtkaart voor een AI-agent in te vullen. Ik lever mijn klus: [wat ik wil laten maken]. Jij stelt me de zes vragen één voor één: Doel, Plek, Mag wel/mag niet, Oplevering, Stoppen en Controle. Wacht na elke vraag op mijn antwoord. Mis je een antwoord of is het vaag? Stop en vraag door. Verzin niets en vul niets zelf in. Jij levert de kaart: zes vakken, in die volgorde, elk met één of twee zinnen uit mijn antwoorden. Controle: elk vak bevat alleen wat ik zelf heb gezegd, en geen vak is leeg.
