Start met Blengi
Basisbegrippen
Een paar ideeën die je op elke pagina tegenkomt. Als je maar één documentatiepagina leest, laat het dan deze zijn.
Werkruimte
Elk stukje data in Blengi hoort bij precies één werkruimte. Gebruikers kunnen lid zijn van meerdere werkruimtes en daar tussen schakelen; agents, gesprekken, leads, bronnen en analyses overschrijden nooit de grens.
Multi-tenancy wordt afgedwongen door de BelongsToWorkspace Eloquent
trait, die een globale filter toevoegt die elke query filtert op de huidige
werkruimte. Er is een regressietest (MultiTenancyTest) die
de build laat mislukken als er zonder deze trait een model op tenant-niveau wordt opgevraagd.
Agent
Een agent is de eenheid die je inbouwt. Deze beschikt over een persona, een systeemprompt, een thema, startprompts, toegestane bronnen, gedragsregels en — heel belangrijk — zijn eigen kennisbronnen. Eén werkruimte kan meerdere agenten bevatten (bijvoorbeeld één voor je marketingsite, één voor je helpcentrum).
Agents hebben een concept- en een gepubliceerde status.
Een concept verschijnt nergens op een website: /widget/init geeft
404 antwoorden, behalve in het voorbeeld in het dashboard.
Zodra de widget is gepubliceerd, leest deze de huidige instellingen van de agent, dus elke
wijziging is direct live voor bezoekers — er is geen aparte
gepubliceerde kopie. Bij elke publicatie wordt ook een kopie van de instellingen opgeslagen als een
agent_version-rij, die je via Geavanceerd › Eerdere
versies kunt herstellen.
Kennisbron
Een bron is alles waaruit je de agent wilt laten leren: een URL, een sitemap, een feed, geplakte tekst, een Notion-pagina, een Google Doc, of — als de schakelaar voor automatisch indexeren aan staat — pagina’s waar bezoekers op terechtkomen. Elke bron levert één of meer documenten op; documenten worden opgedeeld in stukjes van ~500 tokens, ingesloten en in de vectoropslag geplaatst of bijgewerkt.
Zie Kennisbronnen voor het opnameproces en de RAG-pijplijn voor hoe het ophalen werkt.
Gesprek
Een gesprek is een thread tussen één bezoeker en één medewerker. Het blijft bestaan
ook als de pagina opnieuw wordt geladen — wanneer de widget binnen 24 uur opnieuw wordt geïnitialiseerd, gaan we verder met het
meest recente gesprek in plaats van een nieuw gesprek te starten. Berichten hebben
rollen: user en assistant, plus
internal-note voor de notities van je team. Het antwoord van een teamlid
nadat hij of zij de chat heeft overgenomen (op het gespreksscherm) wordt opgeslagen als een
assistant-bericht met model
human:<user id>; de widget ontvangt het als
human-agent.
De rij wordt geschreven op het moment dat de widget laadt
(/api/v1/widget/init
), of de bezoeker nu wel of niet
iets typt, dus de ruwe tabel telt widgetsessies
, niet
chats. Overal waar het product ‘gesprekken’ zegt — de dashboardtegels,
het overzicht ‘Gesprekken’ (dat opent op ‘Alleen actief’) en
de lijst met medewerkers — bedoelt het sessies waarbij de bezoeker minstens
één bericht heeft verstuurd; Conversation::engaged()
is de enige gedeelde
definitie. Het dashboard toont het aantal sessies onder de
tegel ‘Gesprekken’, zodat beide getallen zichtbaar blijven: een site met 6.000
widget-laadbeurten en 7 echte gesprekken per week wordt precies zo weergegeven.
Lead
Een lead is een bezoeker van wie je de contactgegevens hebt vastgelegd (naam, e-mail, telefoonnummer, plus eventuele aangepaste velden die je hebt gedefinieerd). De widget vraagt hierom direct wanneer het gesprek een bepaalde intentiedrempel bereikt — zie 'Voice, leads & persistence '. Leads worden per agent op e-mailadres gededupliceerd, zodat dezelfde persoon die het formulier twee keer invult, niet twee rijen creëert.
Abonnement
Plannen zijn door de platformbeheerder beheerde abonnementsniveaus (Free, Pro, enz.).
Elk abonnement bepaalt een maandelijks conversatiequotum
en een
functiepakket
— momenteel is features.remove_branding
de enige optie, maar dit is nog in ontwikkeling. Abonnementen worden automatisch gesynchroniseerd met
Stripe als ‘Producten + Prijzen’, zodat beheerders nooit het Stripe-dashboard hoeven te gebruiken.
Hot path
"Hot path" betekent het pad van het bericht van de bezoeker naar het eerste token. Het heeft een strikte p95-latentiedoelstelling van 1 seconde — geen schrijfbewerkingen in de database, geen synchrone webhooks, geen herpogingen. De pijplijn stuurt tokens door en voert vervolgens asynchroon persistentie- en analysewerk uit nadat de stream is voltooid. Zie Hot path & latentie .
Oorsprong-toegangslijst
Het widgetscript is openbaar — iedereen die je data-agent-id
vindt, kan het op zijn eigen site plakken. Het /v1/widget/init
-eindpunt
hanteert een strikte oorsprong-toegangslijst per agent: een lege lijst weigert
alles, anders wordt alleen een exacte scheme://host
-match toegestaan zonder
subdomein-inferentie. De regels voor toegestane oorsprongen
vind je hier.
Superbeheerder versus werkruimtelid
Een workspace-lid ziet de klantinterface (/dashboard
,
/app/agents
, /app/leads
, /settings/billing
). Een superbeheerder
ziet daarnaast de platformconsole op /admin
voor het beheren van
abonnementen, het bijhouden van het gebruik, het opnieuw uitvoeren van mislukte taken en het zich voordoen als klanten
voor ondersteuning. De vlag is users.role = SuperAdmin
en wordt afgeschermd
door de EnsureSuperAdmin
-middleware (die een 404-fout retourneert, geen 403,
zodat het paneel het bestaan ervan niet prijsgeeft).