B Blengi docs

Je AI-medewerker bouwen

Importcontrole

Als je een documentachtige bron importeert — geplakte tekst, een Google Doc, een Notion-pagina — voert Blengi daar een adviescontrole op uit en toont een korte samenvatting van aanpassingen in de bronrij: suggesties die het document beter laten aansluiten. De checker verandert het document nooit, blokkeert nooit een import en de bevindingen zijn suggesties om te bekijken, geen fouten.

Wat er wordt gecontroleerd

BevindingWaarom dit belangrijk is
Geen kopjesLange documenten zonder kopjes zijn lastig te doorzoeken — feiten uit verschillende secties lopen bij het zoeken door elkaar. Gebruik één kopje per sectie of product.
Gevonden prijzenPrijzen die vast in documenten staan, zijn meteen verouderd zodra de winkel iets verandert. Verwijs in plaats daarvan naar de productpagina; de crawler houdt die up-to-date.
Lege plaatshoudersTokens in de stijl van [fill in] die overblijven uit een sjabloon, komen letterlijk in de antwoorden terecht. Haakjesnotatie die consequent (3+ keer) wordt gebruikt, wordt herkend als opzettelijk en wordt niet gemarkeerd.
De materiaallijst klopt nietEen samenstellingslijst met een totaal van bijvoorbeeld 85% wordt weergegeven alsof deze compleet is. De checker markeert elke regel met 3+ procentpunten waarvan de som buiten het bereik van 95–105% valt.
CoderingsfoutenMojibake (é, €) door verkeerd kopiëren en plakken verstoort het ophalen van elk betrokken woord.
Te grote sectiesEen enkele sectie die het toegestane aantal blokken ver overschrijdt, valt uiteen in stukjes die hun context verliezen.
Producten zonder matenEen productregister waarvan de productonderdelen geen Maten:- of Sizes:-regel bevatten. Dankzij maten kan de assistent zeggen dat een product niet beschikbaar is voor deze bezoeker, in plaats van te moeten gokken — zonder die maten zal hij vrolijk een prijs geven voor een maat die de winkel niet op voorraad heeft. Alleen registers worden gecontroleerd; op een FAQ- of beleidspagina wordt nooit naar maten gevraagd.
Advies (AI)Eén modelrun zoekt naar interne tegenstrijdigheden, secties waarin meerdere producten door elkaar staan en onvolledige zinnen. Best-effort: als het model niet beschikbaar is, worden de bovenstaande deterministische bevindingen toch opgeslagen.

Bestaande kennisbanken

Productgegevens worden geparseerd wanneer een bron wordt geïmporteerd, dus een register dat al bestond voordat dit werd uitgerold, heeft er nog geen. In plaats van opnieuw te importeren (waarbij de hele bron opnieuw wordt opgehaald en ingebed), vul je aan vanuit de tekst die al is opgeslagen:

php artisan knowledge:extract-product-facts --dry-run
php artisan knowledge:extract-product-facts --agent=<agent-uuid>

--dry-run rapporteert wat het heeft gevonden en schrijft niets. Hoe dan ook eindigt de uitvoer met de lijst van producten zonder maatregel — die lijst is wat je in het register moet aanpassen.

"Los het voor me op"

Bij geplakte tekstbronnen zijn er twee bevindingen die je met één klik kunt oplossen: geen kopjes gevonden en erg lange sectie(s) . Klik op Los het voor me op naast de bevinding en er verschijnt een voorstel naast de huidige tekst. Er wordt niets opgeslagen totdat je op Toepassen & opnieuw indexeren klikt, waarna het normale bewerkingsproces wordt doorlopen (opslaan, opnieuw indexeren, opnieuw controleren).

Hoe het voorstel tot stand komt, in volgorde: eerst een controle op regels voor tekst in FAQ-vorm — Vraag: / Antwoord:, Q: / A:, of korte regels die eindigen op een vraagteken — waarbij elke vraag een ##-kopje wordt en het antwoordlabel wordt weggelaten; verder verandert er niets. Alleen als de tekst niet in FAQ-vorm is, wordt de AI gevraagd om kopjes in te voegen, en het antwoord wordt alleen geaccepteerd als het verwijderen van de toegevoegde kopjes je oorspronkelijke tekst woord voor woord teruggeeft. Een voorstel dat een zin „verbeterde“ wordt afgewezen met een bericht, en je voegt de kopjes dan zelf handmatig toe. Documenten met meer dan 60.000 tekens worden niet naar de AI gestuurd.

Waar het rapport te vinden is

Op de Bronnen-pagina van de agent staat bij elke gecontroleerde bron ofwel “Documentcontrole: geen suggesties” of een uitklapbaar “N suggesties om dit document te verbeteren”. Het rapport wordt opgeslagen bij de bron (check_report + checked_at) en wordt vernieuwd bij elke herimport of herindexering van de bron.

Toepassingsgebied

Alleen documentachtige bronnen: geplakte tekst, Google Docs- en Notion-pagina’s. Gecrawlde webpagina’s zijn bewust uitgesloten — marketingteksten volgen andere regels dan kennisdocumenten, en het markeren van elke prijs op een productpagina zou alleen maar ruis opleveren. De controle wordt na het indexeren in de wachtrij uitgevoerd; het heeft geen invloed op de laadtijden voor bezoekers.