B Blengi docs

Je AI-medewerker bouwen

Begeleide gesprekken (workflows)

Met workflows kun je vastleggen hoe een agent reageert op veelvoorkomende vragen van bezoekers voordat de LLM erbij wordt betrokken. Handig voor standaardantwoorden (veelgestelde vragen over terugbetalingen, openingstijden, winkelbeleid), vragenlijsten om leads te screenen, vertakkende screeningsstromen en directe doorverwijzing naar een medewerker bij bepaalde trefwoorden.

In de app heten workflows ‘Begeleide gesprekken’ en vind je ze bij elke AI-medewerker onder Gedrag › Begeleide gesprekken. Daar zie je de gesprekken voor die specifieke AI-medewerker en de gesprekken die voor alle AI-medewerkers zijn ingesteld. Ze worden nog steeds bewerkt in de workflow-editor hieronder; het aparte menu-item is verdwenen.

Hoe het in elkaar zit

Elk bericht van een bezoeker doorloopt deze pijplijn:

  1. Geselecteerde antwoordmatch — door de beheerder vastgezet antwoord op de exacte vraag.
  2. Workflow-match ← deze pagina.
  3. RAG-opvraging + LLM-generatie.

Een workflow omzeilt de LLM-aanroep als er een match is: de bezoeker krijgt de vooraf opgestelde tekstballonnen te zien, er worden geen tokenkosten in rekening gebracht, en het gesprek wordt gemarkeerd met de uitgevoerde workflow voor analyse.

Hoe een workflow verbinding maakt met een agent

Een workflow wordt alleen geactiveerd voor een bezoekerbeurt als aan alle drie de voorwaarden is voldaan:

  1. De status is active . Nieuwe workflows beginnen in draft en de runtime negeert ze volledig totdat je de status omzet — zo kun je wijzigingen testen zonder het liveverkeer te verstoren. disabled is een derde status voor „pauzeerd maar niet verwijderd“.
  2. Het agentbereik klopt. Op de bewerkingspagina van de workflow geeft de keuzelijst ‘Toegepast op agent ’ je twee opties:
    • Voor de hele werkruimte (alle agenten) — agent_id IS NULL . De workflow is toepasselijk voor elke agent in je werkruimte. Handig voor werkruimteoverschrijdende stromen zoals "het woord 'mens' waar dan ook leidt tot overdracht".
    • Vastgezet aan één agent — kies een specifieke agent uit de dropdown. De workflow is alleen van toepassing op gesprekken van die agent. Handig voor winkelspecifieke FAQ’s („retourzendingen” is alleen van belang voor de Shopify-winkelagent, niet voor de documentatieagent).
  3. De trigger gaat af . Het bericht van de bezoeker moet daadwerkelijk overeenkomen met de trefwoorden van de workflow (onder de geconfigureerde any / all / exact -overeenkomingsmodus).

Concreet: voor elke beurt van een bezoeker voert de engine één query uit:

SELECT * FROM workflows
 WHERE status = 'active'
   AND workspace_id = :current_workspace
   AND (agent_id IS NULL OR agent_id = :current_agent)
 ORDER BY priority DESC, updated_at DESC, id

…en doorloopt de rijen in die volgorde, waarbij een workflow wordt overgeslagen die is gekoppeld aan een ander segment dan dat van het gesprek, en geeft de eerste terug waarvan de trefwoorden overeenkomen met het bericht. priority is een geheel getal van -100 tot 100 (standaard 0); het formulier heeft er geen veld voor, dus meestal heeft elke workflow 0 en wint de meest recent bijgewerkte bij gelijkspel. Gebruik status disabled om een workflow uit te schakelen zonder de trefwoorden te verliezen. Als je een striktere prioriteit nodig hebt, beperk dan de trefwoordensets zodat twee workflows niet allebei bij dezelfde beurt kunnen passen.

Snel recept — koppel een nieuwe workflow aan een medewerker

  1. Open een AI-medewerker → Gedrag › Begeleide gesprekken → Nieuw begeleid gesprek (de lijst met alle gesprekken vind je op /app/workflows).
  2. Geef het een naam. Kies de agent bij Beperkt tot agent (of laat het op Werkruimtebreed staan).
  3. Status: kies Actief als je klaar bent om het meteen te publiceren, of Concept terwijl je nog aan het bewerken bent.
  4. Voeg minstens één trefwoord toe in de triggerconfiguratie (bijv. refund ) en kies een overeenkomingsmodus. Om er meerdere toe te voegen, typ je ze gescheiden door komma’s in één veld — refund, refunds, money back — en elk wordt dan een eigen trefwoord.
  5. Voeg minstens één stap toe — een message-ballon is voldoende.
  6. Sla op.
  7. Typ in de openbare widget van de beoogde agent een bericht met het trefwoord erin. De workflow wordt uitgevoerd in plaats van de LLM, en je ziet het vooraf opgestelde antwoord.

Om een workflow te stoppen zonder deze te verwijderen, zet je de status op disabled . Om de workflow van de ene agent naar een andere te verplaatsen, verander je gewoon Scoped to in agent op dezelfde workflowrij — je hoeft de stappen niet te klonen.

Mogelijkheden

  • Eén triggertype: op trefwoord, met drie zoekmodi (een van / alle / exact).
  • Zes stapsoorten: bericht, vraag, vertakking, tag_lead, webhook, escaleren.
  • Variabele interpolatie: {{var_name}} in een berichttekst vult de vastgelegde waarde in tijdens het uitvoeren.
  • Voorwaardelijke vertakking op basis van vastgelegde antwoorden (5 vergelijkingsoperatoren + een standaard terugvaloptie).
  • Stappen met neveneffecten voor het taggen van leads en het versturen van POST-verzoeken naar externe webhooks (in de wachtrij, fire-and-forget).

Stapsoorten

TypeWat het doet
message Stuur één chatballon. Ondersteunt {{var_name}}-interpolatie. Gaat direct door naar de volgende stap.
question Stuur één chatballon + pauzeer de run. Het volgende bericht van de bezoeker wordt opgevangen in var_name en de run gaat verder vanaf de volgende stap in de volgende beurt.
branch vars[var] vergelijken met een geordende lijst van gevallen en springen naar de eerste overeenkomende go_to-stapindex. De gevaloperatoren zijn equals, contains, starts_with, is_empty, <img id="7"/>, not_empty en default (een fallback die wordt geactiveerd als geen enkel ander geval overeenkomt). Er is een limiet van 32 sprongen per beurt, zodat een verkeerd opgebouwde grafiek de engine niet kan laten vastlopen.
tag_lead Voeg string-tags toe aan de Lead-regel van het gesprek (maakt een stub-Lead aan als de bezoeker het inline-formulier nog niet heeft verzonden). Tags worden verzameld en gedupliceerd op fields.tags. Typisch gebruik: tag een bezoeker als pricing_intent nadat een vertakking hem op het Pro-pad heeft gebracht.
webhook Een ‘fire-and-forget’ POST (of GET) naar een externe URL met de vars, conversation_id, workflow_id en eventuele extra_payload uit de run. Wordt verzonden als een in de wachtrij geplaatste DispatchWebhookJob, zodat het chatvenster van de bezoeker nooit hoeft te wachten op een trage integratie. Er wordt één poging gedaan ($tries = 1, zodat de ontvanger nooit duplicaten krijgt); als het misgaat, komt het terecht in /admin/jobs/failed.
escalate Stuur een afsluitend ballonnetje — de tekst van de stap, of "We verbinden je nu door met een medewerker — die is zo bij je."; als de overdracht voor de AI-medewerker is afgesloten, in plaats daarvan het fallback-bericht voor de overdracht — beëindig de run vervolgens met escalated ingesteld in de variabelen van de run. Dat is alles wat het doet: er wordt geen persoon opgeroepen (geen human_requested_at), niemand krijgt een melding en de chat verschijnt niet onder Heeft je nodig. De AI beantwoordt het volgende bericht van de bezoeker zoals gewoonlijk.

Trigger-matchmodi

ModusKomt overeen wanneer
any (standaard) Er komt minstens één trefwoord voor als een substring (hoofdlettergevoelig) in het bericht van de bezoeker. "pricing" komt overeen met "vertel me alsjeblieft over de prijzen".
all Elk trefwoord moet als een deelstring voorkomen. Handig voor samengestelde zoektermen — ["enterprise", "security"] wordt niet geactiveerd bij "vertel me over prijzen", maar wel bij "beveiligingsbeoordeling voor bedrijven".
exact Het bericht, opgeknipt en in kleine letters, komt letterlijk overeen met een van de trefwoorden. Gebruik dit voor opdrachten van één woord ("annuleren", "help", "ondersteuning") die NIET moeten worden geactiveerd bij overeenkomsten met deelstrings.

Vertakkingsrouting

De cases-array van een branch-stap wordt in volgorde doorlopen. Het eerste geval waarbij match waar is, wint, en de uitvoering springt naar go_to (een stapindex). match: default is een speciaal geval dat altijd overeenkomt en als laatste moet staan — het is de vangnetoptie als geen van de voorgaande operatoren wordt geactiveerd.

{
  "type": "branch",
  "var": "plan_interest",
  "cases": [
    { "match": "equals",      "value": "free", "go_to": 5 },
    { "match": "contains",    "value": "pro",  "go_to": 8 },
    { "match": "not_empty",                    "go_to": 12 },
    { "match": "default",                      "go_to": 15 }
  ]
}

Een flow kan vertakkingen aan elkaar koppelen — de loop-guard beperkt de uitvoering tot 32 sprongen per beurt, zodat twee vertakkingen die per ongeluk naar elkaar wijzen geen oneindige lus kunnen vormen. Als de guard afgaat, wordt de run gemarkeerd met failed en worden alle bubbels die vóór de lus zijn uitgezonden nog steeds naar de bezoeker gestuurd.

Trigger-semantiek

De runtime doorloopt elke actieve workflow waarvan de werkruimte overeenkomt met de agent van het gesprek en waarvan agent_id ofwel NULL is (voor de hele werkruimte) ofwel overeenkomt met de agent van het gesprek. Binnen die rijen wint de eerste workflow waarvan de trefwoorden overeenkomen (op basis van zijn match_mode). De volgorde op de admin-indexpagina is op updated_at aflopend. De runtime-matchinglus zelf heeft geen ORDER BY — rijen worden teruggegeven in de standaardvolgorde van de database (meestal de invoegvolgorde). Als twee workflows op dezelfde invoer zouden kunnen matchen, maak er dan één strakker zodat er maar één wint, in plaats van te vertrouwen op toeval in de invoegvolgorde.

Bewerken — visueel canvas (standaard) en lineair formulier (alternatief)

Twee manieren om een workflow te bewerken, beide gebaseerd op dezelfde JSON-structuur:

  • Visueel canvas bij /app/workflows/{id}/canvas — de standaard -editor. Als je op een workflow klikt op de indexpagina of een zojuist aangemaakte workflow opslaat, kom je hier terecht. React-Flow-editor met één knooppunt per stap, versleepbare verbindingen tussen handvatten en een inspectiepaneel aan de eindzijde. Vertakkingsknooppunten hebben één handvat per geval (plus een optioneel handvat default ); verbind elk handvat met de volgende stap.
  • Lineaire vorm bij /app/workflows/{id}/edit — het alternatief. Een stapel stapkaarten met typespecifieke velden. Je bereikt deze via de knop ‘Lineair bewerken’ op de canvaspagina wanneer een flow zo eenvoudig is dat een platte lijst overzichtelijker is dan een grafiek.

Het canvas bewaart de visuele lay-out (knooppuntposities + rand- verbindingen) onder definition.canvas, naast de tijdens de uitvoering gebruikte definition.steps-array — dus flows die in het canvas zijn gemaakt, openen de volgende keer weer met dezelfde indeling.

Als je vanuit het canvas opslaat, wordt er een topologische doorloop van de grafiek uitgevoerd vanaf het triggerknooppunt en wordt de stappenarray in BFS-volgorde geserialiseerd. Vertakkingen cases[*].go_to worden gevuld vanuit de doelindexen van de verbindingen, dus als je een flow opnieuw opslaat die je alleen hebt geopend om te lezen, blijven de stappen ongewijzigd.

Functies van de canvas-builder

  • Canvas-first aanmaken — de knop "Nieuw in canvas" (of /app/workflows/create?canvas=1) opent de builder in een niet-opgeslagen concept; bij de eerste keer opslaan wordt de workflow aangemaakt en blijf je in het canvas. Als je vanuit het canvas opslaat, kom je altijd terug naar het canvas.
  • Live validatie — de werkbalk toont het aantal problemen; defecte knooppunten krijgen een rode ring. Controles: trigger zonder trefwoorden of zonder eerste stap, onbereikbare stappen, lege bericht-/vraagtekst, niet-gekoppelde vertakkingen, ontbrekende/niet-http webhook-URL’s, tagstappen zonder tags. Problemen verhinderen het activeren van een flow en zorgen ervoor dat een concept nooit wordt opgeslagen. De server weigert bovendien status: active met een lege trefwoordenlijst.
  • Testrun — voert een proefdraai uit van de huidige (zelfs niet-opgeslagen) grafiek via de exacte semantiek van de engine via POST /app/workflows/simulate: trigger-matching, vertakkingsbeoordeling, {{var}}-interpolatie en de 32-sprong-lusbewaking gedragen zich allemaal identiek, maar er wordt niets opgeslagen — webhooks worden getraceerd in plaats van verzonden, tags worden getraceerd in plaats van toegepast. Vraagstappen pauzeren voor een getypt antwoord, en het uitgevoerde pad licht groen op op het canvas.
  • Verbeteringen aan de editor — ongedaan maken/opnieuw uitvoeren (Ctrl/Cmd+Z, Shift om opnieuw uit te voeren), verwijderen met de Delete-toets (de trigger is beveiligd), knooppunten dupliceren, een paletitem naar het canvas slepen om het precies te plaatsen, "Tidy layout" automatische indeling, en een waarschuwing voor niet-opgeslagen wijzigingen voordat je wegklikt.

Status

  • Concept — nooit gekoppeld. Gebruik dit tijdens het bewerken.
  • Actief — wordt bij elke bezoekerbeurt toegepast.
  • Uitgeschakeld — wordt bewaard voor de geschiedenis, maar wordt nooit gekoppeld. Handig voor seizoensgebonden stromen die je later weer inschakelt.

Vooruitzichten voor fase 3

De persistentievorm blijft voorwaarts compatibel. In fase 3 komt er waarschijnlijk het volgende bij:

  • A/B-testen — meerdere workflowvarianten delen één trigger; de runtime kiest er één per bezoeker en registreert welke tot een conversie heeft geleid.
  • Analyses per stroom — uitvalpercentages per stap, verdeling over vertakkingen, tijd tot overdracht.
  • Triggers per bezoekerssegment (naast trefwoorden) — URL-patroon van de pagina, terugkerende versus nieuwe bezoekers, GeoIP.

Oudere runtimes die een fase 3-definitie lezen, zullen staptypes die ze niet herkennen stilletjes overslaan, zodat een toekomstige beheerder een definitie kan opslaan die op een oudere omgeving soepel terugvalt.