Algemene tips & tricks voor het schrijven van Instructies

In dit artikel lees je hoe je krachtige en effectieve Instructies schrijft voor je AI Agent binnen Watermelon. Deze tips gelden zowel voor ‘Instructies’ als ‘Domein kennis’, en helpen je om het gedrag van je AI Agent nauwkeurig te sturen.

Een taalmodel, zoals GPT, genereert tekst op basis van input. Een ‘Instructie’ (ook wel prompt genoemd) is een opdracht die je aan het model geeft. Via deze Instructie bepaal je hoe het model zich moet gedragen en hoe het moet reageren op gebruikersvragen.

Waarom goede Instructies essentieel zijn

Je AI Agent beschikt mogelijk al over veel kennis, maar zonder duidelijke Instructies weet het model niet hoe het deze informatie moet toepassen. Instructies creëren het kader waarbinnen de AI Agent opereert. Ze zijn essentieel om het gedrag van het model te sturen, aan te passen aan jouw merk en passend te laten reageren op gebruikers.

Best practices voor effectieve Instructies

1. Schrijf alsof je een collega instrueert

• Gebruik de tweede persoon (“jij”).
• Dit perspectief helpt om de AI Agent de Instructies te laten begrijpen en effectief uit te laten voeren.

2. Wees extreem duidelijk en specifiek

• Beschrijf wat je van de AI Agent verwacht: doel, context, toon, lengte, outputstructuur, persona.
• Vermijd vage instructies zoals “houd het kort”. Geef liever: “antwoord in maximaal 3 zinnen” of “gebruik een opsomming van 3 punten” als instructie.

3. Voeg voorbeeldinteracties toe

Laat de AI Agent niet raden. Toon met voorbeelden wat je verwacht:

Voorbeeld:
User: Wat zijn de openingstijden?
Assistant: Onze klantenservice is geopend van maandag t/m vrijdag van 09:00 tot 17:00 uur.

4. Geef context en splits complexe taken

• Geef relevante achtergrondinformatie.
• Splits complexe taken op in stappen (bijv. eerst informatie uitvragen, dan een advies geven of reageren op de vraag).

5. Houd instructies compact en relevant

• Vermijd overbodige details.
• Vermijd herhaling of tegenstrijdige aanwijzingen (‘overprompting’). Dit kan verwarring veroorzaken en jouw AI Agent minder effectief maken.

6. Denk aan meertaligheid

• Bied taalspecifieke instructies als je AI Agent meerdere talen ondersteunt.
• In dit artikel vind je extra informatie over het laten reageren van jouw AI Agent in verschillende talen.

7. Wees vriendelijk en empathisch

• Voeg instructies toe die empathie en klantvriendelijkheid stimuleren.
• Laat de AI Agent begrip tonen en ondersteunende reacties geven.
• Pas deze stijl toe in zowel de Instructies als de Domein kennis.

8. Gebruik positieve taal

• Formuleer instructies op een constructieve manier.
• Zeg bijvoorbeeld: “Je mag wel X doen” in plaats van “Je mag nooit X”.
• Gebruik: “Je zegt A wanneer B gevraagd wordt” i.p.v. “Je geeft geen antwoord op vraag B”.

Optimalisatie & evaluatie

Test systematisch

• Gebruik meerdere testvragen en evalueer consistentie.
• Pas Instructies aan op basis van gebruikersinteracties en testresultaten.

Gebruik Evals om te testen

Evals zijn evaluaties waarmee je test of jouw AI Agent het gewenste gedrag vertoont. Je controleert hiermee of de output van de AI Agent overeenkomt met wat jij verwacht, bijvoorbeeld of een antwoord feitelijk klopt, de juiste toon heeft of een specifiek format volgt.

Een Eval bestaat uit de input van de gebruiker (een vraag), de verwachte output van de AI Agent (het gewenste antwoord) en de daadwerkelijke reactie van de AI Agent (het gegeven antwoord). Door deze te vergelijken kun je fouten, inconsistenties of verbeterpunten ontdekken. Dit helpt je om Instructies gericht te verbeteren.

Je kunt Evals inzetten om de prestaties van de AI Agent te optimaliseren. Test meerdere scenario’s, analyseer afwijkingen en pas je Instructies aan voor betere, consistente antwoorden. Zo maak je van je AI Agent een betrouwbare collega.

Voorbeeld eval:

  "vraag": "Wat is de hoofdstad van Nederland?",
  "verwachte antwoord": "Amsterdam",
  "gegeven antwoord": "Amsterdam"

Blijf verbeteren

• Houd je Instructies actueel. Loop Instructies regelmatig door en zorg ervoor dat ze up-to-date zijn met de nieuwste informatie en ontwikkelingen van je bedrijf of branche. Dit zorgt ervoor dat de AI Agent relevante en actuele antwoorden geeft.
• Monitor gebruikersvragen en identificeer verbeterpunten. Volg de interacties van de AI Agent nauwlettend op en analyseer de gegeven antwoorden. Identificeer patronen, veelgestelde vragen en mogelijke verbeterpunten. Gebruik deze inzichten om de Instructies en de prestaties van de AI Agent te optimaliseren.
• Let bij wijzigingen op regressie: een verbetering op de ene vraag kan elders verslechtering veroorzaken. Het is dan ook belangrijk om meerdere testvragen te stellen om de resultaten te kunnen bepalen. 

FAQ

Wat als mijn Instructie niet werkt zoals verwacht?

Test met meerdere voorbeelden en controleer of je instructie duidelijk en specifiek genoeg is.

Waarom reageert de AI Agent soms anders dan bedoeld?

Het model volgt je instructie letterlijk. Onvolledige of vage prompts kunnen leiden tot ongewenst gedrag.

Moet ik altijd voorbeelden toevoegen?

Niet verplicht, maar het verhoogt de effectiviteit van je Instructie aanzienlijk.

Door deze richtlijnen toe te passen, schrijf je Instructies die niet alleen helder en doelgericht zijn, maar ook zorgen voor consistente en kwalitatieve antwoorden van je AI Agent.