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
| Bevinding | Waarom dit belangrijk is |
|---|---|
| Geen kopjes | Lange 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 prijzen | Prijzen 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 plaatshouders | Tokens 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 niet | Een 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. |
| Coderingsfouten | Mojibake (é, €) door verkeerd kopiëren en plakken verstoort het ophalen van elk betrokken woord. |
| Te grote secties | Een enkele sectie die het toegestane aantal blokken ver overschrijdt, valt uiteen in stukjes die hun context verliezen. |
| Producten zonder maten | Een 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.