Je AI-medewerker bouwen
Vragen die automatisch rekening houden met de pagina
YOUR-AGENT-ID.
Vragen die automatisch aanpassen aan de pagina zorgen ervoor dat de widget op elke pagina slim overkomt, zonder dat je iets hoeft in te stellen. In plaats van voor elke pagina handmatig startvragen te schrijven, leest de agent de inhoud die al voor een pagina is geïndexeerd en stelt hij een paar suggesties op voor vragen waar een bezoeker op zou kunnen klikken — productvragen op een productpagina, categorievragen op een categoriepagina, en je standaard startvragen op alle andere pagina’s.
Deze functie staat standaard aan. Je kunt hem per medewerker uitschakelen onder
/app/agents/{agent}/personality (Startvragen › Vragen voorstellen die bij de pagina passen).
Hoe het werkt
- Wanneer een pagina wordt gecrawld en geïndexeerd, stelt een achtergrondtaak 3–4 korte vragen op, gebaseerd op de kennisbankfragmenten van die pagina zelf. Het model krijgt expliciet de opdracht om alleen vragen voor te stellen die met de inhoud van de pagina beantwoord kunnen worden — dus de widget stelt nooit een vraag voor die de bot vervolgens niet kan beantwoorden.
- De vragen worden per (pagina, taal) opgeslagen. Wanneer de pagina opnieuw wordt geïndexeerd (de inhoud is gewijzigd, of je klikt op Opnieuw indexeren), worden ze automatisch vernieuwd.
- Bij het laden van de widget zijn de vragen één enkele geïndexeerde opzoekactie — geen AI-aanroep op het hot path van de bezoeker, dus de latentie van het eerste token blijft ongewijzigd.
- Het genereren gebeurt voor de talen die in je werkruimte zijn ingeschakeld, dus een Nederlandse bezoeker en een Engelse bezoeker zien allebei vragen in hun eigen taal.
Hoe voorgestelde vragen worden gekozen
De widget kiest startvragen in deze volgorde, waarbij de eerste match wint:
- De geconfigureerde startvragen van een Smart Segment. Als de pagina wordt toegewezen aan een segment waarvoor startvragen zijn ingesteld, krijgen die altijd voorrang — het segment is de handmatige overschrijving.
- Automatisch gegenereerde, paginagerichte vragen voor precies deze pagina en taal (op basis van de gecrawlde inhoud — zie hierboven).
- Directe productvragen die live worden gelezen uit de eigen productgegevens van de pagina — zie hieronder. Dit werkt op een productpagina die nog niet is gecrawld, zodat zelfs de eerste bezoeker productspecifieke vragen krijgt.
- De standaard startvragen van de agent (of die van de verticale voorinstelling) als geen van bovenstaande van toepassing is.
Segmenten blijven dus de uitweg als je exacte controle over een pagina wilt, terwijl elke andere pagina nog steeds gratis slimme, paginaspecifieke vragen krijgt. gratis.
Een paginaspecifieke regel voor het inline-blok
Dezelfde generatie stelt één korte regel voor de pagina op — "Vragen over de Boston Thermo? Ik ken de samenstelling, de maten en de pasvorm." — die onder de titel van een inline blok op die pagina wordt weergegeven. Daarin staat waar de assistent je mee kan helpen op deze pagina, zonder prijzen of feiten te noemen. De teaser-ballon van de zwevende chat behoudt de begroeting die je hebt geschreven; alleen het blok gebruikt de paginatekst, en alleen als er niets specifiekers is ingesteld: het eigen ondertitel-attribuut , de inline-ondertitel van het dashboard en de begroeting van een bijpassend segment hebben allemaal voorrang, het algemene welkomstbericht voor alle assistenten staat eronder. Pagina’s die zijn gegenereerd voordat dit bestond, krijgen hun regel bij de volgende hergeneratie.
Contextchips tijdens het gesprek
Startvragen worden weergegeven bij een leeg gesprek. Maar een bezoeker die op de startpagina chat en vervolgens naar een productpagina gaat, komt binnen met een bestaande thread — dus zonder meer zouden de nieuwe vragen die voor de nieuwe pagina zijn berekend, nooit tevoorschijn komen. Als dat gebeurt, verschijnt de widget met twee contextchips boven het berichtvenster: de eigen voorgestelde vragen van de huidige pagina, beperkt tot twee zodat de interface overzichtelijk blijft.
- Chips verschijnen alleen als de vragen van de pagina paginaspecifiek zijn — startvragen van een bijpassend segment, AI- paginagerichte vragen of directe productvragen. De algemene standaardvragen van de agent komen nooit terug tijdens het gesprek.
- Vragen die de bezoeker al in dit gesprek heeft gesteld, worden overgeslagen.
- De chips verdwijnen zodra de bezoeker een bericht verstuurt op de huidige pagina, en worden bij elke navigatie vernieuwd met de vragen van de volgende pagina.
- Als je op een chip tikt, wordt deze als een normaal bericht verzonden.
Directe productvragen (geen crawl nodig)
Automatische paginagerichte vragen (niveau 2 hierboven) vereisen dat de pagina eerst wordt gecrawld: de allereerste bezoeker van een gloednieuwe productpagina ziet nog steeds algemene startvragen totdat de pagina is geïndexeerd. Bij een webshop met duizenden producten is die vertraging een probleem, dus is er een snellere manier waarbij helemaal geen crawling nodig is.
Elke moderne productpagina bevat gestructureerde Schema.org -gegevens — dezelfde JSON-LD die Google leest voor rich snippets, en dezelfde gegevens die Shopify, WooCommerce en Magento al verstrekken. De widget leest deze gegevens rechtstreeks in de browser van de bezoeker en zet ze om in op het product gebaseerde startvragen, waarbij de productnaam wordt ingevuld:
- Vertel me meer over {product} — telkens als er een productnaam staat.
- Wat kost {product}? — alleen als de pagina een prijs vermeldt.
- Is {product} beschikbaar? — alleen als de pagina de beschikbaarheid vermeldt.
- Welke functies heeft {product}? — alleen als de pagina een beschrijving bevat.
Elke vraag wordt alleen aangeboden als de onderliggende informatie op de pagina staat, zodat de
assistent de vraag altijd kan beantwoorden op basis van de paginacontext die hij al ontvangt
bij elk bericht — nooit een vraag die hij vervolgens niet kan beantwoorden. De bewoordingen zijn
volledig vertaalbaar (de lang/{locale}.json-sleutels
"What does :name cost?" en dergelijke), dus een werkruimte kan
de sjablonen zonder code anders formuleren of een andere toon geven. Productnamen worden
aan de clientzijde ingevuld en nooit opgeslagen — niets wat op de pagina van een bezoeker staat, wordt ooit
naar de kennisbank geschreven.
Dit werkt alleen als de medewerker automatische paginagerichte vragen heeft ingeschakeld en er geen startvragen met hogere prioriteit zijn geselecteerd. Zodra echte bezoekers een productpagina hebben bekeken, crawlt de automatische indexering deze en neemt niveau 2 (gecrawlde, door AI opgestelde vragen) het automatisch over.
Bekijk het live
/demo/product
is een op zichzelf staande voorbeeldproductpagina met echte
Schema.org-gegevens en de ingebedde widget. Voeg ?agent=YOUR-AGENT-ID
toe om een specifieke agent te laden (de toegestane bronnen moeten deze site bevatten), en
?locale=nl
om de vragen in het Nederlands te zien. Open de pagina en de
assistent stelt bij het eerste bezoek vragen voor over precies dat product.
Op verzoek opnieuw genereren
Onder ‘Persoonlijkheid › Startvragen’ vind je een knop ‘Opnieuw genereren’ die de vragen voor elke geïndexeerde pagina van de agent opnieuw opstelt — handig direct nadat je bronnen hebt toegevoegd of veel inhoud hebt gewijzigd en niet wilt wachten op de volgende herindexering. Via de CLI:
php artisan pitchbar:generate-page-questions {agent-id}
php artisan pitchbar:generate-page-questions --all # every enabled agent
Zet voor elke unieke pagina-URL één generatietaak in de wachtrij
index
. Bestaande pagina’s hebben geen gegenereerde vragen totdat
ze opnieuw worden geïndexeerd of gegenereerd, dus voer dit één keer uit nadat je de
functie op een bestaande agent hebt ingeschakeld.
Als een pagina niets oplevert
Als de geïndexeerde inhoud van een pagina te mager is om goede vragen te ondersteunen, geeft de generator niets terug voor die pagina en valt de widget terug op de standaardstartvragen van de agent — nooit een leeg veld of een gok van lage kwaliteit.