Passer au contenu principal

Dépannage des sources de connaissances Mira AI

Que faire lorsqu'un flux de produits ou un web scrape échoue — erreurs courantes, leurs causes et solutions.

Écrit par Michal Jindra

Mira AI répond à partir des sources de connaissances que vous connectez — un web scrape, un flux de produits XML, un contenu texte et des réponses personnalisées. Lorsqu'une source échoue, Mira peut arrêter de répondre aux questions sur les produits ou répondre avec des informations obsolètes. Ce guide couvre les erreurs les plus courantes et la manière de les résoudre. Vous pouvez voir l'état de chaque source dans la section base de connaissances — une icône de statut à côté du nom de la source affiche les détails lorsque vous passez la souris dessus.


Exigences du flux de produits

  • L’URL du flux doit être accessible publiquement (aucune connexion requise). Si votre serveur utilise un pare-feu, autorisez nos adresses IP 94.130.187.58 et 188.245.65.74.

  • Limites de taille : un fichier de flux peut atteindre 150 Mo non compressé (XML ou CSV, structure Google Merchant Center ou Heureka). De plus, votre compte dispose d’un quota de données de flux traitées, 50 Mo par défaut. Les mises à jour du flux sont décomptées de ce quota, mais une mise à jour ne traite que ce qui a changé depuis la dernière exécution, elle en utilise donc très peu. Supprimer un flux et le rajouter traite la totalité du flux depuis le début. Si vous avez besoin d’un quota plus élevé, contactez notre équipe support.

  • Chaque article doit comporter les tags requis : id, name, description, price et link. Les articles dont l'un de ces tags manque sont ignorés lors du traitement.

  • Chaque article devrait avoir une catégorie assignée — les articles sans catégorie peuvent être ignorés, et Mira ne pourra alors pas répondre aux questions sur les produits ou les catégories.

Conseil : avant d’ajouter votre flux, passez-le dans un validateur de flux pour détecter rapidement les tags manquants. Lorsqu’un flux échoue systématiquement, le résultat du validateur indique généralement les articles problématiques. Vous pouvez valider votre flux ici.


Erreurs courantes de flux de produits

"Échec du traitement des données" / le téléchargement ne se termine jamais

Les causes habituelles : le fichier du flux est supérieur à 150 Mo, votre quota de données de flux (50 Mo par défaut) est épuisé, des tags requis sont manquants ou déformés, ou l’URL n’est pas accessible publiquement. Validez le flux, vérifiez sa taille, et assurez-vous que l’URL s’ouvre dans une fenêtre de navigation privée sans connexion. Si votre serveur filtre le trafic, autorisez nos adresses IP indiquées ci-dessus. Si le quota est atteint, demandez à notre support de l’augmenter.

"Le délai pour télécharger le fichier est dépassé"

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

Avertissement concernant l'absence de catégories

Les articles sans catégorie sont ignorés et Mira ne peut pas répondre à des questions sur les produits ou catégories à partir de ceux-ci. Commencez par ajouter une catégorie à chaque article du flux. Si la première construction du flux se termine par un avertissement sur les catégories même si vos articles ont bien des catégories, 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 articles auxquels il manque un tag requis (id, name, description, price, link) sont silencieusement ignorés, donc le flux peut être prêt alors que certains produits ne sont pas inclus. Validez le flux, corrigez les articles signalés et lancez une mise à jour.

Une mise à jour reste en attente

Le traitement d’un flux peut être long pour de grands catalogues. Si une mise à jour reste en attente pendant plusieurs heures, contactez notre support — nous pouvons relancer le traitement pour vous.


Problèmes de web scrape

Mira ne trouve pas certaines pages de mon site web

Vérifiez que les pages sont accessibles publiquement sans connexion, et que votre pare-feu autorise nos adresses IP (94.130.187.58, 188.245.65.74). Un web scrape couvre jusqu’à 20 pages — choisissez les principales (FAQ, livraison, conditions, pages produits principales) plutôt que toutes. Si le site bloque complètement les robots, vous pouvez quand même terminer la configuration de votre agent — décrivez votre entreprise dans le champ de texte proposé lors de l’onboarding, il sera enregistré comme une source de contenu texte classique.

Hébergé chez SiteGround ? Les règles de sécurité de SiteGround peuvent bloquer notre robot même lorsque vos pages sont publiques et nos adresses IP autorisées, ce qui fait que la source apparaît comme indisponible. Demandez au support SiteGround d’autoriser notre robot. S’ils ne peuvent pas, ajoutez les informations clés de ces pages comme contenu texte à la place.

Le web scrape tourne pendant des heures

Un web scrape qui dure 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 mettent à jour selon leur intervalle de mise à jour — vous pouvez le voir et le modifier directement dans le tableau des sources (web scrape : tous les mois ou toutes les 2 semaines ; flux de produits : chaque semaine, chaque jour, ou toutes les 12 heures). L’intervalle peut également être réglé sur Désactivé — une source désactivée ne se met jamais à jour automatiquement, donc si Mira commence à répondre avec des données obsolètes, vérifiez d'abord la colonne Intervalle de mise à jour. Lorsque la mise à jour automatique d'un flux est désactivée, une barre d'avertissement orange apparaît au-dessus de la liste des flux, avec un bouton pour réactiver les mises à jour.

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

Pendant un essai, les mises à jour automatiques sont bloquées pour toutes les sources : l’intervalle de mise à jour apparaît bloqué et ne peut pas être modifié. Dès que vous passez à un forfait payant, toutes vos sources sont automatiquement basculées sur l’intervalle de mise à jour par défaut.


Publication et états des sources

Une seule source défaillante n’empêche pas la publication de votre agent IA. La publication est bloquée uniquement si l’agent n’a aucune source prête du tout (web scrape ou contenu texte), ou si les sources sélectionnées sont encore en cours de création ou de mise à jour. Si le bouton Publier est désactivé, vérifiez la section base de connaissances pour les sources encore en cours de traitement.


Et après ?

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