Mira AI risponde dalle fonti di conoscenza che colleghi: web scrape, feed prodotti XML, contenuti di testo e custom responses. Quando una fonte fallisce, Mira può smettere di rispondere alle domande sui prodotti o rispondere con informazioni obsolete. Questa guida copre gli errori più comuni e come risolverli. Lo stato di ogni fonte è visibile nella sezione Knowledge base: l'icona di stato accanto al nome mostra i dettagli al passaggio del mouse.
Requisiti del feed prodotti
L'URL del feed deve essere accessibile pubblicamente (senza login). Se il tuo server usa un firewall, consenti i nostri indirizzi IP 94.130.187.58 e 188.245.65.74.
Dimensione massima 50 MB, in formato XML o CSV (struttura Google Merchant Center o Heureka).
Ogni articolo richiede i tag obbligatori: id, name, description, price e link. Gli articoli a cui ne manca uno vengono saltati durante l'elaborazione.
Ogni articolo dovrebbe avere una categoria assegnata: gli articoli senza categoria possono essere scartati e Mira non può rispondere a domande su prodotti e categorie.
Suggerimento: prima di aggiungere il feed, passalo in un validatore di feed per individuare presto i tag mancanti. Quando un feed fallisce ripetutamente, l'output del validatore mostra di solito esattamente quali articoli sono il problema. Puoi validare il tuo feed qui.
Errori comuni del feed prodotti
"Failed to process data" / il caricamento non finisce mai
Cause abituali: il feed supera i 50 MB, mancano tag obbligatori o sono malformati, oppure l'URL non è accessibile pubblicamente. Valida il feed, controlla la dimensione e assicurati che l'URL si apra in una finestra di navigazione in incognito senza login. Se il tuo server filtra il traffico, consenti gli indirizzi IP sopra indicati.
"Il limite di tempo per scaricare il file è scaduto"
L'hosting del tuo feed ha risposto troppo lentamente e il download è scaduto. Prova ad aggiungere di nuovo il feed (il controllo viene rieseguito a ogni tentativo) e verifica la velocità di connessione del server. Se l'errore si ripete, contatta il nostro supporto.
Avviso sulle categorie mancanti
Gli articoli senza categoria vengono saltati e Mira non può rispondere a domande su prodotti o categorie a partire da essi. Aggiungi prima una categoria a ogni articolo del feed. Se la prima compilazione termina con un avviso sulle categorie anche se gli articoli le hanno, apri il feed ed esegui Update: la seconda compilazione di solito va a buon fine. In caso contrario, contatta il nostro supporto.
Il feed è Ready, ma Mira non trova alcuni prodotti
Gli articoli senza un tag obbligatorio (id, name, description, price, link) vengono saltati silenziosamente: il feed può quindi essere Ready anche se mancano prodotti. Valida il feed, correggi gli articoli segnalati ed esegui Update.
Un aggiornamento è bloccato su Pending
Le compilazioni possono richiedere tempo per i cataloghi grandi. Se un aggiornamento resta in Pending per più di qualche ora, contatta il nostro supporto: riavvieremo l'elaborazione per te.
Problemi con il web scrape
Mira non trova le pagine del mio sito
Controlla che le pagine siano accessibili pubblicamente senza login e che il firewall consenta i nostri IP (94.130.187.58, 188.245.65.74). Uno scrape copre fino a 20 pagine: scegli quelle chiave (FAQ, spedizioni, condizioni, pagine prodotto principali) invece di tutte.
La scansione dura ore
Uno scrape che dura ore è bloccato. Contatta il nostro supporto con l'URL che stai cercando di scansionare e verificheremo l'elaborazione dal nostro lato.
Mira risponde con informazioni obsolete
Le fonti si aggiornano secondo il loro Update interval, visibile e modificabile direttamente nella tabella delle fonti (web scrape: ogni mese o ogni 2 settimane; feed prodotti: fino a due volte al giorno). Dopo aver modificato sito o catalogo, attendi il prossimo aggiornamento automatico oppure apri la fonte ed esegui Update manualmente.
Pubblicazione e stati delle fonti
Una singola fonte fallita non blocca la pubblicazione del tuo agente IA. La pubblicazione è bloccata solo quando nessun web scrape è pronto o mentre le fonti selezionate sono ancora in creazione o aggiornamento. Se il pulsante Publish è disattivato, controlla nella Knowledge base quali fonti sono ancora in corso.
E adesso?
Come iniziare ad addestrare Mira AI — gestisci fonti di conoscenza e custom responses.
Come esportare i feed prodotti — ottieni l'URL del feed dalla tua piattaforma e-commerce.
Introduzione a Mira AI — configurazione completa da zero.