Passer au contenu principal

Dépannage des sources de connaissances de Mira AI

Que faire lorsque le flux de produits ou la collecte web échoue — erreurs courantes, leurs causes et leurs solutions.

Écrit par Michal Jindra

Mira AI répond à partir des sources de connaissances que vous connectez — une collecte web, un flux de produits XML, du contenu texte et des réponses personnalisées. Lorsqu'une source échoue, Mira peut cesser 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 façon de les corriger. Vous pouvez voir l'état de chaque source dans la section base de connaissances — une icône d'état à côté du nom de la source affiche les détails lorsque vous passez la souris dessus.


Exigences pour le flux de produits

  • L'URL du flux doit être publiquement accessible (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 aller jusqu'à 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éduites de ce quota, mais une mise à jour ne traite que ce qui a changé depuis la dernière exécution, donc n’en utilise qu’une petite partie. Supprimer un flux et l'ajouter à nouveau traite l'ensemble du flux depuis le début. Si vous avez besoin d'un quota plus grand, contactez notre équipe de support.

  • Chaque élément doit comporter les tags requis : id, nom, description, prix et lien. Les éléments qui en manquent sont ignorés lors du traitement.

  • Chaque élément doit avoir une catégorie assignée — les éléments sans catégorie peuvent être exclus et Mira ne pourra alors pas répondre aux questions sur les produits et les catégories.

Astuce : Avant d'ajouter votre flux, faites-le passer dans un validateur de flux pour détecter les tags manquants dès le départ. Lorsqu’un flux continue d’échouer, la sortie du validateur indique souvent précisément quels éléments posent problème. Vous pouvez valider votre flux ici.


Erreurs courantes des flux de produits

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

Causes habituelles : le fichier de flux dépasse 150 Mo, votre quota de données de flux (50 Mo par défaut) est épuisé, des tags requis sont manquants ou malformé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 navigateur en mode navigation privée sans connexion. Si votre serveur filtre le trafic, autorisez nos adresses IP listées ci-dessus. Si le quota est épuisé, demandez à notre équipe de support de l’augmenter.

« Le délai de téléchargement du 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 se relance à chaque tentative — et vérifiez la vitesse de connexion de votre serveur. Si l’erreur persiste, contactez notre support et nous examinerons le problème.

Avertissement concernant l'absence de catégories

Les éléments sans catégorie sont ignorés et Mira ne peut pas répondre aux questions sur les produits ou les catégories à partir d’eux. Ajoutez d’abord une catégorie à chaque élément du flux. Si la première création du flux se termine par un avertissement sur les catégories alors que vos éléments possèdent bien des catégories, ouvrez le flux et lancez une mise à jour — la deuxième création fonctionne généralement correctement. Sinon, contactez notre support.

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

Les éléments sans tag requis (id, nom, description, prix, lien) sont ignorés sans avertissement, donc le flux peut être prêt alors que certains produits n’y figurent pas. Validez le flux, corrigez les éléments signalés et lancez la mise à jour.

Une mise à jour reste en attente

La création d’un flux peut prendre du temps 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 collecte web

Mira ne trouve pas les 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). La collecte web couvre jusqu'à 50 pages par compte — sélectionnez les pages clés (FAQ, livraison, CGV, principales pages produits) plutôt que tout le site. Si le site bloque totalement les crawlers, vous pouvez quand même finaliser la configuration de votre agent — décrivez votre entreprise dans le champ texte proposé pendant l’intégration, il sera enregistré comme source de contenu texte normale.

Votre hébergement bloque notre crawler ? Certains hébergeurs ont des règles de sécurité qui bloquent les crawlers même lorsque vos pages sont publiques et que nos adresses IP sont autorisées. La source apparaît alors comme non disponible. Si cela arrive, contactez notre équipe de support avec l’URL et nous vérifierons pour vous. En attendant, vous pouvez ajouter les informations clés de ces pages sous forme de contenu texte.

La collecte web prend plusieurs heures

Une collecte web qui dure plusieurs heures est bloquée. Contactez notre support avec l’URL que vous tentez d’analyser et nous examinerons le traitement de notre côté.

Mira répond avec des informations obsolètes

Les sources sont rafraîchies selon leur intervalle de mise à jour — vous pouvez le voir et le modifier directement dans le tableau des sources (collecte web : 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 défini sur Désactivé — une source désactivée ne se rafraîchit jamais automatiquement, donc si Mira commence à répondre à partir de 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 modification de votre site web ou de votre 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 comme bloqué et ne peut pas être modifié. Dès que vous passez à une formule payante, toutes vos sources passent automatiquement à l’intervalle de mise à jour par défaut.


Publication et états des sources

L’échec d’une seule source ne bloque pas la publication de votre agent IA. La publication est bloquée uniquement si l’agent n’a aucune source prête (collecte web ou contenu texte), ou tant que les sources sélectionnées sont 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 ensuite ?

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