Mira AI fornisce risposte basandosi sulle fonti di conoscenza che colleghi — un web scrape, un XML product feed, contenuti testuali e Risposte personalizzate. Se una fonte ha problemi, Mira potrebbe smettere di rispondere alle domande sui prodotti o mostrare informazioni vecchie. Qui trovi gli errori più comuni e le soluzioni. Puoi vedere lo stato di ogni fonte nella sezione Knowledge base: un'icona colorata vicino al nome mostra i dettagli quando ci passi col mouse sopra.
Requisiti per il product feed
L’URL del feed deve essere pubblico (senza login richiesto). Se usi un firewall, autorizza i nostri IP 94.130.187.58 e 188.245.65.74.
Limiti di dimensione: ogni file del feed può essere fino a 150 MB non compresso (XML o CSV, Google Merchant Center o Heureka). Inoltre, il tuo account ha una quota di dati elaborati, 50 MB di default. Gli aggiornamenti del feed contano verso questa quota, ma ogni aggiornamento elabora solo ciò che è cambiato dall’ultima esecuzione, quindi si consuma poca quota. Eliminando e aggiungendo di nuovo un feed viene rianalizzato tutto da capo. Se hai bisogno di una quota maggiore, contatta il nostro supporto.
Ogni articolo deve avere i tag richiesti: id, name, description, price e link. Gli articoli a cui manca anche solo uno di questi vengono ignorati durante l’analisi.
Ogni articolo dovrebbe avere assegnata una categoria — gli articoli senza categoria possono essere scartati e Mira poi non può rispondere alle domande su prodotto e categoria.
Consiglio: prima di aggiungere il tuo feed, passalo tramite un validatore di feed per individuare subito eventuali tag mancanti. Quando un feed non funziona ancora, il risultato del validatore di solito mostra esattamente quali articoli presentano problemi. Puoi validare il tuo feed qui.
Errori comuni dei product feed
"Impossibile elaborare i dati" / il caricamento non termina mai
Le cause più frequenti: il file del feed supera i 150 MB, la tua quota dati per il feed (50 MB di default) è stata esaurita, mancano o sono errati i tag richiesti, oppure l’URL non è pubblico. Valida il feed, controlla la dimensione del file, assicurati che l’URL si apra in una finestra in incognito senza effettuare il login. Se il server filtra il traffico, autorizza i nostri IP elencati sopra. Se la quota è esaurita, chiedi subito al nostro supporto di aumentarla.
"Limite di tempo per il download del file scaduto"
Il tuo server per il feed ha risposto troppo lentamente e il download è andato in timeout. Prova ad aggiungere di nuovo il feed — ogni tentativo fa ripartire il controllo — e verifica la velocità di connessione del tuo server. Se l’errore si ripresenta, contatta il nostro supporto e verificheremo insieme.
Avviso sulle categorie mancanti
Gli articoli senza una categoria sono ignorati e Mira non può rispondere su prodotto o categoria. Prima aggiungi una categoria a ogni articolo del feed. Se, alla fine della prima analisi del feed, ricevi ancora l’avviso sulle categorie pur avendole inserite, apri il feed e clicca su Aggiorna — la seconda elaborazione in genere va a buon fine. Se invece persiste, contatta il nostro supporto.
Il feed è pronto, ma Mira non trova alcuni prodotti
Gli articoli a cui manca anche solo un tag richiesto (id, name, description, price, link) vengono ignorati in silenzio, così il feed può risultare pronto anche se mancano dei prodotti. Valida il feed, correggi gli elementi segnalati e aggiorna.
Aggiornamento bloccato su In attesa
L’elaborazione del feed può richiedere tempo per cataloghi molto grandi. Se un aggiornamento resta in Attesa per più di qualche ora, contatta subito il nostro supporto — possiamo riavviare l’elaborazione per te.
Problemi con il web scrape
Mira non trova le pagine del tuo sito web
Controlla che le pagine siano pubbliche senza login e che il firewall consenta i nostri IP (94.130.187.58, 188.245.65.74). Un singolo web scrape copre fino a 20 pagine — scegli quelle chiave (FAQ, spedizioni, termini, principali pagine prodotto) invece di tutte. Se il sito blocca i crawler interamente, puoi comunque completare la configurazione dell’agente — descrivi la tua azienda nel campo di testo durante l’onboarding, verrà salvata come classica fonte di contenuti testuali.
Il tuo hosting sta bloccando il nostro crawler? Alcuni provider aggiungono regole di sicurezza che bloccano i crawler anche quando le pagine sono pubbliche e i nostri IP sono consentiti. La fonte risulterà quindi non disponibile. Se succede, contattaci con l’URL e la controlleremo per te. Nel frattempo puoi aggiungere manualmente le informazioni chiave da quelle pagine come contenuto testuale.
Il web scraping dura ore
Se lo scraping dura ore, si è bloccato. Contatta subito il nostro supporto con la URL da scansionare e controlleremo l’elaborazione dal nostro lato.
Mira risponde con informazioni vecchie
Le fonti si aggiornano secondo il proprio intervallo di Update — puoi vederlo e cambiarlo direttamente nella tabella delle fonti (web scrape: ogni mese o ogni 2 settimane; product feed: ogni settimana, ogni giorno o ogni 12 ore). Puoi impostare anche su Off — una fonte con Off non si aggiorna mai in automatico, quindi se Mira risponde con dati obsoleti, controlla prima la colonna Intervallo aggiornamento. Quando gli aggiornamenti automatici del feed sono disattivati, compare una barra arancione sopra la lista con un pulsante per riattivarli.
Le nuove fonti hanno gli aggiornamenti automatici attivi di default, disponibili con abbonamento Mira AI. Dopo aver cambiato sito web o catalogo, o aspetti il prossimo aggiornamento o apri la fonte e avvia Aggiorna manualmente.
Durante la trial, gli aggiornamenti automatici sono bloccati per tutte le fonti: l’intervallo aggiornamento risulterà bloccato e non modificabile. Appena passi a un piano a pagamento tutte le fonti avranno di default l’intervallo automatico.
Pubblicazione e stati delle fonti
Una singola fonte non riuscita non blocca la pubblicazione del tuo agente AI. La pubblicazione viene bloccata solo quando l’agente non ha nessuna fonte pronta (web scrape o contenuti testuali), oppure mentre le fonti selezionate sono ancora in fase di creazione o aggiornamento. Se il bottone Pubblica è disabilitato, controlla le fonti ancora in progresso nella sezione Knowledge base.
E ora?
Come iniziare a trainare Mira AI — gestisci fonti di conoscenza e Risposte personalizzate.
Come esportare i product feed — ottieni la URL del feed dalla tua piattaforma e-commerce.
Introduzione a Mira AI Shopping Assistant — configurazione completa da zero.


