Chatwidgetcode met privé-instructies: een systeemprompt schrijven die werkt

Twee chatwidgets kunnen dezelfde regel insluitcode delen en zich toch totaal anders gedragen. Het verschil zit in de privé-instructies, vaak systeemprompt genoemd. Die worden met je widget op de server opgeslagen, met elk gesprek meegestuurd en nooit aan bezoekers getoond.

Waar de instructies staan

Open een chatwidget in Widgets en scrol naar Gedrag. Het instructieveld accepteert maximaal 4.000 tekens. Omdat het op de server blijft, ziet een bezoeker die je pagina inspecteert alleen het widget-id in de scripttag:

<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>

Een wijziging in de instructies geldt vanaf het volgende bericht. Je hoeft de code op je site nooit bij te werken.

Een structuur die werkt

Goede instructies beantwoorden vier vragen voor het model.

1. Wie ben je? "Je bent de assistent van Northwind, een webwinkel voor outdooruitrusting."
2. Wat weet je? Plak de feiten die ertoe doen: levertijden, retourregels, openingstijden, productlijnen. Het model kan alleen zo nauwkeurig zijn als de feiten die je het geeft.
3. Wat moet je vermijden? "Beloof geen kortingen. Geef geen medisch of juridisch advies. Weet je het niet zeker, zeg dat dan en verwijs naar de contactpagina."
4. Hoe moet je klinken? "Antwoord in twee of drie korte zinnen. Gebruik de taal van de bezoeker."

Houd elke regel kort en concreet. Lange, vage alinea's zijn voor een model moeilijker te volgen dan een korte lijst.

Test als een bezoeker

De voorbeeldweergave in de editor stuurt echte verzoeken met je niet-opgeslagen instructies, zodat je snel kunt bijschaven:

• Stel de vijf vragen die het vaakst in je supportinbox binnenkomen.
• Vraag iets wat je instructies niet behandelen en controleer of de widget toegeeft dat hij het niet weet.
• Probeer hem een regel te laten breken, bijvoorbeeld door om een kortingscode te vragen.

Pas de instructies na elke ronde aan. Kleine wijzigingen in de formulering lossen vaak de meeste problemen op.

Houd je merk consistent

De chatwidget is white label: geen logo en geen "powered by"-regel. Stel de titel, het welkomstbericht, de plaatshoudertekst, de knoptekst en de foutmelding in met je eigen woorden, en stem accentkleur, hoekafronding en thema af op je site. Teksten die je leeg laat, gebruiken standaardwaarden in de taal van je account.

Combineer de instructies met limieten

Instructies sturen de antwoorden, maar ze zijn geen budget. Stel een limiet in voor de antwoordlengte (maximaal aantal tokens) zodat antwoorden kort blijven, en kies de API-key waarop de widget draait. De dagelijkse bestedingslimiet en de toegestane modellen van die key gelden voor elk verzoek van een bezoeker, wat je een tweede, onafhankelijk vangnet geeft.

Begin met een concept op de widgetpagina en verfijn het daarna in je dashboard.