Je AI-medewerker bouwen
Soorten websites & sectorgebonden voorinstellingen
Blengi-agents passen zich aan het soort site aan waarop ze draaien. Als je een agent instelt, kan het systeem automatisch detecteren of je een webshop, een documentatiesite, een SaaS-product, een helpcentrum, een marketingsite of een interne kennisbank hebt — en een verticale preset laden die is afgestemd op die context.
Wat een voorinstelling verandert
Elke preset bevat vier soorten standaardinstellingen:
- Systeempromptfragment — wordt bij elke beurt toegevoegd aan de LLM-systeemprompt. Komt na de opgehaalde gegevens en vóór eventuele aangepaste systeemprompts die je zelf schrijft, zodat je aangepaste instructies altijd voorrang krijgen.
- Startprompts — de tekst die bezoekers zien bij het eerste openen. Wordt ingevuld voor nieuwe agenten; blijft ongewijzigd als je al je eigen lijst hebt samengesteld.
- Launcher-label — de call-to-action op de gesloten bol van de widget (bijv. “Bekijk onze winkel”, “Zoek documenten”).
-
Mogelijkheden
— een lijst met rijke UI-affordances
die de widget bij het opstarten leest. Fase 3-renderers zijn vanaf vandaag beschikbaar voor
productkaarten, prijskaarten, casestudykaarten en de
escalatieknop (zie
resources/widget/src/ui/blocks.tsx); meer renderers (codeblokken, FAQ-accordeons, enz.) volgen naarmate de lijst met mogelijkheden groeit. Productkaarten kunnen een beoordelingsscore weergeven (een★ 4.6 (123)-regel) als de gecrawlde pagina een Schema.orgaggregateRatingaangeeft — de crawler registreert dit als eenRating:-feit en de assistent kopieert het naar de kaart, zonder er zelf iets te verzinnen. Een productkaart toont de foto van het product: de crawler bewaart de foto van elke productpagina (de Schema.org-afbeelding, of anders de og:image), en de server zet die op de kaart die naar die pagina linkt als de titel overeenkomt met het product op de kaart, dus een kaart leent nooit de foto van een ander product. De vergelijking kijkt naar woorden, niet naar de exacte spelling: „All-Round“ op de pagina en „Allround“ op de kaart zijn hetzelfde product, en het categoriewoord van de pagina („Wandelsokken“) of de slogan van de winkel na een „|“ staat dit niet in de weg. Bestaande winkels krijgen hun foto’s bij de volgende wekelijkse vernieuwing, of meteen met Reindex. Bij e-commerce- agenten worden vragen als „wat is het verschil tussen X en Y“ beantwoord met een compacte vergelijkingstabel, weergegeven als een echte scrollbare tabel in de widget. - Alleen echte acties — een mogelijkheid in deze lijst is een label voor de widget, niet iets wat de assistent kan doen. De e-commerce-preset vertelt de assistent om alleen aan te bieden wat hij in de chat kan doen (antwoorden, vergelijken, aanbevelen, kaarten tonen) en nooit aan te bieden om de bezoeker naar een pagina te leiden, de verzending naar je adres te controleren, een bestelling te plaatsen, te wijzigen of te volgen, een artikel te reserveren of een melding te sturen als het weer op voorraad is, tenzij een van zijn tools precies dat doet; als je erom vraagt, zegt hij waar op de site je dat kunt doen. De SaaS-preset schrijft de knoppen op de prijskaart in de taal van de bezoeker en verwijst naar de contactopties in plaats van een medewerker aan te bieden.
De zeven sectoren
| Slug | Voor sites die… | Mogelijkheden (in deze versie geblokkeerd) |
|---|---|---|
ecommerce |
Producten verkopen. Prijzen, voorraad, retouren, verzending. | product_card, price_inline, shipping_estimate, cart_handoff, order_status, ticket_escalation |
documentation |
Technische documentatie, API-referenties en SDK-handleidingen publiceren. | code_block, api_reference_card, version_picker, troubleshoot_steps, ticket_escalation |
saas |
Software verkopen met prijzen, functies en aanmelding. | pricing_card, signup_handoff, feature_compare, account_status, ticket_escalation |
help_center |
Een openbaar support-/FAQ-platform beheren met artikel- en ticketprocessen. | ticket_escalation, kb_article_card, sentiment_routing, ticketing |
marketing |
Leads verzamelen, casestudy’s uitvoeren, content voor de top van de funnel maken. | lead_capture_inline, demo_booking, case_study_card, ticket_escalation |
internal_kb |
Zorg voor een wiki voor medewerkers, runbooks of compliance-documenten. | policy_lookup, team_handoff, auth_aware, ticket_escalation |
generic |
Geen van bovenstaande opties, of je configureert alles zelf. | Alleen ticket_escalation — elke branche maakt dit beschikbaar, zodat de LLM het altijd aan een mens kan doorgeven. |
Automatische detectie
Tijdens de onboarding (nadat je de URL van je website hebt geplakt) haalt Blengi de startpagina op, beoordeelt een aantal gestructureerde signalen en kiest de verticaal met de hoogste score. De signalen die het meeweegt:
-
og:type-metatag (bijv.product,website,article) -
JSON-LD-waarden voor
@type(Schema.org-entiteiten zoalsProduct,SoftwareApplication,FAQPage,TechArticle) -
generator-meta (Shopify, WooCommerce, Docusaurus, Mintlify, Zendesk, WordPress…) -
URL-padpatronen (
/products,/docs,/help,/api) -
Hostnaamsignalen (
app./dashboard.subdomeinen voor SaaS;.local/.internalvoor KB) -
Aanwezigheid van
<article>-tags en<pre><code>-blokken
Elk signaal heeft een gewicht; de verticale met de hoogste som wint. Als
geen enkele verticale de betrouwbaarheidsdrempel van 0,25 haalt,
valt de detector terug op generic en vraagt hij je om
handmatig te kiezen.
Automatische detectie gebeurt op basis van ‘best-effort’. JS-zware SPA’s die lege SSR
HTML leveren, of hosts met authenticatiebeperkingen, vallen terug op generic —
je kunt altijd handmatig een categorie kiezen via de keuzekaarten.
Later een categorie wijzigen
Open Geavanceerd › Type website van de AI-medewerker
(/app/agents/{id}/vertical). Je kunt:
- Opnieuw laten detecteren als je site is veranderd (bijv. als je een Shopify-winkel hebt toegevoegd aan een site die voorheen alleen uit content bestond).
- Een andere branche kiezen via de keuzelijst. Als je aanpassingen zouden worden overschreven, legt een bevestigingsvenster precies uit wat er wordt vervangen.
Het fragment van de systeemprompt wordt tijdens de uitvoering toegepast — het zit niet
vast in het agentrecord, dus als je de branche verandert, verandert
de prompt direct zonder verouderde tekst. Mogelijkheden worden ook tijdens de uitvoering bijgewerkt:
de widget ontvangt de live lijst bij elke /init-aanroep.
Startprompts en het label van de launcher worden bij het toepassen samengevoegd in het agentrecord,
zodat je ze kunt bewerken onder Persoonlijkheid › Startvragen zonder je werk kwijt te raken
wanneer je dezelfde branche de volgende keer opnieuw toepast.
Mogelijkheden overschrijven
Elke agent heeft een optionele JSON-kolom vertical_overrides.
Stel vertical_overrides.capabilities = [...] in om
de lijst met mogelijkheden van de preset te vervangen door je eigen lijst. De widget leest
de overschrijving; de LLM ziet nog steeds het systeemfragment van de preset, zodat
je overschrijvingen het promptcontract niet per ongeluk verzwakken.
Multi-tenancy & beveiliging
Beide eindpunten (POST /app/agents/{agent}/vertical/detect
en POST /app/agents/{agent}/vertical/apply
) worden beheerd
door AgentPolicy::update
— alleen leden van de
werkruimte van de agent kunnen ze aanroepen. Toegang vanuit een andere werkruimte levert een 403-fout op.
vertical_signals
slaat de meest recente detectie op
in de agentrij, zodat de beheerders-UI "automatisch gedetecteerd op …" kan weergeven
zonder opnieuw te hoeven ophalen.
Wat volgt
Fase 1 levert het datamodel, de detectie, de voorinstellingen, de beheer-UX en
maakt capabilities
beschikbaar voor de widget. Fase 2 (tool /
functieaanroepen) is gedeeltelijk geleverd — de ToolRegistry
in app/Services/Tools/ToolRegistry.php
is aangesloten, en
de eerste tool (EscalateToHumanTool
) wordt beperkt geleverd tot
de ticket_escalation
-functionaliteit. Sector-specifieke
tools (zoals product_lookup
voor e-commerce, enz.) volgen zodra
de integraties klaar zijn. Fase 3 (renderers voor rijke berichten in de widget)
is gedeeltelijk geleverd — resources/widget/src/ui/blocks.tsx
geeft product-, prijs-, casestudy- en escalatieblokken weer die de
LLM via inline-XML-markers verstuurt; extra renderers volgen naarmate
we de lijst met mogelijkheden uitbreiden.
Kaartlinkbeveiliging
Het model vult het url
-attribuut van elke kaart in op basis van de opgehaalde
context, en als de echte pagina-URL niet is opgehaald, vallen kleine modellen
terug op de kale startpagina van de site — dus de "Bekijken"-link van de kaart
brengt bezoekers dan naar de startpagina in plaats van naar de productpagina.
ProductCardUrlResolver
(app/Services/Widget/ProductCardUrlResolver.php
) bewaakt
elke product-, prijs- en casestudy-kaart na het streamen: een URL die
overeenkomt met een geïndexeerde pagina wordt vervangen door de opgeslagen canonieke URL
(waardoor www
met ‘/apex’ en afwijkingen in de afsluitende schuine streep worden genormaliseerd), een kale
startpagina of onbekende URL wordt opnieuw omgezet door de kaarttitel
te vergelijken met geïndexeerde paginatitels en URL-slugs, en als er niets overeenkomt
wordt de link verwijderd — de widget geeft de kaart dan weer zonder een
"Bekijken"-knop weer, in plaats van ergens verkeerd naartoe te linken. Werkt zowel in de
bezoekersstream als in de Playground, leest alleen de eigen
documenten van de agent en wordt nooit uitgevoerd vóór het eerste gestreamde token.