Je AI-medewerker bouwen
Vaste antwoorden en CTA’s
Samengestelde antwoorden en CTA’s zijn de twee soorten ‘deterministisch’ gedrag die de widget ondersteunt — ze omzeilen het LLM ten gunste van exacte tekst of gestructureerde call-to-actions. Gebruik ze als je niet wilt dat het model de tekst parafraseert of van het script afwijkt.
Wanneer gebruik je samengestelde antwoorden?
Gecureerde antwoorden zijn bedoeld voor vragen waarbij het antwoord exact moet zijn:
- Prijzen — bezoekers willen cijfers, geen ‘ongeveer $99/maand’.
- Juridisch / compliance — retourbeleid, AVG-verklaring, contractvoorwaarden.
- Doorverwijzing — „hoe kan ik contact met je opnemen?”, waarbij je een specifieke URL wilt doorgeven.
- Merkkritische veelgestelde vragen — je 5 tot 10 belangrijkste vragen.
Opstellen
Uit Kennis › Vaste antwoorden (/app/agents/{id}/curated):
- Vraagpatroon (kolom
question_pattern) — één of meer triggerwoorden. Gebruik komma’s om één veld op te splitsen in onafhankelijke OR-tokens (pricing, refund, web design). De matcher splitst op komma’s, zet elk token in kleine letters en slaat de LLM over als ELK token voorkomt als een deelreeks van het bericht van de bezoeker. Hoofdlettergevoelig. Voeg varianten toe (price, pricing, how much) zodat ook verkeerd gespelde woorden worden herkend. - Antwoord — de exacte tekst die je terug wilt sturen. Markdown wordt ondersteund (vet, links, lijstjes). Maak Markdown-links in het antwoord als je klikbare bronvermeldingen wilt — er is geen aparte kolom voor citation_url.
- Prioriteit — de hoogste wint als meerdere geselecteerde vermeldingen overeenkomen met dezelfde invoer.
- Slug + KB-titel + KB gepubliceerd — zet de rij om in een openbaar Knowledge Base-artikel. Als je
kb_published = truegebruikt, wordt het antwoord weergegeven als/kb/{workspace.slug}/{slug}en kan de bot het tijdens de chat aanbevelen via desend_kb_article-tool. - Lang — optionele ISO-code, zodat één agent samengestelde antwoorden per taal kan aanbieden.
- Ingeschakeld — booleaanse schakelaar. Hiermee kun je een samengestelde rij opstellen en publiceren, of tijdelijk pauzeren zonder deze te verwijderen.
- Voorwaarden (
conditionsJSON) — optionele overeenkomende voorwaarden (bijv.page_url_prefix,visitor_lang) die bovenop het vraagpatroon worden gelegd.
Hoe het matchen werkt
Voordat de RAG-pijplijn wordt uitgevoerd, gaat het bericht door
CuratedAnswerMatcher
. Als er een trigger overeenkomt, wordt de samengestelde
tekst teruggestuurd en roepen we nooit de retrieval of de LLM aan. Dat maakt
samengestelde antwoorden snel
— meestal minder dan 100 ms van begin tot eind — en
goedkoop
(geen inferentiekosten).
Het streaminggedrag komt overeen met dat van de LLM: tokens worden één voor één met een kort interval gestreamd, zodat de bezoeker dezelfde typanimatie ziet. Ze kunnen onmogelijk een samengesteld antwoord onderscheiden van een gegenereerd antwoord.
CTA’s
Een CTA is een knop die de assistent onder een antwoord kan laten zien. CTA’s zijn
cta_rules
-rijen, geen gedragsregels. Elke CTA heeft:
| Veld | Doel |
|---|---|
name | Alleen voor jouw lijst. |
label | De tekst op de knop die de bezoeker ziet. |
kind | Het type: waar de knop voor dient en wat er gebeurt als je erop klikt (de URL openen, of het leadformulier in de chat voor contactgerichte typen zonder URL). |
target | De URL, en eventueel de context van het ondertekende gesprek (zie Context van ondertekende CTA). |
conditions | Wanneer het wordt weergegeven: een regel in gewone taal (when_text), url_contains, intent_keywords die overeenkomen met het antwoord, en lang. Allemaal optioneel. |
Typen, triggers en de volledige regels vind je bij CTA-knoppen .
Veelvoorkomende CTA-patronen
- Prijzen — een ‘Vraag een offerte aan’-knop waarvan de regel is ‘de bezoeker vraagt naar de prijs’, of waarvan het antwoord een prijs of kosten bevat.
- Demo — een ‘Boek een demo’-knop voor ‘de bezoeker wil het product in actie zien’; zonder URL opent deze het leadformulier in de chat.
- Een bepaald gedeelte van de site — een knop Bekijk een product of Kopen/bestellen die alleen verschijnt op pagina’s waarvan het adres
/products/bevat.
Een CTA verschijnt altijd alleen onder een antwoord. Om de chat zelf te openen — wanneer een bezoeker op het punt staat weg te gaan, of ver naar beneden heeft gescrolld — gebruik dan in plaats daarvan een trigger (Gedragsregels & triggers ).
Bewerken
Gedrag › Knoppen in de chat
(/app/agents/{id}/ctas
) is de beheerpagina. Het formulier is
een gestructureerde builder — je hoeft geen JSON te schrijven. Opslaan maakt of
werkt een CTA-regel bij; Bewerken
laadt er een terug in het formulier
en Verwijderen
verwijdert deze. De pagina heeft geen aan/uit-schakelaar
voor een CTA (de kolom enabled
bestaat wel, maar alleen de API
stelt deze in).
pending_curated_match
in de
conversatiedebugger).
Een taaltag op een antwoord geeft er de voorkeur aan voor gesprekken in die taal — het sluit nooit iets uit. De taal van het gesprek komt uit de taalinstelling van de browser van de bezoeker, die vaak niet overeenkomt met de taal waarin hij of zij daadwerkelijk typt (bijvoorbeeld een Nederlandse bezoeker met een browser die in het Engels is ingesteld), dus trefwoorden doen het echte selecteren en de taaltag beslist alleen bij gelijke scores als hetzelfde trefwoord in meerdere talen is vastgezet.
CTA’s en samengestelde antwoorden testen
Het live voorbeeld op de tabbladen ‘Uiterlijk’ en ‘Persoonlijkheid’ — en dezelfde widget
die op elke andere pagina van de agent zweeft — is je testomgeving. Het is de
echte widget, maar het gesprek bevat is_playground=true,
dus het telt niet mee voor je maandelijkse quotum en komt niet voor in het
analyserapport.
Typ een triggerzin en controleer of het samengestelde antwoord wordt geactiveerd. Typ iets dat er bijna op lijkt, maar net niet, en controleer of het dan niet gebeurt (anders zijn je triggers te ruim).