Je AI-medewerker bouwen
AI-medewerkers en hun tabbladen
Een AI-medewerker is de module die je kunt integreren — persona, instructies,
kennis, thema, regels — en die op de site van een klant draait. De app
noemt het een AI-medewerker (Nederlands:
AI-medewerker); de API, de URL’s (/app/agents)
en oudere pagina’s van deze documentatie gebruiken nog steeds de term agent, en
beide woorden betekenen hetzelfde. Op deze pagina lees je alles over het aanmaken,
configureren, publiceren en terugdraaien van AI-medewerkers.
Een agent aanmaken
Vanuit de klant-app: /app/agents → Nieuwe AI-
medewerker. Hiermee maak je er een aan met de standaardinstellingen voor widgets van je werkruimte
en wordt de installatiewizard geopend, die eerst om de website vraagt (zie
Snelstart). De limiet voor AI-
medewerkers van je abonnement wordt gecontroleerd voordat er iets wordt aangemaakt. Naam, taal,
instructies, de betrouwbaarheidsdrempel, de strikte modus, het fallback-bericht
en de boekingslink stel je daarna allemaal in op de eigen
pagina’s van de AI-medewerker. Het oude aanmaakformulier is verdwenen; het adres
(/app/agents/create) opent de lijst met AI-medewerkers.
Als je bij het aanmelden je website invoert, wordt de eerste AI-medewerker voor je aangemaakt, met de naam van je domein. Je kunt deze naar believen hernoemen of verwijderen.
De acht tabbladen
Elke pagina van een AI-medewerker staat onder zijn naam, de status ‘aangevinkt’ (zie hieronder), een knop Test het die de echte widget in de hoek opent, en Publiceren zolang het nog een concept is. Daaronder staan acht tabbladen, die altijd zichtbaar zijn; op een telefoon worden ze één uitklapmenu. Bezoekers zien alleen ‘Overzicht’ en ‘Kennis’. Als er precies één AI- medewerker in de werkruimte staat, opent het menu-item deze direct in plaats van een lijst met één item.
| Tabblad | Wat staat erop |
|---|---|
| Overzicht | Wat aandacht nodig heeft, opgebouwd zoals de lijst op Home maar alleen voor deze AI-medewerker en zonder de planregels of een regel ‘niet gepubliceerd’; de installatiechecklist totdat deze voltooid is; de belangrijkste feiten in één oogopslag; Opnieuw publiceren en Verwijderen. |
| Kennis | Bronnen (wat niet kon worden gelezen komt eerst, met Probeer het nog eens), Wat het weet, Vaste antwoorden, Onbeantwoorde vragen en Feedback van bezoekers. |
| Persoonlijkheid | Naam en rol, manier van spreken (toon, en of het 'u' of 'je' zegt), taal, begroeting en openingsbericht, instructies, startvragen (met 'Stel vragen voor die bij de pagina passen') en wachtberichten. De live preview staat ernaast. |
| Gedrag | Hoe het antwoordt, Eerst vragen stellen (Adviseur-modus), Knoppen in de chat (snelantwoorden, Een gesprek boeken en CTA’s), Wanneer de chat vanzelf opent (automatisch openen, gefaseerde uitnodiging en triggers), Doorverwijzen naar een medewerker, en Begeleide gesprekken (de workflows die hiervoor worden uitgevoerd). |
| Leadregistratie | Wanneer er wordt gevraagd, het formulier en wie er op de hoogte wordt gebracht van een nieuwe lead. |
| Uiterlijk | Kleuren, de chatknop, positie en lay-out, en hoe het inline-blok eruitziet, met het live voorbeeld ernaast. |
| Website | Alle drie de installatiecodes (script, Tag Manager, inline-blok), de websites waarop het kan verschijnen en de pagina's waarop het daadwerkelijk verschijnt. |
| Geavanceerd | Segmenten, type website, experimenten, vragen voor de nachtelijke test, trackinggebeurtenissen en eerdere versies, elk met een korte beschrijving; de Playground is alleen voor platformmedewerkers. |
Elke pagina slaat alleen zijn eigen instellingen op, dus als je de kleuren opslaat, heeft dat nooit
invloed op de begroeting. Gesprekken en leads van één AI-medewerker zijn
de werkruimtelijsten die daarop zijn gefilterd. De oude adressen blijven werken:
/customize
opent Uiterlijk, /settings
opent
Persoonlijkheid, en /conversations
en /leads
van
een AI-medewerker openen de gefilterde lijsten.
De installatiechecklist van het Overzicht bestaat uit drie stappen: Voeg je website toe (een bron is gelezen), Probeer het zelf (een gesprek met het live voorbeeld, dat nooit als bezoeker telt) en Zet het op je website (wordt pas aangevinkt als de chat op je website te zien is, niet wanneer de AI-medewerker is gepubliceerd). Het is dezelfde checklist als op de startpagina, en deze verdwijnt van beide zodra je klaar bent.
Online, Klaar, Geblokkeerd, Concept
Elke AI-medewerker heeft een van de vier statussen, die wordt afgestemd op wat bezoekers hebben ervaren in plaats van op een instelling:
| Status | Betekenis | Wat te doen |
|---|---|---|
| Online | Gezien op een toegestane website in de afgelopen 30 dagen, met de host en het tijdstip van het laatste bezoek. | Niets. |
| Klaar | Gepubliceerd en toegestaan, maar nog niet op je website gezien (of niet in de afgelopen 30 dagen). | Plak de installatiecode in je website, of controleer of deze er nog staat. |
| Geblokkeerd | Gepubliceerd, maar er staat geen website op de lijst met toegestane sites, dus de widget weigert elke site. | Voeg je website toe onder Website › Websites waar deze kan verschijnen. |
| Concept | Nog niet gepubliceerd. | Publiceer het (het wordt ook automatisch gepubliceerd zodra de eerste pagina is gelezen). |
"Gezien" betekent dat er een bezoekerssessie is gestart door de widget op een pagina van een
website die nu is toegestaan, en die voldoet aan de criteria van de widget
(de www.
en het kale domein zijn dezelfde website, andere
subdomeinen zijn dat niet). Chats in het dashboardvoorbeeld tellen nooit mee. De
status wordt uit bestaande gegevens gelezen, een minuut in de cache bewaard en vervangt het
oude Live
-label, dat alleen ‘gepubliceerd’ betekende.
Het agentrecord
Elke agent heeft deze bewerkbare velden:
| Veld | Wat het doet |
|---|---|
name | Weergavenaam in het dashboard. Wordt niet aan bezoekers getoond. |
price_display | Waar prijzen kunnen verschijnen, opgeslagen in vertical_overrides. De vier modi zijn de cellen van een 2x2-matrix — prijs in de antwoordtekst, prijs op de productkaart. Zie Prijsweergave voor het volledige gedrag en hoe je de beperkte modi waterdicht kunt maken. |
language_default | De standaardtaal (Persoonlijkheid › Taal). Een van en, nl, es, fr, <img id="5"/>, de, pt, ja, <img id="8"/>, ar of zh; iets anders wordt niet geaccepteerd. De taal van het antwoord komt uit de browser van de bezoeker (Accept-Language), met dit als back-up als dat geen overeenkomst oplevert, en de AI krijgt de opdracht om te antwoorden in de taal waarin de bezoeker schrijft. De eigen teksten van de widget volgen eerst de taal van de pagina, daarna deze instelling en vervolgens de browser. Hoeveel van de interface wordt vertaald, verschilt per taal. Bij Nederlandse agents normaliseert de stream ook de gewoonte van het kleine model om een antwoord te beginnen met een Engelse discoursmarker: een inleidende No,/Yes, wordt herschreven naar Nee,/Ja, voordat het eerste token de bezoeker bereikt (echte Nederlandse openingszinnen zoals "Nog" of "Nou" worden nooit aangepast). |
persona | JSON: { name, role, tone, address_form }. De toon wordt letterlijk in de systeemprompt overgenomen; onder ‘Persoonlijkheid › Manier van spreken’ kun je kiezen uit ‘Vriendelijk’, ‘Deskundig’ en ‘Beknopt’, en alle andere bewoordingen blijven zoals ze zijn. address_form is formal (Nederlands ‘u’, Duits ‘Sie’, Frans ‘vous’) of informal (‘je’, ‘du’, ‘tu’): één zin op de identiteitsregel van de prompt vertelt de AI hoe hij de bezoeker moet aanspreken, en een afsluitende herinnering helemaal aan het einde van de prompt herhaalt dit (bronnen zijn vaak in de andere vorm geschreven, en het model volgt het laatste woord). Leeg betekent geen regel, en de AI volgt de bezoeker. Nu volgen ook de eigen systeemteksten van de widget dit: een formele Nederlandse agent toont „Uw naam“, „We verbinden u met iemand…“ en de andere regels in de „u“-vorm in plaats van de standaard „je“. |
theme | Kleuren, straal, positie en label van de launcher van de widget. |
system_prompt | Optionele overschrijving. Toegevoegd aan de ingebouwde prompt — vervangt de veiligheids- en RAG-instructies niet. |
guardrails | JSON: { avoid: [topics], max_chars }. |
starter_prompts | Maximaal 6 chips worden boven het invoerveld weergegeven bij de eerste keer openen. Elk 80 tekens. |
confidence_threshold | 0–1. Onder deze score (na herrangschikking) zegt de agent „Ik weet het niet“ in plaats van te raden. |
allowed_origins | Strikte lijst met scheme://host-bronnen waar de widget mag laden. |
restricted_paths | De lijst met padpatronen (globs, *-joker) die path_mode leest. Zie Toegestane bronnen. |
path_mode | Waar de agent verschijnt binnen een toegestane bron: all (elke pagina), except (elke pagina behalve de genoemde patronen) of only (alleen de genoemde patronen en nergens anders). Hiermee kunnen twee gespecialiseerde agents één domein delen. |
auto_index_visited_pages | Als dit is ingeschakeld, worden pagina’s waar bezoekers terechtkomen in de wachtrij geplaatst voor crawlen en indexeren. |
lead_prompt_strategy | Wanneer de chat het leadformulier aanbiedt (tabblad Lead capture). Een van de volgende: engagement (standaard: bij een intent-trefwoord zoals ‘prijzen’ of ‘demo’, of zodra de bezoeker 3 berichten heeft verstuurd), first_turn (bij het eerste bericht van de bezoeker), keyword_only (alleen bij een intent-trefwoord) of never. |
wp_integration (JSON, versleuteld) | Context van de WordPress/WooCommerce-plugin. Slaat het geheim voor het aanmelden van kopers op, plus eventuele winkel-specifieke instellingen die de LLM-tools (bijv. lookup_order) nodig hebben. Wordt automatisch ingevuld als de WordPress-plugin verbinding maakt via een API-token; je hoeft dit niet handmatig aan te passen. |
Betrouwbaarheidsdrempel
De retriever beoordeelt elk fragment aan de hand van de vraag van de bezoeker. Alles
wat onder confidence_threshold scoort, wordt weggelaten. Als er minder dan twee
fragmenten overblijven, wordt het antwoord gemarkeerd met low_confidence en
antwoordt de agent eerlijk dat hij het niet weet — en het systeem zet een
"kennisgat"-vermelding in de wachtrij die je kunt bekijken.
De standaardinstellingen worden per aanbieder afgestemd:
- Cloudflare bge-base-en-v1.5-embeddings — standaard
0.5. De cosinus-scores liggen lager dan die van OpenAI, dus de drempel is lager. - OpenAI text-embedding-3-small — standaard
0.78. Stel dit in bij het aanmelden als je van provider wisselt.
Concept → Gepubliceerd
Een AI-medewerker in conceptstart niet op welke website dan ook. Door te publiceren gaat de widget van start (dit gebeurt ook automatisch zodra de eerste bron is gelezen). Daarna is elke opslag direct live voor bezoekers: de widget leest de huidige instellingen van de AI-medewerker.
Bij elke publicatie en elke herpublicatie in het Overzicht wordt ook een kopie bewaard van de naam, taal, persona, uiterlijk, toegestane websites, instructies, antwoordlimieten en hoe zeker de AI-medewerker moet zijn. Onder Geavanceerd › Eerdere versies kun je een van die kopieën terugzetten; dit overschrijft de instellingen met de eerdere waarden. Kennis, gesprekken en leads blijven onaangeroerd, en de kopieën zelf worden bewaard.
De agent insluiten
Het tabblad Website toont een installatiefragment van één regel met je
data-agent-id erin verwerkt. De widget-URL bevat een
cache-busting-hash die verandert telkens wanneer de bundel opnieuw wordt opgebouwd, zodat
klanten niet vast komen te zitten op verouderde versies. Zie
Installatiefragment voor meer informatie.
Een agent verwijderen
Er zijn twee manieren om een agent te verwijderen:
- Vanuit de lijst met AI-medewerkers (
/app/agents): klik op het prullenbakpictogram naast het tandwiel in de kolom ‘Instellingen’ van de betreffende rij. Bevestig in het venster dat verschijnt en de agent is verwijderd. - Vanuit het overzicht van de AI-medewerker (
/app/agents/{id}): klik op Verwijderen onderaan de pagina en vervolgens nogmaals op Verwijderen in de waarschuwing die verschijnt.
Verwijderen is definitief. Kopersrapport 19-05-2026:
zacht verwijderen liet spookgesprekken in de playground + onderliggende DB-rijen
zichtbaar achterblijven nadat de klant zijn agent had ‘verwijderd’, dus het verwijderingspad
roept nu forceDelete() aan. Elke onderliggende rij wordt
via FK op databaselaag doorgevoerd: conversations,
messages, leads, sources,
documents, chunks, experiments,
visitor_page_views, enz. Het widget-insluitfragment voor
de agent werkt meteen niet meer.
De vectoropslag (Cloudflare Vectorize / Qdrant) zit niet op dezelfde
databaseverbinding, dus de database-cascade kan er niet bij. Vernietig de wachtrijen
PurgeAgentVectorsJob
vlak voor
forceDelete()
: de taak roept
QdrantClient::deleteByFilter
aan met
['agent_id' => $id]
tegen de
services.vector_collection
-index. Het is idempotent en
negeert transportfouten, dus een tijdelijke storing bij Vectorize zorgt er niet voor
dat het verwijderen voor de gebruiker wordt geblokkeerd. php artisan pitchbar:audit-vectors
vergelijkt de chunks van elke agent die nog bestaat met de vector
index en meldt ontbrekende en verweesde vectoren. Het controleert alleen agents
die nog bestaan, dus het vindt de vectoren niet van een verwijderde agent
waarvan het opschonen is mislukt.
Omdat het verwijderen definitief is, is er geen
withTrashed()
-hersteloptie. De platform-admin
destroy op /admin/agents/{id}
gebruikt dezelfde semantiek
(audit 30-05-2026) — voorheen liet het zacht verwijderde rijen achter die de
klant niet kon zien, waardoor het doel van het opschonen van verweesde gegevens, waarvoor de
super_admin-actie was toegevoegd, teniet werd gedaan.
Autorisatie: je moet de rol van eigenaar, beheerder of redacteur in de werkruimte hebben. Kijkers en leden van andere werkruimten krijgen een 403-fout.
Agents in bulk verwijderen
Selecteer meerdere rijen op de indexpagina Agents (/app/agents
)
via de kolom met selectievakjes. Het selectievakje in de koptekst schakelt alle rijen op
de huidige pagina in of uit; shift-klik op een selectievakje van een rij om een bereik te selecteren tussen
de laatst aangeklikte rij en de huidige. De selectie blijft behouden over
pagina’s heen totdat je op Wissen
klikt.
Een vaste balk onderaan de pagina toont het aantal en een actie
‘Verwijderen
’. Bevestig in het venster — elke
geselecteerde agent wordt definitief verwijderd (dezelfde werking als het verwijderen van één agent:
de DB-cascade bereikt onderliggende rijen;
PurgeAgentVectorsJob
in de wachtrij per agent om
Vectorize op te schonen). Werkruimteoverschrijdende ID’s worden stilzwijgend uit het
resultaat verwijderd (de beleidscontrole per rij wijst ze af zonder dat
hun bestaan zichtbaar wordt).
Dezelfde useBulkSelection
-hook + BulkActionsBar
-component zorgen nu voor het in bulk verwijderen op elke indexpagina in de hele app:
/app/agents— agents voor het in bulk verwijderen (deze pagina)./app/workflows— workflows voor het in bulk verwijderen./app/conversations— gesprekken in bulk verwijderen./app/leads— bulkverwijdering van vastgelegde leads./admin/agents— super_admin: agenten in bulk verwijderen in alle werkruimten./admin/leads— super_admin: leads in bulk verwijderen./admin/conversations— super_admin: gesprekken in bulk verwijderen./admin/workspaces— super_admin: werkruimten in bulk tijdelijk verwijderen (je kunt de werkruimte waarin je momenteel bent ingelogd niet verwijderen)./admin/users— super_admin: gebruikers in bulk tijdelijk verwijderen (slaat jezelf, de laatste super_admin en werkruimte-eigenaren over).
Het selectiemodel is op elke pagina hetzelfde: een selectievakje met drie standen in de koptekst,
selectie van een bereik door Shift-klikken op selectievakjes in de rij, blijvende selectie bij
paginering, een vaste balk met aantal + Verwijderen + Wissen. Elk bulk-eindpunt
accepteert { ids: string[] } (max. 100 per verzoek) en controleert
elk id aan de hand van het beleidsfilter van de betreffende resource.
Meerdere agents per werkruimte
Je kunt zoveel agents draaien als je abonnement toestaat — één voor marketing, één voor het helpcentrum, één voor de in-app upsell-flow, enz. De nieuwe AI- medewerker controleert eerst de limiet van je abonnement en weigert met een bericht wanneer die is bereikt. Elke agent heeft zijn eigen kennisbank, persona en insluitcode. Gesprekken en leads blijven beperkt tot de agent die ze heeft afgehandeld.