B Blengi docs

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).