APE-promptstructuur: actie, doel en verwacht resultaat

De APE-promptstructuur bestaat uit Action, Purpose, Expectation, oftewel actie, doel en verwachting. Je vertelt AI wat het moet doen, waarom je dat vraagt en waaraan het antwoord moet voldoen.

Dit artikel hoort bij Promptstructuren en shortcuts binnen de AI Promptgids.

Wat betekenen de drie onderdelen?

  • Action, actie: de handeling, bijvoorbeeld uitleggen, herschrijven of ordenen.
  • Purpose, doel: waarvoor je het antwoord nodig hebt.
  • Expectation, verwachting: de concrete eisen aan het resultaat.

Purpose legt uit waarom je de opdracht geeft. Expectation maakt duidelijk wat je wilt ontvangen. ‘Ik wil me voorbereiden op een gesprek’ is een doel. ‘Geef vijf vragen met een korte toelichting’ is een verwachting.

Kopieerbaar APE-template

Action: [Concrete handeling] met [onderwerp of invoer].

Purpose: Ik gebruik het resultaat om [gewenst begrip, besluit of vervolg].

Expectation: Geef [vorm en omvang], houd rekening met [belangrijke voorwaarden] en benoem ontbrekende informatie.

Invoer: [informatie die AI nodig heeft].

Praktisch voorbeeld

Action: Herschrijf de onderstaande melding in gewone taal.

Purpose: Bezoekers moeten direct begrijpen wanneer ze de bibliotheek kunnen bezoeken.

Expectation: Maximaal 40 woorden. Behoud de tijden en geef geen reden voor de wijziging als die niet in de invoer staat.

Invoer: In verband met gewijzigde openingstijden is de bibliotheek op donderdag toegankelijk van 12.00 tot 17.00 uur in plaats van 10.00 tot 17.00 uur.

Het doel maakt duidelijk dat leesbaarheid voor bezoekers centraal staat. Controleer of de donderdag en de nieuwe openingstijd exact zijn behouden.

Wanneer gebruik je de APE-promptstructuur?

Een APE-prompt past bij korte opdrachten waarbij het doel bepaalt wat AI moet benadrukken. Je hoeft geen rol te verzinnen wanneer een duidelijke actie en resultaatomschrijving voldoende zijn.

Het verschil tussen Purpose en Expectation helpt je de opdracht scherper te maken. Purpose beschrijft waarvoor je het antwoord gebruikt, bijvoorbeeld bezoekers informeren over gewijzigde openingstijden. Expectation beschrijft wat je wilt ontvangen, zoals een korte melding waarin de juiste dag en tijden behouden blijven.

Controleer het resultaat daarom op twee punten. Begrijpt de lezer wat er verandert? En voldoet de tekst aan de afgesproken vorm en inhoud? Een korte tekst kan aan de lengte-eis voldoen en toch belangrijke informatie missen.

Google bespreekt concrete instructies, beperkingen en antwoordvormen in zijn handleiding voor promptontwerp. Die principes sluiten aan op deze aanpak; de handleiding beschrijft APE niet als afzonderlijke methode.

Veelgemaakte fouten

‘Maak een goede tekst’ zegt weinig over het resultaat. Benoem de lezer, de lengte en de informatie die absoluut moet blijven staan. Voeg relevante context toe als de opdracht zonder die achtergrond op meerdere manieren kan worden uitgelegd.

Wil je vooral indeling en lengte verduidelijken? Lees Outputformat kiezen in een AI-prompt.