Mira AI répond à partir des sources de connaissances que vous connectez : web scrape, flux produits XML, contenu texte et custom responses. Quand une source échoue, Mira peut cesser de répondre aux questions produits ou répondre avec des informations obsolètes. Ce guide couvre les erreurs les plus courantes et leurs solutions. L'état de chaque source est visible dans la section Knowledge base — l'icône d'état à côté du nom affiche les détails au survol.
Prérequis du flux produits
L'URL du flux doit être accessible publiquement (sans connexion). Si votre serveur utilise un pare-feu, autorisez nos adresses IP 94.130.187.58 et 188.245.65.74.
Taille maximale de 50 Mo, au format XML ou CSV (structure Google Merchant Center ou Heureka).
Chaque article a besoin des balises obligatoires : id, name, description, price et link. Les articles auxquels il en manque une sont ignorés lors du traitement.
Chaque article devrait avoir une catégorie — les articles sans catégorie peuvent être écartés, et Mira ne peut alors plus répondre aux questions produits et catégories.
Astuce : avant d'ajouter votre flux, passez-le dans un validateur de flux pour repérer tôt les balises manquantes. Quand un flux échoue à répétition, le validateur montre généralement exactement quels articles posent problème. Vous pouvez valider votre flux ici.
Erreurs courantes du flux produits
« Failed to process data » / l'envoi ne se termine jamais
Causes habituelles : le flux dépasse 50 Mo, des balises obligatoires manquent ou sont mal formées, ou l'URL n'est pas accessible publiquement. Validez le flux, vérifiez sa taille et assurez-vous que l'URL s'ouvre en fenêtre de navigation privée sans connexion. Si votre serveur filtre le trafic, autorisez les adresses IP ci-dessus.
« Le délai de téléchargement du fichier a expiré »
L'hébergement de votre flux a répondu trop lentement et le téléchargement a expiré. Réessayez d'ajouter le flux — la vérification se relance à chaque tentative — et vérifiez la vitesse de connexion de votre serveur. Si l'erreur revient, contactez notre support.
Avertissement sur les catégories manquantes
Les articles sans catégorie sont ignorés et Mira ne peut pas répondre aux questions produits ou catégories à partir d'eux. Ajoutez d'abord une catégorie à chaque article du flux. Si la première compilation se termine par un avertissement de catégories alors que vos articles en ont, ouvrez le flux et lancez Update — la deuxième passe généralement. Sinon, contactez notre support.
Le flux est Ready, mais Mira ne trouve pas certains produits
Les articles sans balise obligatoire (id, name, description, price, link) sont ignorés silencieusement — le flux peut donc être Ready alors que des produits manquent. Validez le flux, corrigez les articles signalés et lancez Update.
Une mise à jour reste en Pending
Les compilations peuvent prendre du temps pour les grands catalogues. Si une mise à jour reste en Pending plus de quelques heures, contactez notre support — nous relancerons le traitement.
Problèmes de web scrape
Mira ne trouve pas les pages de mon site
Vérifiez que les pages sont accessibles publiquement sans connexion et que votre pare-feu autorise nos IP (94.130.187.58, 188.245.65.74). Un scrape couvre jusqu'à 20 pages — choisissez les pages clés (FAQ, livraison, CGV, pages produits principales) plutôt que tout.
Le scraping tourne pendant des heures
Un scrape qui tourne pendant des heures est bloqué. Contactez notre support avec l'URL que vous essayez d'analyser et nous vérifierons le traitement de notre côté.
Mira répond avec des informations obsolètes
Les sources se rafraîchissent selon leur Update interval — visible et modifiable directement dans le tableau des sources (web scrape : chaque mois ou toutes les 2 semaines ; flux produits : jusqu'à deux fois par jour). Après un changement de site ou de catalogue, attendez la prochaine mise à jour automatique ou ouvrez la source et lancez Update manuellement.
Publication et états des sources
Une seule source en échec ne bloque pas la publication de votre agent IA. La publication n'est bloquée que si aucun web scrape n'est prêt, ou pendant la création ou mise à jour de sources sélectionnées. Si le bouton Publish est désactivé, vérifiez dans la Knowledge base les sources encore en cours.
Et ensuite ?
Comment entraîner Mira AI — gérer les sources de connaissances et les custom responses.
Comment exporter des flux produits — obtenir l'URL du flux depuis votre plateforme e-commerce.
Introduction à Mira AI — configuration complète de zéro.