B Blengi docs

Je AI-medewerker bouwen

Kennis-sjablonen

Kennis-sjablonen zijn vooraf gestructureerde invulformulieren waarmee een nieuwe medewerker vanaf zijn allereerste bron meteen goede antwoorden kan geven. Open /app/agents/{agent}/sources (Kennis › Bronnen) en kies het tabblad Sjablonen . Kies een sjabloon, vervang de [bracketed placeholders] door je eigen feiten en sla het op — het wordt geïndexeerd via de normale pijplijn voor geplakte tekst. Elk sjabloon is ook te downloaden als .md of .txt .

De acht sjablonen

  • 🏢 Bedrijfsinformatie — naam, volledig adres, telefoonnummer, e-mail, openingstijden, hoe je te bereiken bent (routebeschrijving & parkeren), registratienummers en servicegebied. Wordt geleverd met Global als bron ingeschakeld, zodat deze gegevens op elke pagina van een gesprek worden weergegeven, niet alleen wanneer de bezoeker op je contactpagina is.
  • 📋 Productregister — één kop per product met een vaste lijst met velden (kleuren, maten, materiaalpercentages, kenmerken, afbeelding en URL van de productpagina). Dankzij de koppen per product kan de assistent productgegevens precies beantwoorden zonder producten door elkaar te halen, en het sjabloon bevat bewust geen prijzen — prijzen in documenten raken verouderd; de productpagina blijft actueel. Gebouwd op basis van de structuur die zich in de praktijk heeft bewezen. Bij de matenregel wordt tekst tussen haakjes behandeld als opmerking, niet als gegevens — schrijf uitsluitingen zoals Maten: 39-42 / 43-46 (niet in 35-38 of 47-50) gerust; alleen de maten buiten de haakjes tellen mee voor het geregistreerde bereik. Als je een register verwijdert, worden ook de daaruit geëxtraheerde feiten verwijderd, en bij elke herindexering worden feiten opgeruimd die zijn achtergelaten door eerder verwijderde registers, zodat een vervangen register nooit meer onder zijn oude naam kan blijven antwoorden. Er worden nog twee regeltypes vastgelegd als die aanwezig zijn: een prijsregel (Prijs:) en een voorbehoudregel (⚠️ Uitsluitingsregel:, Let op: of Waarschuwing:). Telkens wanneer opgehaalde inhoud of het eigen bericht van de bezoeker een registerproduct noemt, worden de geregistreerde gegevens — maten, materiaal, prijs en de ⚠️ waarschuwing — worden automatisch toegevoegd aan de context van het model voor die beurt, zodat een stukje van de beslissingsboom dat alleen maar een product noemt, nooit het model kan verlaten om zelf eigenschappen te verzinnen. Waarschuwingsregels zijn de veiligheidsbarrière van de eigenaar: „Wol houdt vocht vast — geen vervanging voor een vochtafvoerende sportsok“ gaat bij elke vermelding mee.
  • 🧭 Beslissingsgids — leert de assistent om advies te geven net als je beste verkoper: wanneer de gids van toepassing is, de ene vraag die het advies het meest stuurt, expliciete beslissingsregels, verboden regels (waaronder „nooit prijzen uit je hoofd noemen“ en de regel voor doorverwijzing naar een arts), een voorbeeldgesprek en een beslissingsboom.
  • 📦 Producten & diensten — per artikel: wat het is, voor wie het bedoeld is, de opties of maten, en wat het anders maakt.
  • ❓ Veelgestelde vragen — vraag-en-antwoord paren (prijs, bestellen, annuleren, toegang, betalen, kortingen, contact opnemen met een medewerker, levering).
  • 💰 Prijzen — duidelijke prijsvermeldingen, wat er bij inbegrepen is, de factureringsperiode, kortingen en hoe je een offerte kunt krijgen.
  • 📋 Beleid — annulering, terugbetalingen, een samenvatting van het privacybeleid en verzekering/aansprakelijkheid.
  • 👥 Teamleden — per persoon: naam, functie, waar ze mee helpen en welke talen ze spreken.

Elk sjabloon is opgesteld in het Engels en Nederlands; het tabblad ‘Sjablonen’ staat standaard ingesteld op de taal van de medewerker en heeft een EN/NL-schakelaar. Je vult je inhoud maar één keer in — het inbeddingsmodel haalt de informatie in alle talen op, dus een Nederlandse kennisbank beantwoordt nog steeds vragen van een Engelse bezoeker en andersom.

Ingebouwde best practices

De sjablonen zijn zo gestructureerd dat ze optimaal door het ophaalsysteem worden verwerkt. Als je je eigen kennis schrijft, volg dan dezelfde regels en je bot zal betrouwbaarder antwoorden:

  • Schrijf feiten als volledige zinnen, met het onderwerp erin . „Ons adres is 12 High Street, Londen” wordt veel betrouwbaarder opgehaald dan een simpel „Adres: 12 High Street”. Een bezoeker stelt een vraag in een zin; het opgeslagen feit moet ook als een zin lezen.
  • Eén onderwerp per bron. Houd bedrijfsinfo, prijzen en beleid als aparte bronnen. Overzichtelijkere bronnen zorgen voor duidelijkere verwijzingen en een betere ranking.
  • Zorg dat elke alinea op zichzelf staat. Een opgehaald stukje wordt op zichzelf gelezen, dus laat een feit niet afhangen van een kopje drie alinea’s verderop — herhaal het onderwerp in de zin.
  • Schrijf FAQ-items als echte vragen. Formuleer de vraag zoals een klant die zou typen; een vraag wordt goed gevonden bij een overeenkomende vraag.
  • Zet de details er duidelijk bij. Prijzen met valuta en periode, dagelijkse openingstijden, volledige adressen — geen afkortingen die een bezoeker niet zou typen.

Placeholder-beveiliging

Plaatshouders zien eruit als [Your address]. Als je een broncode opslaat met haakjes er nog in, waarschuwt Blengi je eerst — anders zou de bot vrolijk tegen bezoekers zeggen: “ons adres is [Jouw adres]”. Je kunt nog steeds opslaan (sommige haakjes zijn opzettelijk), maar de waarschuwing is er om de veelgemaakte fout op te vangen dat je een sjabloon plakt en vergeet het in te vullen.

Sjablonen voor Google Docs en Google Sheets

Klanten die liever in Google werken, kunnen beginnen met een gehoste sjabloon in plaats van de in-app-editor. Op het tabblad ‘Sjablonen’ zie je voor elke geconfigureerde Google-sjabloon een kaartje Maak een kopie (Bedrijfsinfo, Veelgestelde vragen, Beleid, Team als Google Docs; Producten & Prijzen als Google Sheets). Als je hierop klikt, wordt de sjabloon van Blengi gekopieerd naar de eigen Drive van de klant; je vervangt de voorbeeldinhoud en voegt vervolgens het bestand toe als bron via de bestaande Google Docs/Sheets-workflow (Google moet zijn gekoppeld in ‘Integraties’).