Vai al contenuto principale

Risoluzione dei problemi sulle fonti di conoscenza di Mira AI

Ecco cosa puoi fare se un feed di prodotti o un web scraping non vanno a buon fine: errori più frequenti, cause e soluzioni.

Scritto da Michal Jindra

Mira AI risponde usando le fonti di conoscenza che colleghi: web scraping, feed prodotti XML, contenuti testuali o risposte personalizzate. Se una fonte ha problemi, Mira potrebbe non rispondere più alle domande sui prodotti o dare informazioni non aggiornate. In questa guida trovi gli errori più comuni e come sistemarli. Puoi vedere lo stato di ogni fonte nella sezione Knowledge base: vicino al nome della fonte c’è un’icona di stato con i dettagli che puoi visualizzare passandoci sopra con il mouse.


Requisiti del feed prodotti

  • L'URL del feed deve essere accessibile pubblicamente (senza necessità di login). Se usi un firewall sul server, assicurati che gli indirizzi IP 94.130.187.58 e 188.245.65.74 siano autorizzati.

  • Limiti di dimensione: ogni file feed può pesare fino a 150 MB non compressi (XML o CSV, struttura Google Merchant Center o Heureka). Il tuo account ha anche una quota massima di dati processabili dal feed, generalmente 50 MB. Gli aggiornamenti del feed vanno a scalare questa quota, ma solo per le modifiche dall’ultimo aggiornamento, così ne consumano pochissima. Rimuovere e reinserire un feed lo rielabora da capo. Ti serve più spazio? Scrivici pure al supporto.

  • Ogni elemento deve avere i tag richiesti: id, nome, descrizione, prezzo e link. Gli elementi che non li hanno vengono saltati durante l’analisi.

  • Ogni elemento dovrebbe avere una categoria assegnata: senza categoria, rischiano di essere esclusi e Mira non riesce a rispondere alle domande su quei prodotti e categorie.

Consiglio: Prima di aggiungere il feed, passalo da un validatore: così scopri subito se manca qualche tag. Se il feed continua a non funzionare, di solito il validatore mostra esattamente quali elementi danno problemi. Puoi controllare il feed qui.


Errori frequenti dei feed prodotti

"Impossibile elaborare i dati" / il caricamento resta infinito

Ecco i motivi più tipici: il file è più grande di 150 MB, hai esaurito la quota dati feed (che di base è 50 MB), mancano i tag richiesti oppure l’URL non è raggiungibile pubblicamente. Controlla il feed con un validatore, verifica la dimensione e prova ad aprire l’URL da una finestra anonima del browser, senza login. Se hai un firewall, aggiungi i nostri IP tra quelli autorizzati. Se la quota è terminata, chiedici di aumentarla e ti aiutiamo noi.

"Timeout durante il download del file"

L’hosting del feed ha impiegato troppo e il download è stato interrotto. Prova ad aggiungere di nuovo il feed: ogni tentativo rifà i controlli. Verifica anche la connessione del server. Se l’errore si ripete, contattaci e ci pensiamo noi.

Avviso: categorie mancanti

Gli elementi senza categoria vengono saltati: Mira poi non può rispondere alle domande su quei prodotti o categorie. Assicurati di assegnare una categoria a ogni elemento. Se la prima analisi del feed ti segnala categorie mancanti anche se le hai inserite, apri il feed e clicca su Aggiorna: di solito la seconda analisi va a buon fine. Se resta il problema, contattaci.

Il feed risulta pronto ma Mira non trova alcuni prodotti

Gli elementi senza tutti i tag necessari (id, nome, descrizione, prezzo, link) vengono ignorati senza segnalazioni: per questo un feed può essere Pronto ma alcuni prodotti mancano. Passa il feed al validatore, correggi gli errori segnalati e clicca su Aggiorna.

Un aggiornamento è bloccato su In sospeso

L’elaborazione può richiedere tempo sui cataloghi grandi. Se un aggiornamento rimane in sospeso per più di qualche ora, scrivici: possiamo riavviare il processo velocemente.


Problemi con il web scraping

Mira non trova le pagine del mio sito

Assicurati che le pagine siano visibili senza login e che il firewall permetta i nostri IP (94.130.187.58, 188.245.65.74). Puoi indicare fino a 50 pagine da analizzare per account: scegli le più importanti (FAQ, spedizioni, termini, pagine prodotto principali). Se il sito blocca totalmente i crawler, puoi comunque completare la configurazione inserendo una descrizione della tua azienda nell’apposito campo: verrà salvata come fonte testuale.

L’hosting blocca il nostro crawler? Alcuni provider bloccano i bot anche se il sito è pubblico e i nostri IP autorizzati: in questi casi la fonte risulta non disponibile. Se ti succede, scrivici con l’URL e verifichiamo noi. Intanto puoi aggiungere i contenuti importanti come fonte testuale.

Lo scraping dura ore

Se lo scraping va avanti per ore vuol dire che è bloccato. Scrivici l'URL, così possiamo controllare e sbloccare la situazione dal nostro lato.

Mira risponde con informazioni vecchie

Le fonti si aggiornano secondo il loro intervallo di aggiornamento, che puoi vedere e cambiare direttamente nella tabella delle fonti (web scraping: ogni mese o ogni 2 settimane; feed prodotti: ogni settimana, ogni giorno o ogni 12 ore). Puoi anche impostare su Off: in questo modo la fonte non si aggiorna mai da sola, quindi se noti informazioni vecchie controlla subito la colonna dell’intervallo. Se gli aggiornamenti automatici sono disattivati, ti appare una barra di avviso arancione sopra l’elenco dei feed e un pulsante per riattivarli.

Le nuove fonti hanno gli aggiornamenti automatici attivi di default e sono disponibili con un abbonamento Mira AI. Dopo aver fatto modifiche al sito o al catalogo, puoi attendere il prossimo aggiornamento automatico oppure aprire la fonte e cliccare su Aggiorna.

Durante la prova gratis, gli aggiornamenti automatici sono bloccati su tutte le fonti: l’intervallo di aggiornamento risulta fisso e non puoi modificarlo. Appena passi a un piano a pagamento, tutte le fonti si aggiornano automaticamente all’intervallo predefinito.


Pubblicazione e stati delle fonti

Se una fonte fallisce da sola, non blocca la pubblicazione del tuo agente AI. Il pubblica viene bloccato solo se l’agente non ha nessuna fonte pronta (web scraping o contenuti testuali) o se tutte le fonti selezionate sono ancora in fase di creazione o aggiornamento. Se il pulsante Pubblica è disattivato, controlla nella Knowledge base se ci sono fonti ancora in lavorazione.


E ora?

Hai ricevuto la risposta alla tua domanda?