Mira AI risponde sfruttando le fonti di conoscenza che colleghi — come web scraping, product feed XML, contenuti testuali o risposte personalizzate. Se una fonte smette di funzionare, Mira potrebbe non rispondere più alle domande sui prodotti o fornire informazioni non aggiornate. In questa guida trovi gli errori più frequenti e come risolverli. Puoi controllare lo stato di ogni fonte nella sezione Knowledge base — accanto al nome della fonte vedi un'icona di stato che mostra i dettagli passando il mouse sopra.
Requisiti per il product feed
L'URL del feed deve essere accessibile pubblicamente (senza bisogno di login). Se usi un firewall, assicurati di autorizzare i nostri indirizzi IP 94.130.187.58 e 188.245.65.74.
Limiti di dimensione: ogni file di feed può pesare fino a 150 MB non compressi (XML o CSV, strutturato come Google Merchant Center o Heureka). Inoltre, ogni account ha un limite sui dati dei feed processati, che di default è 50 MB. Gli aggiornamenti del feed contano su questa quota, ma solo le modifiche rispetto all'ultima versione vengono elaborate, quindi consumi pochissimo. Se elimini un feed e lo aggiungi da capo, verrà rielaborato tutto. Se hai bisogno di più spazio, scrivici pure al supporto.
Ogni articolo deve avere obbligatoriamente i tag: id, nome, descrizione, prezzo e link. Gli articoli senza almeno uno di questi vengono ignorati durante la lavorazione.
Consigliamo di assegnare una categoria a ogni articolo — senza categoria, Mira non potrà rispondere alle domande relative a quel prodotto o categoria.
Consiglio pratico: Prima di collegare il feed, verifica se mancano tag usando un validatore di feed. Quando un feed non funziona, il risultato del validatore di solito indica subito quali articoli danno problemi. Puoi controllare il tuo feed qui.
Errori comuni del product feed
"Impossibile elaborare i dati" / il caricamento non finisce mai
Ecco le cause più probabili: il file del feed supera i 150 MB, hai esaurito la quota di product feed (di default 50 MB), ci sono tag obbligatori mancanti o sbagliati, o l'URL non è pubblico. Valida il feed, verifica la dimensione del file e controlla che si apra in una finestra anonima senza login. Se il server blocca il traffico, autorizza i nostri IP sopra. Per quote esaurite, basta scriverci e le aumentiamo.
"Limite di tempo per lo scaricamento del file scaduto"
Il server che ospita il feed ha risposto troppo lentamente e il download è andato in timeout. Prova ad aggiungere di nuovo il feed — a ogni tentativo la verifica riparte da zero — e controlla la connessione del server. Se l’errore si ripete, scrivici e facciamo un controllo diretto.
Avviso su categorie mancanti
Gli articoli senza categoria vengono saltati e Mira non può rispondere a domande su prodotto o categoria usando quei dati. Assicurati che ogni articolo abbia una categoria assegnata. Se dopo il primo caricamento vedi comunque un allarme sulle categorie, anche se ci sono, apri il feed e premi Aggiorna — di solito alla seconda elaborazione va tutto a posto. Se il problema persiste, contattaci pure.
Il feed è Pronto, ma Mira non trova alcuni prodotti
Gli articoli senza almeno un tag richiesto (id, nome, descrizione, prezzo, link) vengono saltati senza avviso, quindi il feed può risultare Pronto anche se alcuni articoli mancano. Valida il file, correggi gli errori e premi “Aggiorna”.
Un aggiornamento è bloccato su In attesa
L’elaborazione del product feed può richiedere più tempo con cataloghi molto grandi. Se però un aggiornamento resta su In attesa per più di qualche ora, scrivici — possiamo sbloccarlo noi.
Problemi con il web scraping
Mira non trova le pagine del mio sito web
Controlla che tutte le pagine siano pubbliche e accessibili senza login, e che il firewall accetti i nostri IP (94.130.187.58, 188.245.65.74). Il web scraping di solito prende fino a 20 pagine: punta sulle più importanti (FAQ, spedizione, termini, top prodotti), non serve provare a includere tutto il sito. Se il sito blocca completamente i crawler, puoi comunque completare la configurazione: nella fase di onboarding puoi scrivere una descrizione, che verrà salvata come fonte di contenuto testuale.
Ospiti il sito su SiteGround? SiteGround ha regole di sicurezza che possono bloccare il nostro crawler anche se il sito è pubblico e hai autorizzato i nostri IP, in questo caso la fonte resta non disponibile. Chiedi al supporto SiteGround di sbloccare il nostro crawler; se non fosse possibile, copia il testo principale da quelle pagine come Contenuto testuale.
Il web scraping dura ore
Se il web scraping va avanti per ore è probabilmente bloccato. Contattaci inviando l’URL che vuoi analizzare e verifichiamo subito dallo staff.
Mira risponde con informazioni obsolete
Le fonti si aggiornano secondo la frequenza definita — puoi vederla e cambiarla direttamente dalla tabella delle fonti (web scraping: ogni mese o ogni 2 settimane; product feed: ogni settimana, giorno o ogni 12 ore). Puoi anche impostare su Spento — una fonte Spenta non si aggiorna in automatico, quindi se Mira risponde con info vecchie controlla nella colonna Intervallo aggiornamento. Se hai spento gli aggiornamenti automatici di un feed, sopra l'elenco appare una barra arancione con un pulsante per riattivarli.
Le fonti nuove hanno di default gli aggiornamenti automatici accesi, che sono abilitati per chi ha un abbonamento Mira AI. Dopo una modifica al sito o al catalogo, puoi attendere il prossimo aggiornamento automatico oppure aprire la fonte e premere Aggiorna manualmente.
Durante la prova gratuita, gli aggiornamenti automatici restano bloccati su tutte le fonti: la frequenza risulta bloccata e non può essere cambiata. Appena passi a un piano a pagamento, tutte le fonti tornano subito al loro intervallo predefinito.
Pubblicazione e stati delle fonti
Una singola fonte non riuscita non blocca la pubblicazione dell’agente AI. La pubblicazione si blocca solo se l’agente non ha nessuna fonte pronta (web scraping o contenuto testuale), oppure se tutte le fonti scelte sono ancora in fase di creazione o aggiornamento. Se il pulsante Pubblica risulta disabilitato, controlla nella sezione Knowledge base se ci sono fonti ancora in lavorazione.
E ora?
Come iniziare ad addestrare Mira AI — gestisci fonti di conoscenza e risposte personalizzate.
Come esportare product feed — ottieni l'URL del feed dalla tua piattaforma e-commerce.
Introduzione a Mira AI shopping assistant — guida completa alla configurazione da zero.