Prompt-handleiding
Schrijf prompts die betrouwbare Finn-voice-agenten opleveren.
Prompting-gids
Het gedrag van een Finn-spraakagent is voor 90% de prompt. Deze gids behandelt wat je moet schrijven, wat je moet vermijden en hoe je fouten opspoort.
De structuur in 4 delen
Elke betrouwbare Finn-prompt bestaat uit vier onderdelen. Op volgorde:
- Identiteit — wie de agent is, voor wie die werkt en wat de taak is.
- Doel — het enige resultaat van het gesprek. Eén zin.
- Regels — wat te zeggen, wat NIET te zeggen, waar op terug te vallen.
- Voorbeelden — 2–4 korte fragmenten van ideale beurten.
Laat een deel weg en de agent wordt fragiel.
Identiteit (1–3 regels)
You are Aria, a friendly appointment coordinator at Smile Dental Clinic.
You speak with patients calling to confirm, reschedule, or cancel an upcoming visit.
You are warm, brief, and never push extra services.
Leg in 3 regels een naam, een rol, een werkgever en een toon vast. Sla achtergrondverhalen over — die kosten latency en verwarren de agent.
Doel (1 regel)
Goal: confirm, reschedule, or cancel the patient's upcoming appointment within 90 seconds.
Eén concreet resultaat. Bestaat het doel uit meerdere stappen (kwalificeren + inplannen + warm doorverbinden), splits de agent dan op in een workflow met aparte nodes — prop het niet in één prompt.
Regels
Benoem zowel wat wel als wat niet mag.
Rules:
- Always ask "Am I speaking with {customer_name}?" before sharing any appointment details.
- If the caller says "remove me" or "stop calling", honor immediately and end the call politely.
- If asked if you're a real person, say honestly: "I'm Aria, a voice assistant for Smile Dental."
- Never quote a price — transfer to the front desk if asked.
- Never schedule a Sunday appointment — the clinic is closed.
- If the caller's intent is unclear after two clarifying questions, offer human transfer.
De "nooit"-regels zijn net zo belangrijk als de "altijd"-regels.
Voorbeelden
Toon 2–4 microdialogen. Die verankeren de toon beter dan welk bijvoeglijk naamwoord ook.
Example 1 — Smooth confirm
Aria: "Hi, is this Priya? It's Aria from Smile Dental, calling about your visit on Thursday."
Caller: "Yes."
Aria: "Great. We have you booked for 4 PM Thursday with Dr. Mehta for a cleaning. Still works?"
Caller: "Yes, that works."
Aria: "Confirmed. See you Thursday. Have a great day."
Example 2 — Reschedule
Caller: "I need to move it."
Aria: "No problem. We have openings Friday at 11 AM or 3 PM, or Monday at 10. What works best?"
Variabelen
Gebruik de {variable}-syntaxis. Finn injecteert automatisch doelgroepkolommen en live gespreksdata.
| Ingebouwde variabele | Waar het naar verwijst |
|---|---|
{customer_name} | De name-kolom van de doelgroeprij |
{customer_phone} | Het gebelde nummer |
{current_time} | Lokale tijd van de beller, opgemaakt |
{call_duration} | Seconden sinds opnemen |
Elke kolom in je geüploade doelgroep-CSV wordt een variabele (bijv. {appointment_date}, {loan_amount}).
Veelgemaakte fouten
| Fout | Waarom het misgaat | Oplossing |
|---|---|---|
| Identiteit van meerdere alinea's | Verzwaart de eerste token, traag antwoord | Maximaal 3 regels |
| Vage toon ("wees behulpzaam") | Betekent niets | Kies 3 toonbijvoeglijke naamwoorden: "warm, kort, nooit opdringerig" |
| Doel omschreven als "doe wat de gebruiker maar wil" | Agent dwaalt af, gesprekken duren lang | Eén uitkomst per agent |
| Alleen negatieve regels | Agent heeft geen positief kader | Combineer positief en negatief |
| Geen voorbeelden | Toon verschuift onder druk | Voeg er altijd 2–4 toe |
| Voorbeelden die de regels weerspiegelen | Voegt niets toe | Toon randgevallen — boze beller, onduidelijk verzoek |
Een prompt debuggen
Wanneer gesprekken van het script afwijken:
- Luister de opname terug. Ga niet gissen.
- Zoek de eerste vreemde beurt. Meestal een ontbrekende regel, geen fout van het model.
- Voeg een regel toe voor precies dat scenario, met één voorbeeld.
- Test opnieuw op hetzelfde nummer. Opgelost? Ga verder. Zo niet, dan zit het probleem verderop (workflow, audience, knowledge base).
De meeste klachten dat "het model dom is" zijn bugs door een ontbrekende regel.
Promptlengte
| Lengte | Latency | Use case |
|---|---|---|
| < 300 woorden | Laagst | Eenvoudige bevestiging / herinnering / enquête |
| 300–800 woorden | Normaal | De meeste agents |
| 800–1500 woorden | Acceptabel | Complexe sales / triage |
| > 1500 woorden | Traag + grillig | Opsplitsen in een workflow |
Hulpmiddelen
- AI Copilot — prompts direct beoordelen en herschrijven.
- Playbooks — 46 kant-en-klare templates voor voice agents.
- Knowledge Base — voor feiten die niet inline in de prompt horen.
Was this page helpful?
Still stuck or have feedback?
Email [email protected] or use the chat bubble in the bottom-right corner — it's a Finn that knows the Academy cold.