Een kennisbank schrijven waar AI echt mee kan werken

Uw AI-agent antwoordt op basis van wat hij leest. Geef hem vijf jaar aan pdf’s, twee versies van de retourvoorwaarden en een pagina die zegt “zie hierboven”, en hij antwoordt slecht, hoe goed het model ook is.

Een kennisbank waar AI mee kan werken, is vooral een goed geschreven FAQ. Iedereen in uw team kan er een schrijven.

Belangrijkste punten

Vertrek van echte vragen, niet van de bestanden die u al hebt.
Eén onderwerp, één antwoord. Twee pagina’s die elkaar tegenspreken, geven een agent die er een kiest.
Elke passage moet op zichzelf staan. De AI leest een paar alinea’s, nooit de hele pagina.
Laat live data en vertrouwelijke gegevens weg. Prijzen en bestellingen worden uit uw systemen gelezen. Salarissen en contracten horen er helemaal niet in.
Eerst Markdown en JSON, gescande pdf’s en afbeeldingen als laatste.
Houd ze actueel: elke pagina krijgt een eigenaar, elke onbeantwoorde vraag wordt een pagina.

Hoe de AI uw kennisbank leest

Voor elk antwoord doorzoekt de agent uw kennisbank, haalt de paar passages op die het best bij de vraag passen en antwoordt op basis daarvan. Dat heet RAG. Zo kunnen ChatGPT of Claude vragen over uw bedrijf beantwoorden: het model is hetzelfde, de context is de uwe.

De AI ziet nooit de hele pagina. Een passage die steunt op de alinea erboven, verliest onderweg haar betekenis.

1. Vertrek van de vragen die mensen echt stellen

Upload niet elk bestand op de gedeelde schijf. Maak een lijst van vijftig echte vragen uit uw supportmailbox, contactformulier, telefoongesprekken en salesteam, en controleer of elke vraag ergens een duidelijk antwoord heeft. De gaten zijn de eerste pagina’s om te schrijven.

2. Eén onderwerp, één antwoord

Als uw website zegt dat u om 9.00 uur opengaat en een pdf uit 2023 zegt 8.30 uur, kiest de agent er een. Verwijder dubbels, oude versies en alles wat verouderd is, in plaats van er een nieuwere pagina naast te zetten.

Dubbels kosten u ook iets als ze hetzelfde zeggen. De agent leest maar een paar passages per vraag, en drie kopieën van dezelfde alinea nemen de plaats in van twee andere passages die hij nodig had.

3. Schrijf passages die op zichzelf staan

Elke sectie moet betekenis hebben als ze het enige is wat de agent leest. Een snelle test: geef de passage, en niets anders, aan een nieuwe collega. Kan die de vraag er niet mee beantwoorden, dan kan de agent dat ook niet.

Herhaal het onderwerp. “Artikelen in de uitverkoop kunnen binnen 14 dagen worden geretourneerd” is beter dan “Voor deze artikelen geldt dezelfde regel”.
Formuleer titels zoals de vraag. “Kan ik mijn leveringsadres wijzigen?” is beter dan “Varia”.
Eén idee per sectie. Een alinea over retouren, levering en garantie tegelijk past bij geen enkele vraag goed. In een FAQ betekent dat één vraag per item, elk met een eigen antwoord.
Schrijf de voorwaarden erbij. “Levering duurt 2 dagen” klopt tot iemand vanuit Zwitserland bestelt. Zeg voor wie de regel geldt en wat de uitzonderingen zijn.

4. Laat live data en vertrouwelijke gegevens weg

Prijzen, voorraad, bestelstatus en vrije tijdsloten veranderen elke dag. Gekopieerd in een document kloppen ze de week erna niet meer. De kennisbank legt uit hoe iets werkt. Uw webshop, CRM of agenda zegt hoe het er vandaag voor staat, en de agent leest die via een live koppeling.

Twee soorten context. Uw documenten (FAQ, voorwaarden, catalogus) veranderen zelden en komen in een kennisbank, die voor elk antwoord wordt geraadpleegd. Live data (voorraad, bestellingen, afspraken) verandert elke dag en wordt via een live koppeling uit uw systemen gelezen, nooit gegokt. Beide voeden één AI-agent, die ze raadpleegt voor hij antwoordt

Hetzelfde geldt voor alles wat vertrouwelijk is: salarissen, klantcontracten, persoonsgegevens, interne notities. Wat in de kennisbank staat, kan in een antwoord terechtkomen.

5. Kies formaten die de AI kan lezen

Van makkelijk naar moeilijk:

Vijf formaten gerangschikt van makkelijk naar moeilijk leesbaar voor de AI. 1: Markdown en JSON, expliciete structuur, er gaat niets verloren. 2: Word, gewone tekst en CSV, prima voor tekst maar tabellen moeten worden omgezet. 3: pdf, de opmaak raakt vaak door elkaar. 4: afbeeldingen, de tekst moet eerst herkend worden. 5: video's, alleen de transcriptie wordt verwerkt

Markdown en JSON. De structuur is expliciet, er gaat niets verloren.
Word-documenten, gewone tekst en CSV. Prima voor tekst. Tabellen zijn het probleem: opgeknipt in passages verliest een rij haar kolomkoppen, en “42, 3, ja” zegt niets meer. Elke rij omzetten naar JSON houdt de koppen bij de waarden.
Pdf. Bruikbaar als de tekst selecteerbaar is. Opmaak, kolommen en voetnoten komen er vaak door elkaar uit.
Afbeeldingen. Tekst in een foto of scan moet eerst herkend worden, en daar sluipen fouten in.
Video’s. Alleen de transcriptie wordt verwerkt. Wat op het scherm te zien is maar niet gezegd wordt, gaat verloren.

Zo ziet het probleem met tabellen eruit. Een rij uit een CSV-bestand, op zichzelf gelezen:

Eiken stoel,42,3,ja

Dezelfde rij als JSON:

{
  "product": "Eiken stoel",
  "op_voorraad": 42,
  "levertijd_dagen": 3,
  "retourneerbaar": true
}

De tweede houdt haar betekenis als ze het enige is wat de agent leest.

6. Geef bestanden een duidelijke naam en plaats

De bestandsnaam is vaak de eerste aanwijzing die de agent over een passage krijgt. retourbeleid-2026.md zegt hem iets. doc_final_v3.pdf niet.

Als meerdere agents het werk verdelen, bijvoorbeeld één voor klantenservice en één voor sales, zet de inhoud van elke agent dan in een eigen map. Zo doorzoekt elke agent alleen wat hem aangaat.

7. Schrijf de grenzen op

Noteer welke onderwerpen naar een persoon gaan (klachten, grote terugbetalingen, juridische of medische vragen) en wat de agent zegt als hij het niet weet. Met die regels kan hij zeggen dat hij het niet weet in plaats van iets te verzinnen.

8. Houd ze actueel

Geef elke pagina een eigenaar en een herzieningsdatum, en werk ze bij wanneer de regel verandert, niet drie maanden later. Test daarna: elke vraag waarop de agent fout antwoordt, wijst op een pagina om toe te voegen of te verbeteren.

De testlus in vier stappen: vragen, met 50 echte vragen, ook de lastige; controleren, elk antwoord tegen uw bronnen; het gat zien, want een fout antwoord wijst op ontbrekende context; aanvullen, met een document, live data of een overdracht. Een gestippelde pijl keert terug naar het begin: herhalen na elke wijziging, daarna op echte gesprekken

Voor en na

Voor	Na
“Zie voorwaarden hierboven.”	“Artikelen in de uitverkoop kunnen binnen 14 dagen na levering worden geretourneerd, tegen een tegoedbon.”
Titel: “Varia”	Titel: “Kan ik mijn leveringsadres wijzigen?”
Twee pagina’s met verschillende openingsuren	Eén pagina, met een eigenaar en een herzieningsdatum
Een prijslijst geplakt in een pdf	Prijzen live uit uw webshop gelezen
Een gescande brochure met de naam `doc_final_v3.pdf`	Dezelfde inhoud in Markdown, met de naam `retourbeleid-2026.md`

Waar wij helpen

U kunt het meeste zelf doen, en het loont welke tool u ook gebruikt. Wanneer we een webchatbot opzetten, koppelen we uw website, documenten en FAQ aan Vectoria, het platform achter onze packages. We zetten uw tabellen en bestanden om naar formaten die de agent goed leest, filteren vertrouwelijke inhoud eruit en anonimiseren persoonsgegevens. Daarna testen we de agent op uw echte vragen en tonen we welke pagina’s u eerst moet verbeteren. Dezelfde kennisbank kan daarna andere kanalen voeden, zoals antwoorden op e-mails.

Wilt u zien hoe uw huidige inhoud standhoudt? Boek een kennismakingsgesprek.