B Blengi docs

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):

  1. 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.
  2. 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.
  3. Prioriteit — de hoogste wint als meerdere geselecteerde vermeldingen overeenkomen met dezelfde invoer.
  4. Slug + KB-titel + KB gepubliceerd — zet de rij om in een openbaar Knowledge Base-artikel. Als je kb_published = true gebruikt, wordt het antwoord weergegeven als /kb/{workspace.slug}/{slug} en kan de bot het tijdens de chat aanbevelen via de send_kb_article-tool.
  5. Lang — optionele ISO-code, zodat één agent samengestelde antwoorden per taal kan aanbieden.
  6. Ingeschakeld — booleaanse schakelaar. Hiermee kun je een samengestelde rij opstellen en publiceren, of tijdelijk pauzeren zonder deze te verwijderen.
  7. Voorwaarden (conditions JSON) — 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:

VeldDoel
nameAlleen voor jouw lijst.
labelDe tekst op de knop die de bezoeker ziet.
kindHet 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).
targetDe URL, en eventueel de context van het ondertekende gesprek (zie Context van ondertekende CTA).
conditionsWanneer 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).

Een voorgesteld antwoord doet niets totdat je het goedkeurt. Antwoorden die door de zelfverbeteringslus worden voorgesteld, komen binnen als suggesties en worden uitgesloten van matching totdat je op 'Goedkeuren' drukt — bezoekers blijven ondertussen gegenereerde antwoorden krijgen voor die vragen . De samengestelde pagina toont een banner terwijl er een suggestie in de wachtrij staat, en als een live beurt misgaat alleen omdat het bijpassende antwoord nog niet is goedgekeurd, noemt het spoor van die beurt het pending-patroon (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).