B Blengi docs

Je AI-medewerker bouwen

Hulp bij de installatie

De installatiehulp stelt een AI-medewerker in op basis van wat de eigenaar zegt dat hij nodig heeft. Hij leest de website van de klant, neemt een beschrijving op in de eigen woorden van de eigenaar, stelt maximaal vijf korte vragen over wat er nog ontbreekt, en laat elke instelling in duidelijke zinnen zien voordat er iets wordt opgeslagen. De eigenaar probeert een paar antwoorden uit met de nieuwe instellingen, drukt op Toepassen en kan het daarna ongedaan maken .

De AI vult alleen een formulier in. Hij schrijft nooit instellingen op: die veranderen pas als de eigenaar ze toepast, via dezelfde validatie en dezelfde schrijver als de eigen tabbladen van de AI-medewerker, dus de installatiehulp kan nooit een waarde opslaan die de tabbladen zouden weigeren.

Waar vind je het

  • Het overzicht van een AI-medewerker: de kaart Setup-helper.
  • Het tabblad Persoonlijkheid: de knop bovenaan.
  • De laatste stap van de installatiewizard, nadat de site is gelezen.
  • Direct: /app/agents/{agent}/assistant. Leden die de AI-medewerker mogen bewerken, kunnen het gebruiken; kijkers niet.

De stappen

  1. Wat we hebben ontdekt. De startpagina wordt één keer opgehaald (een echte browser-useragent, elke omleiding wordt gecontroleerd tegen interne adressen, maximaal 1,5 MB) samen met het eerste deel van maximaal drie geïndexeerde pagina’s. Zonder AI: de bedrijfsnaam (og:site_name, de JSON-LD-organisatienaam, anders de paginatitel), de taal (de woorden op de pagina, dan <html lang>, dan de geïndexeerde documenten), of de site “u” of “je” zegt (voornaamwoorden geteld; alleen beantwoord bij een duidelijke meerderheid) en de merkkleur (de themakleur van de browser, een CSS-variabele met de naam van een merkkleur, anders de meest gebruikte heldere kleur). Met één AI-aanroep: toon, een openingsbericht, drie startvragen die een bezoeker zou stellen, en onderwerpen.
  2. In je eigen woorden. Optionele vrije tekst. De AI vult het formulier hiermee in, en alleen hiermee: elke keuze waar de eigenaar niet over heeft geschreven, blijft ‘niet gezegd’ (stilte wordt nooit geïnterpreteerd als ‘nee’).
  3. Maximaal vijf vragen, één voor één, vooraf ingevuld, waarbij wordt overgeslagen wat de eigenaar al heeft gezegd: wat het belangrijkst is; wat het nooit mag doen of zeggen (prijzen, alleen antwoorden op basis van eigen informatie, eigen regels); wanneer je om contactgegevens moet vragen en welke; of een bezoeker met een persoon kan praten; taal, ‘u’ of ‘je’, en toon.
  4. Check. Elke instelling in een zin, met Wijzigingen bij wat er zou veranderen, waar elke waarde vandaan kwam (je website, wat je schreef, jouw keuze) en een Wijzig-link per rij. Dingen die het niet kan, staan vermeld onder Nog niet mogelijk; documenten die de eigenaar noemde onder Te uploaden documenten; alles wat de AI voorstelde maar wat de eigenaar nooit heeft geschreven onder Weggelaten.
  5. Probeer het eens. Testvragen beantwoord met de instellingen die je zo gaat toepassen, net zoals de eerste vraag van een bezoeker op de startpagina wordt beantwoord: een verzoek om een persoon krijgt de doorverwijzingszin (of de fallback als er niemand bereikbaar is), een passend vast antwoord wordt letterlijk gegeven, een boekingsverzoek met een Calendly-link krijgt de boekingszin, en al het andere gaat via de categorie van de startpagina, het ophalen, de echte prompt en dezelfde opschoning (Nederlandse aanhef, één vraag voor een adviseur, prijzen verwijderd als ze niet genoemd mogen worden, bronvermeldingen verwijderd). Een opmerking onder het antwoord geeft aan welke van deze stappen is uitgevoerd. Er wordt niets opgeslagen en er wordt geen gesprek aangemaakt.
  6. Pas toe, en maak het daarna ongedaan als dat nodig is.

Elke stap wordt bij de run opgeslagen, dus als je de pagina opnieuw laadt, ga je verder waar de eigenaar was gebleven, inclusief de vragen die hij of zij heeft overgeslagen. Als je deze configuratie stopt, wordt een onafgemaakt concept weggegooid; er is niets gewijzigd. Als het openingsbericht of de startvragen nog steeds in een andere taal staan dan de gekozen taal (bijvoorbeeld nadat de AI ze niet kon herschrijven), geeft de controlepagina dat aan en biedt Herschrijf ze aan.

Wat je kunt instellen

In de instellingshulpDe instelling
Naam die bezoekers zien, rolpersona.name, persona.role (Persoonlijkheid)
Taallanguage_default
Aanspreekvorm voor bezoekers (“u” of “je”)persona.address_form: één zin in de prompt (Persoonlijkheid › Manier van spreken)
Toonpersona.tone: Vriendelijk, Deskundig of Beknopt
Openingsbericht, eerste vragentheme.intro_message, starter_prompts
Wat het belangrijkst isprimary_goals (Adviesmodus)
Prijzenprice_display: mag vermelden = text_and_card, nooit = link_only (Prijsweergave)
Alleen op basis van je eigen informatie; als het het niet weetstrict_knowledge, strict_fallback_message (Strikte kennismodus). Wordt alleen ingeschakeld als de eigenaar er expliciet om vraagt ("alleen", "nur", "verzin nooit iets"…), of aangeeft wat er moet gebeuren als het het niet weet.
RegelsEén gemarkeerd blok in de systeemprompt, met markeringsregels in de taal van de AI-medewerker (Engels --- Rules from the setup helper --- … --- End of rules ---, Nederlands --- Regels van de instelhulp --- … --- Einde van de regels ---, Duits, Frans en Spaans op dezelfde manier). De eigen tekst van de eigenaar eromheen wordt nooit aangeraakt; bij een latere run wordt alleen het blok vervangen, ongeacht de taal waarin de markeringen staan.
Contactgegevens: wanneer, welke, waarheen sturenlead_prompt_strategy, lead_form_fields (labels in de taal van de AI-medewerker en “u”/“je”; de eigen extra velden van de eigenaar blijven staan), lead_notify_emails (aangevuld, nooit vervangen)
Met iemand pratenhuman_handoff_modeen: altijd, als iemand online is, nooit
Calendly-linkcalendly_url; alleen een calendly.com-adres, want de boekingsknop opent de eigen pop-up van Calendly
Leer ook vanEen nieuwe bron met één URL per website die ook de pagina’s leest waarnaar hij linkt (één niveau). Wordt overgeslagen als een bron die pagina al leest, bijvoorbeeld voor een Google Doc (voeg die toe onder Kennis › Google Docs) of als er geen ruimte meer is in het abonnement.
Merkkleurtheme.primary

Het stelt geen openingstijden in (Instellingen › Handmatige overname), documenten (upload ze onder Kennis) of iets buiten deze tabel. Verzoeken waaraan het niet kan voldoen — afspraken in een andere agenda dan via Calendly, WhatsApp, telefoontjes, bestellingen, een CRM — worden weergegeven onder Nog niet mogelijk , en worden nooit stilletjes genegeerd.

De AI eerlijk houden

  • De AI vult een formulier in met vaste keuzes, die allemaal in eenvoudige woorden worden uitgelegd, en krijgt de opdracht om alleen te gebruiken wat de eigenaar heeft geschreven. Het antwoord moet voldoen aan een JSON-schema (gestructureerde uitvoer). Op Cloudflare Workers AI geeft het primaire model het antwoord; het geconfigureerde fallback-model wordt hier nooit voor gebruikt — in tests vulde het het formulier verkeerd in — en bij een fout wordt de volgende provider (OpenRouter, in strikte modus) geprobeerd.
  • Een controle zonder AI houdt vervolgens alleen vast wat de eigenaar daadwerkelijk heeft geschreven: een website moet zijn host in de tekst van de eigenaar hebben; een e-mailadres van een lead en een boekingslink moeten letterlijk worden weergegeven; een regel, een wens waaraan niet kan vervullen, een document, een startvraag, een openingsbericht of een rol moet een echt woord gemeen hebben met de tekst; een ‘wanneer het het niet weet’-zin mag alleen telefoonnummers, e-mailadressen en links bevatten die de eigenaar heeft geschreven. Wat er ook wordt weggelaten, staat vermeld onder Weggelaten.
  • De website mag een instelling alleen zelf invullen als die leeg is, of bij een AI-medewerker die nog door geen enkele bezoeker is gebruikt en die nooit door de instellingshulp is ingesteld (de naam, taal en het uiterlijk zijn nog de standaardinstellingen). Anders wordt de taal van de site als suggestie aangeboden in de vragen.

Vraag om een wijziging

Zodra een AI-medewerker is ingesteld, opent de installatiehulp met ‘Vraag om een wijziging ’: ‘maak het formeler’, ‘vraag ook om een telefoonnummer’. De AI stuurt het hele formulier terug met alleen die ene wijziging; alleen wat anders is, wordt overgenomen. Een nieuwe website, regel of contactgegevens moeten dezelfde controle doorstaan ten opzichte van het verzoek, en een keuze wordt nooit gewist door een wijzigingsverzoek. Op de controlepagina zie je precies wat er gaat veranderen.

Ongedaan maken

Registreert elke gewijzigde instelling met de waarde ervoor en erna (agent_setup_runs.changes ). ‘Ongedaan maken’ herstelt alles wat nog steeds de toegepaste waarde heeft; een instelling die de eigenaar daarna weer heeft gewijzigd, is van hem of haar en blijft staan. Toegevoegde websites blijven onder ‘Kennis’.

Eindpunten

RouteWat het doet
GET /app/agents/{agent}/assistantDe pagina.
POST …/assistant/startmode = setup (leest de site) of change. Vervangt een verlaten concept.
POST …/assistant/{run}/describeDe tekst van de eigenaar → het formulier. Eén AI-aanroep.
POST …/assistant/{run}/answerAntwoorden en bewerkingen, zoals ze zijn.
POST …/assistant/{run}/rewriteHet openingsbericht, de startvragen en de reservezin in de gekozen taal en “u”/“je”. Eén AI-oproep.
POST …/assistant/{run}/previewEén testantwoord met de niet-opgeslagen instellingen. Schrijft niets.
POST …/assistant/{run}/skipstep = describe of een vraagcode; blijft tijdens de run bewaard.
POST …/assistant/{run}/discardStop een onafgemaakt concept (een uitgevoerde run kan niet worden verwijderd).
POST …/assistant/{run}/apply, …/undoPas het concept toe; maak een uitgevoerde run ongedaan.

Elke route heeft de update-toestemming nodig voor de AI- medewerker en een run van die AI-medewerker. De POST-routes worden beperkt (40 per minuut). Als de AI niet kan helpen, is het antwoord 503 met een eenvoudig bericht en is er niets veranderd.