Passer au contenu principal

Dépannage des sources de connaissances Mira AI

Que faire si un flux de produits ou un web scrape échoue — erreurs fréquentes, explications et solutions concrètes.

Écrit par Michal Jindra

Mira AI répond grâce aux sources de connaissances que vous connectez — un web scrape, un flux de produits XML, un contenu texte ou des réponses personnalisées. En cas d’échec d’une source, Mira peut arrêter de répondre aux questions sur les produits ou bien fournir des informations dépassées. Ce guide présente les problèmes les plus fréquents et les solutions pour chaque situation. À tout moment, l’état de chaque source s’affiche dans la section Base de connaissances — une icône de statut à côté du nom de la source vous donne le détail au survol.


Exigences pour le flux de produits

  • L’URL du flux doit être publique et accessible à tous (sans connexion requise). Si le serveur utilise un pare-feu, pensez à autoriser nos adresses IP 94.130.187.58 et 188.245.65.74.

  • Limites de taille : le fichier du flux peut atteindre 150 Mo non compressé (XML ou CSV, Google Merchant Center ou structure Heureka). Votre compte dispose aussi d’un quota de données de flux traitées, fixé à 50 Mo par défaut. Les mises à jour du flux sont comptabilisées dans ce quota, mais chaque mise à jour ne traite que ce qui a changé depuis le dernier passage, donc cela consomme très peu. Pour traiter à nouveau l’ensemble du flux, supprimez-le puis ajoutez-le. Besoin d’augmenter votre quota ? Contactez notre équipe support.

  • Chaque élément du flux doit comporter ces balises obligatoires : id, nom, description, prix et lien. Les éléments incomplets sont ignorés lors du traitement.

  • Chaque article doit être associé à une catégorie : ceux qui n’en ont pas risquent d’être écartés et Mira ne pourra pas répondre aux questions portant sur ces produits ou leurs catégories.

Astuce : avant d’ajouter votre flux, vérifiez-le avec un validateur de flux pour repérer dès le départ les balises manquantes. Si un flux continue d’échouer, le rapport du validateur précise souvent exactement les éléments à problème. Vous pouvez valider votre flux ici.


Erreurs courantes du flux de produits

« Échec du traitement des données » / le téléchargement n’aboutit jamais

Causes principales : le fichier du flux dépasse 150 Mo, votre quota de données de flux (50 Mo par défaut) est consommé, des balises obligatoires sont absentes ou mal formatées, ou l’URL n’est pas publique. Validez le flux, contrôlez sa taille et assurez-vous que l’URL s’ouvre dans une fenêtre de navigateur privée sans authentification. Si le serveur filtre le trafic, autorisez nos adresses IP indiquées ci-dessus. Si le quota est épuisé, demandez à notre équipe support de l’augmenter.

« Le délai de téléchargement du fichier a expiré »

L’hébergement de votre flux a mis trop de temps à répondre et le téléchargement a expiré. Essayez d’ajouter le flux à nouveau — chaque tentative relance la vérification — et vérifiez la vitesse de connexion de votre serveur. Si l’erreur persiste, contactez notre support et nous enquêterons.

Avertissement concernant des catégories manquantes

Les éléments sans catégorie sont ignorés, et Mira ne pourra pas répondre aux questions produits ou catégories à leur sujet. Ajoutez une catégorie à chaque article du flux. Si la première création du flux affiche un avertissement de catégorie alors que vos articles ont bien une catégorie, ouvrez le flux et lancez une mise à jour — la seconde construction aboutit généralement. Sinon, contactez notre support.

Le flux est prêt, mais Mira ne trouve pas certains produits

Les éléments sans l’une des balises obligatoires (id, nom, description, prix, lien) sont ignorés en silence, si bien que le flux peut être Prêt alors que certains produits n’y figurent pas. Passez le flux au validateur, corrigez les articles concernés, puis lancez la mise à jour.

Une mise à jour reste sur En attente

La construction du flux peut être longue pour de gros catalogues. Si une mise à jour reste « En attente » plus de quelques heures, contactez notre support — nous pouvons relancer le traitement pour vous.


Problèmes de web scrape

Mira ne trouve pas de pages de mon site web

Vérifiez que les pages sont accessibles publiquement sans authentification, et que votre pare-feu autorise nos adresses IP (94.130.187.58, 188.245.65.74). Le web scraping permet d’analyser jusqu’à 50 pages par compte. Lors du scan, Mira AI présélectionne les pages clés pour vous (livraison, paiement, retours, FAQ, contact, conditions) et exclut les pages de connexion, de compte, de panier et de paiement : vérifiez la sélection et ajoutez toute page qui manquerait. Les pages bloquées dans le robots.txt de votre site ne seront pas proposées, sauf les pages fondamentales comme la livraison ou les conditions. Les informations sur les produits doivent se trouver dans le flux de produits XML, et non dans le web scrape. Si le site bloque totalement les crawlers, il est tout de même possible d’achever la configuration de votre agent — décrivez votre entreprise dans le champ de texte proposé pendant l’onboarding, il sera enregistré comme source de contenu texte.

Votre hébergeur bloque notre crawler ? Certains hébergeurs appliquent des règles de sécurité qui bloquent les crawlers, même si vos pages sont publiques et que nos IP sont autorisées. La source apparaît alors comme non disponible. Si cela se produit, contactez notre équipe support avec l’URL concernée et nous la vérifierons pour vous. En attendant, vous pouvez ajouter les informations essentielles de ces pages en tant que contenu texte.

Le scraping dure plusieurs heures

Un web scrape qui dure plusieurs heures est bloqué. Contactez notre support avec l’URL que vous essayiez d’analyser, nous vérifierons le traitement serveur.

Mira répond avec des informations dépassées

Les sources sont actualisées selon leur intervalle de mise à jour — vous pouvez le consulter et le modifier dans le tableau des sources (web scrape : chaque mois ou toutes les 2 semaines ; flux de produits : chaque semaine, chaque jour ou toutes les 12 heures). L’intervalle peut aussi être réglé sur Désactivé — une source « Désactivée » ne s’actualise jamais toute seule ; si Mira commence à fournir des réponses obsolètes, vérifiez d’abord la colonne Intervalle de mise à jour. Quand les mises à jour automatiques du flux sont désactivées, une barre orange d’avertissement apparaît au-dessus de la liste du flux, avec un bouton pour les réactiver.

Les nouvelles sources démarrent avec les mises à jour automatiques activées par défaut, et ces mises à jour sont disponibles avec un abonnement Mira AI. Après avoir modifié votre site ou catalogue, attendez simplement la prochaine actualisation automatique ou ouvrez la source et lancez Mettre à jour manuellement.

Durant la période d’essai, les mises à jour automatiques sont bloquées pour toutes les sources : l’intervalle d’actualisation s’affiche comme bloqué et ne peut pas être changé. Dès que vous passez à un forfait payant, toutes vos sources passent automatiquement à l’intervalle d’actualisation par défaut.


Publication et états des sources

Une source en échec ne bloque pas la publication de votre agent IA. La publication ne sera bloquée que si l’agent n’a aucune source prête (web scrape ou contenu texte), ou si les sources sélectionnées sont toutes en cours de création ou de mise à jour. Si le bouton Publier est désactivé, vérifiez la section Base de connaissances pour identifier les sources encore en cours de traitement.


Quelles sont les prochaines étapes ?

Avez-vous trouvé la réponse à votre question ?