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:
- Geselecteerde antwoordmatch — door de beheerder vastgezet antwoord op de exacte vraag.
- Workflow-match ← deze pagina.
- 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:
-
De status
is
active. Nieuwe workflows beginnen indraften de runtime negeert ze volledig totdat je de status omzet — zo kun je wijzigingen testen zonder het liveverkeer te verstoren.disabledis een derde status voor „pauzeerd maar niet verwijderd“. -
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).
-
Voor de hele werkruimte (alle agenten)
—
-
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
- Open een AI-medewerker → Gedrag › Begeleide gesprekken → Nieuw begeleid gesprek (de lijst met alle gesprekken vind je op
/app/workflows). - Geef het een naam. Kies de agent bij Beperkt tot agent (of laat het op Werkruimtebreed staan).
- Status: kies Actief als je klaar bent om het meteen te publiceren, of Concept terwijl je nog aan het bewerken bent.
-
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. - Voeg minstens één stap toe — een
message-ballon is voldoende. - Sla op.
- 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
| Type | Wat 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
| Modus | Komt 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 handvatdefault); 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: activemet 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.