B Blengi docs

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.org aggregateRating aangeeft — de crawler registreert dit als een Rating: -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

SlugVoor 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 zoals Product, SoftwareApplication, FAQPage, TechArticle)
  • generator -meta (Shopify, WooCommerce, Docusaurus, Mintlify, Zendesk, WordPress…)
  • URL-padpatronen (/products , /docs , /help , /api )
  • Hostnaamsignalen (app. / dashboard. subdomeinen voor SaaS; .local / .internal voor 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.