Mira AI antwoordt op basis van de kennisbronnen die je koppelt – een webscrape, een XML-productfeed, tekstinhoud en eigen antwoorden. Mislukt een bron, dan kan Mira stoppen met het beantwoorden van productvragen of met verouderde informatie antwoorden. In deze handleiding vind je de meestvoorkomende fouten en hoe je ze oplost. De status van elke bron zie je in het gedeelte Kennisbank – een statuspictogram naast de naam van de bron toont details wanneer je erover zweeft.
Vereisten voor de productfeed
De feed-URL moet openbaar toegankelijk zijn (geen login vereist). Gebruikt je server een firewall, geef dan onze IP-adressen 94.130.187.58 en 188.245.65.74 toegang.
De maximale omvang is 50 MB, in XML- of CSV-formaat (structuur van Google Merchant Center of Heureka).
Elk item heeft de verplichte tags nodig: id, name, description, price en link. Items waarbij een daarvan ontbreekt, worden tijdens de verwerking overgeslagen.
Elk item hoort een categorie te hebben – items zonder categorie kunnen wegvallen, en dan kan Mira geen product- en categorievragen beantwoorden.
Tip: Haal je feed vóór het toevoegen door een feedvalidator om ontbrekende tags vroeg te ontdekken. Blijft een feed mislukken, dan laat de uitvoer van de validator meestal precies zien welke items het probleem zijn. Je kunt je feed hier valideren.
Veelvoorkomende fouten in de productfeed
“Verwerken van gegevens mislukt” / het uploaden eindigt nooit
De gebruikelijke oorzaken: de feed is groter dan 50 MB, verplichte tags ontbreken of zijn onjuist opgemaakt, of de URL is niet openbaar toegankelijk. Valideer de feed, controleer de omvang en zorg dat de URL in een incognitovenster opent zonder in te loggen. Filtert je server verkeer, geef dan onze hierboven genoemde IP-adressen toegang.
“De tijdslimiet voor het downloaden van het bestand is verstreken”
De hosting van je feed reageerde te traag en de download liep af. Voeg de feed opnieuw toe – de controle wordt bij elke poging opnieuw uitgevoerd – en controleer de verbindingssnelheid van je server. Blijft de fout terugkomen, neem dan contact op met onze support en we zoeken het uit.
Waarschuwing over ontbrekende categorieën
Items zonder categorie worden overgeslagen en Mira kan daaruit geen product- of categorievragen beantwoorden. Voeg eerst aan elk item in de feed een categorie toe. Eindigt de eerste build van de feed met een categoriewaarschuwing terwijl je items wél categorieën hebben, open dan de feed en klik op Bijwerken – de tweede build wordt meestal zonder problemen afgerond. Zo niet, neem dan contact op met onze support.
De feed staat op Gereed, maar Mira vindt sommige producten niet
Items waarbij een verplichte tag ontbreekt (id, name, description, price, link) worden stilzwijgend overgeslagen, dus de feed kan op Gereed staan terwijl sommige producten er niet in zitten. Valideer de feed, herstel de gemarkeerde items en klik op Bijwerken.
Een update blijft hangen op In behandeling
Bij grote catalogi kan het bouwen van een feed even duren. Blijft een update meer dan een paar uur op In behandeling staan, neem dan contact op met onze support – wij kunnen de verwerking voor je opnieuw starten.
Problemen met de webscrape
Mira kan pagina's van mijn website niet vinden
Controleer of de pagina's openbaar toegankelijk zijn zonder in te loggen en of je firewall onze IP-adressen (94.130.187.58, 188.245.65.74) toelaat. Eén scrape dekt maximaal 20 pagina's – kies de belangrijkste (FAQ, verzending, voorwaarden, belangrijkste productpagina's) in plaats van alles. Blokkeert de website crawlers volledig, dan kun je het instellen van je agent toch afronden – beschrijf je bedrijf in het tekstveld dat tijdens de onboarding wordt aangeboden; dat wordt opgeslagen als een gewone bron met tekstinhoud.
Het scrapen duurt uren
Een scrape die uren duurt, is vastgelopen. Neem contact op met onze support en geef de URL door die je wilt laten scannen, dan controleren we de verwerking aan onze kant.
Mira antwoordt met verouderde informatie
Bronnen worden vernieuwd volgens hun update-interval – je ziet en wijzigt dat rechtstreeks in de bronnentabel (webscrape: elke maand of elke 2 weken; productfeed: elke week, elke dag of elke 12 uur). Het interval kan ook op Uit staan – een bron die Uit staat, wordt nooit vanzelf vernieuwd. Antwoordt Mira dus opeens met verouderde gegevens, kijk dan eerst in de kolom Update-interval. Staan de automatische updates van een feed uit, dan toont het dashboard ook een waarschuwingsbalk.
Bij nieuwe bronnen staan automatische updates standaard aan, en automatische updates zijn beschikbaar met een Mira AI-abonnement. Heb je je website of catalogus gewijzigd, wacht dan op de volgende automatische update of open de bron en klik handmatig op Bijwerken.
Publiceren en de status van bronnen
Eén mislukte bron blokkeert het publiceren van je AI-agent niet. Publiceren wordt alleen geblokkeerd wanneer de agent helemaal geen gereed bron heeft (een webscrape of tekstinhoud), of zolang geselecteerde bronnen nog worden aangemaakt of bijgewerkt. Is de knop Publiceren uitgeschakeld, kijk dan in het gedeelte Kennisbank welke bronnen nog bezig zijn.
Wat is de volgende stap?
Hoe je Mira AI gaat trainen – beheer kennisbronnen en eigen antwoorden.
Productfeeds exporteren – haal een feed-URL op uit je e-commerceplatform.
Introductie tot Mira AI Shopping Assistant – volledige installatie vanaf nul.