Vai al contenuto principale

Risoluzione dei problemi delle fonti di conoscenza di Mira AI

Cosa fare quando un product feed o un web scraping non vanno a buon fine — errori più comuni, possibili cause e soluzioni pratiche.

Scritto da Michal Jindra

Mira AI risponde dalle fonti di conoscenza che colleghi — un web scraping, un XML product feed, contenuto di testo e risposte personalizzate. Se una fonte non funziona, Mira potrebbe smettere di rispondere alle domande sui prodotti o dare informazioni non aggiornate. In questa guida trovi gli errori più comuni e come risolverli. Puoi vedere lo stato di ogni fonte nella sezione Knowledge base: un'icona accanto al nome della fonte mostra i dettagli quando ci passi sopra col mouse.


Requisiti per il product feed

  • L’URL del feed deve essere accessibile a tutti (senza login). Se il tuo server usa un firewall, autorizza i nostri indirizzi IP 94.130.187.58 e 188.245.65.74.

  • Limiti di dimensione: un file feed può arrivare a 150 MB non compresso (XML o CSV, struttura Google Merchant Center o Heureka). Inoltre, il tuo account ha una quota di dati del feed processati, 50 MB di default. Gli aggiornamenti del feed contano per questa quota, ma un aggiornamento elabora solo ciò che è cambiato dall’ultima esecuzione, quindi ne usa pochissima. Eliminando e aggiungendo di nuovo un feed, verrà processato da zero. Se ti serve una quota maggiore, contatta il nostro support team.

  • Ogni elemento deve avere i tag obbligatori: id, name, description, price e link. Gli elementi ai quali manca anche solo uno di questi vengono saltati durante la lavorazione.

  • A ogni elemento serve una category assegnata — se manca, l’elemento rischia di essere scartato e Mira non potrà rispondere a domande su prodotti o categorie.

Consiglio: Prima di aggiungere il feed, passalo in un feed validator per trovare subito eventuali tag mancanti. Quando un feed continua a non funzionare, il risultato del validator indica quasi sempre quali elementi sono il problema. Puoi validare il tuo feed qui.


Errori comuni dei product feed

"Impossibile elaborare i dati" / il caricamento non termina mai

I motivi principali sono: il file feed è più grande di 150 MB, la quota dati feed del tuo account (50 MB di default) è esaurita, mancano o sono errati i tag richiesti, oppure l’URL non è pubblicamente accessibile. Valida il feed, verifica la dimensione ed assicurati che l’URL si apra in una finestra incognito senza login. Se il server filtra il traffico, autorizza i nostri indirizzi IP indicati sopra. Se la quota è esaurita, chiedi al nostro support team di aumentarla.

"Il limite di tempo per scaricare il file è scaduto"

Il tuo hosting feed risponde troppo lentamente e il download va in timeout. Prova ad aggiungere di nuovo il feed — il controllo riparte da zero ogni volta — e verifica la velocità della connessione del server. Se l’errore continua, contatta il nostro support team e ci pensiamo noi.

Avviso su category mancante

Gli elementi senza category vengono saltati e Mira non può rispondere a domande sui prodotti o sulle categorie. Prima aggiungi una category a ogni elemento nel feed. Se la prima elaborazione del feed termina con un avviso sulle category anche se gli elementi ce l’hanno, apri il feed e clicca su Update — di solito il secondo tentativo va a buon fine. Altrimenti, contatta pure il nostro support team.

Il feed è Ready, ma Mira non trova alcuni prodotti

Gli elementi a cui manca almeno un required tag (id, name, description, price, link) vengono saltati senza warn, quindi il feed può risultare Ready ma mancare di alcuni prodotti. Valida il feed, correggi gli elementi segnalati e clicca su Update.

Un aggiornamento resta su Pending

L’elaborazione del feed può durare un po’ per cataloghi grandi. Se un update rimane Pending per più di qualche ora, contatta il nostro support team — possiamo riavviare il processo per te.


Problemi di web scraping

Mira non trova le pagine del mio sito

Verifica che le pagine siano accessibili pubblicamente (senza login), e che il firewall consenta i nostri IP (94.130.187.58, 188.245.65.74). Il web scraping copre fino a 50 pagine per account. Quando scansiona il sito, Mira AI seleziona per te le pagine chiave (spedizione, pagamento, resi, FAQ, contatti, condizioni) e esclude login, account, carrello e checkout: controlla che la selezione comprenda tutte le pagine che ti servono e aggiungi quelle mancanti. Le pagine bloccate in robots.txt potrebbero non essere proposte ad eccezione di quelle chiave. I dettagli dei prodotti vanno nel tuo XML product feed, non nel web scraping. Se il sito blocca completamente i crawler, puoi comunque finire di configurare il tuo agente — descrivi la tua azienda nel campo di testo offerto durante l’onboarding, che verrà salvato come fonte di tipo Text content.

Il tuo hosting blocca il nostro crawler? Alcuni provider impostano regole di sicurezza che bloccano i crawler anche se le pagine sono pubbliche e i nostri IP consentiti. La fonte risulterà allora non disponibile. Se succede, contatta il nostro support team con l’URL e controlleremo noi. Intanto puoi aggiungere le informazioni chiave di quelle pagine come Text content.

La scansione resta in corso per ore

Una scansione che va avanti per ore è bloccata. Contatta il nostro support team indicando l’URL che vuoi scanalizzare e controlleremo lo stato dal nostro lato.

Mira risponde con informazioni obsolete

Le fonti si aggiornano secondo il loro Update interval — puoi vedere e cambiare questo valore direttamente nella tabella fonti (web scraping: ogni mese o 2 settimane; product feed: ogni settimana, ogni giorno oppure ogni 12 ore). L’intervallo può anche essere impostato su Off — una fonte Off non si aggiorna mai da sola, quindi se Mira inizia a rispondere con dati vecchi, controlla prima la colonna Update interval. Quando il feed ha automatic update disattivato, sopra all’elenco compare una barra arancio con un pulsante per riattivare gli aggiornamenti.

Le nuove fonti hanno gli automatic update attivi di default, disponibili con qualsiasi abbonamento Mira AI. Dopo aver cambiato il tuo sito o catalogo, puoi aspettare il prossimo aggiornamento automatico oppure aprire la fonte e cliccare su Update manualmente.

Durante la trial, gli automatic update sono bloccati per tutte le fonti: l’intervallo update risulta bloccato e non si può cambiare. Non appena passi a un piano a pagamento, tutte le tue fonti tornano automaticamente all’intervallo update di default.


Pubblicazione e stati delle fonti

Una singola fonte non funzionante non blocca la pubblicazione del tuo agente AI. La pubblicazione viene bloccata solo se l’agente non ha nessuna fonte pronta (un web scraping o un contenuto di testo), oppure se alcune fonti selezionate sono ancora in fase di creazione o aggiornamento. Se il pulsante Pubblica è disabilitato, controlla nella sezione Knowledge base quali fonti sono ancora in corso.


E ora?

Hai ricevuto la risposta alla tua domanda?