Bereid je kennisbank voor op snellere en nauwkeurigere AI-antwoorden.

Een AI Agent is zo goed als de informatie die hij kan vinden. Bij het opzetten van een AI Agent is het voorbereiden van de kennisbronnen een van de belangrijkste stappen. Traditionele bestandsformaten zoals PDF’s, Word-documenten, spreadsheets en presentaties zijn ontworpen voor menselijke lezers, maar niet altijd optimaal voor AI-verwerking. Dit kan leiden tot verschillende problemen:

  • Koppen raken los van de tekst waarop ze betrekking hebben.
  • Tabellen verliezen hun structuur.
  • Belangrijke context gaat verloren.
  • De AI Agent haalt informatie uit het verkeerde deel van een document.

Om dit te voorkomen, gebruik je Markdown (.md)-bestanden als kennisbron voor de AI Agent.

Edit AI Receptionist

Markdown houdt documenten overzichtelijk, gestructureerd en eenvoudig leesbaar. Dat is prettig voor mensen én zorgt ervoor dat de AI Agent informatie sneller en nauwkeuriger kan doorzoeken en ophalen.

Waarom Markdown beter werkt

Markdown verwijdert overbodige opmaak en behoudt een duidelijke documentstructuur. Met eenvoudige tekstmarkeringen voor koppen, lijsten, tabellen en secties begrijpt de AI Agent beter hoe de informatie is georganiseerd.

  • Duidelijke koppen: Markdown-koppen zoals #, ## en ### creëren een logische hiërarchie, waardoor onderwerpen en subonderwerpen bij elkaar blijven.
  • Goed leesbare tabellen: Markdown-tabellen behouden rijen en kolommen, waardoor productspecificaties, configuratievereisten en vergelijkingen eenvoudiger verwerkt kunnen worden.
  • Schonere inhoud: Markdown verwijdert verborgen opmaak en overtollige lay-outinformatie die vaak aanwezig is in Office-documenten.
  • Sneller informatie opvragen: Doordat Markdown-bestanden schoner zijn, hoeft de AI Agent minder irrelevante informatie te verwerken. Dit maakt het ophalen van relevante informatie efficiënter.
  • Minder foutieve antwoorden: Goed gestructureerde kennisbronnen vergroten de kans dat de AI Agent de juiste informatie terugvindt.

Bestaande documenten converteren naar Markdown

Je hoeft jouw bestaande documentatie niet handmatig opnieuw te schrijven. Open-source tools zoals MarkItDown en Docling kunnen bestaande bestanden automatisch converteren naar gestructureerde Markdown.

Deze tools ondersteunen onder andere:

  • .docx
  • .pptx
  • .xlsx
  • PDF-bestanden

Daarnaast kunnen ze de leesvolgorde behouden, tabellen omzetten naar Markdown en inhoud uit complexere documentindelingen extraheren.

Voorbeeld: Markdown-documenten voorbereiden voor jouw AI Agent

Open een terminal om een schone Python-omgeving aan te maken en installeer vervolgens de benodigde tool.


# Create and activate a virtual environment
python3 -m venv .venv
source .venv/bin/activate# Install MarkItDown with all format support
pip install 'markitdown[all]'

Na installatie kunt je een bestand direct via de opdrachtregel converteren:


markitdown internal_kb_report.pdf > internal_kb_report.md

Of gebruik Python:


from markitdown import MarkItDown# Initialize the converter
md_converter = MarkItDown()# Convert a complex layout file to structured Markdown
result = md_converter.convert("product_specs.docx")
# Take a look at the clean, machine-readable text
print(result.text_content)

Richtlijnen voor Markdown-opmaak

Wanneer je Markdown-bestanden maakt of bewerkt als kennisbron voor jouw AI Agent, houd dan rekening met de volgende richtlijnen:

  • Sla geen kopniveaus over: Spring bijvoorbeeld niet direct van # naar ###.
  • Laat witregels rondom tabellen: Voeg een lege regel toe vóór en na iedere Markdown-tabel.
  • Voeg context toe aan het begin van het document: Zo begrijpt de AI Agent beter waar het document over gaat.

Voorbeeld:


---
category: Technical Documentation
product: 3CX PBX V20
audience: System Administrators
last_updated: 2026-06-01
---# AI Agent Knowledgebases instellen
…

Betere kennisbronnen zorgen voor betere AI-antwoorden

Goed gestructureerde kennisbronnen helpen jouw AI Agent om sneller de juiste informatie te vinden en nauwkeurigere antwoorden te geven. Controleer daarom je bestaande documentatie, converteer belangrijke bestanden naar Markdown en zorg ervoor dat koppen, tabellen en metadata duidelijk zijn voordat je ze toevoegt aan een AI Agent.

Praat mee

Neem deel aan de discussie in het 3CX Partner–  of het Klanten Forum. Volg 3CX daarnaast op X en LinkedIn om op de hoogte te blijven van de nieuwste ontwikkelingen en productupdates.