Vai al contenuto principale

Risoluzione dei problemi delle fonti di conoscenza di Mira AI

Cosa fare quando un feed del prodotto o un web scraping non riesce — errori comuni, cause e soluzioni.

Scritto da Michal Jindra

Mira AI risponde utilizzando le fonti di conoscenza che colleghi — un web scraping, un feed del prodotto XML, contenuti testuali e risposte personalizzate. Quando una fonte non funziona, Mira potrebbe smettere di rispondere alle domande sui prodotti o fornire informazioni obsolete. Questa guida illustra gli errori più comuni e come risolverli. Puoi vedere lo stato di ogni fonte nella sezione Base di conoscenza — un'icona di stato accanto al nome della fonte mostra i dettagli quando ci passi sopra con il mouse.


Requisiti del feed del prodotto

  • L'URL del feed deve essere accessibile pubblicamente (senza richiedere l'accesso). Se il tuo server utilizza un firewall, consenti i nostri indirizzi IP 94.130.187.58 e 188.245.65.74.

  • La dimensione massima è di 50 MB, in formato XML o CSV (struttura Google Merchant Center o Heureka).

  • Ogni elemento deve includere i tag obbligatori: id, name, description, price e link. Gli elementi privi di uno di questi tag vengono ignorati durante l'elaborazione.

  • Ogni elemento dovrebbe avere una categoria assegnata — gli elementi senza categoria possono essere esclusi e Mira non può quindi rispondere alle domande sui prodotti e sulle categorie.

Suggerimento: prima di aggiungere il feed, controllalo con un validatore di feed per individuare subito i tag mancanti. Quando un feed continua a non funzionare, il risultato del validatore solitamente mostra esattamente quali elementi causano il problema. Puoi convalidare il tuo feed Qui.


Errori comuni del feed del prodotto

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

Le cause più comuni: il feed supera i 50 MB, i tag obbligatori sono mancanti o non correttamente formati oppure l'URL non è accessibile pubblicamente. Convalida il feed, controllane le dimensioni e assicurati che l'URL si apra in una finestra di navigazione in incognito del browser senza effettuare l'accesso. Se il tuo server filtra il traffico, consenti i nostri indirizzi IP elencati sopra.

"Il tempo limite per il download del file è scaduto"

Il servizio che ospita il tuo feed ha risposto troppo lentamente e il download ha superato il tempo limite. Prova ad aggiungere di nuovo il feed — il controllo viene eseguito nuovamente a ogni tentativo — e verifica la velocità di connessione del tuo server. Se l'errore continua a ripresentarsi, contatta la nostra assistenza e approfondiremo il problema.

Avviso sulle categorie mancanti

Gli elementi senza categoria vengono ignorati e Mira non può utilizzarli per rispondere alle domande sui prodotti o sulle categorie. Per prima cosa, aggiungi una categoria a ogni elemento del feed. Se la prima elaborazione del feed termina con un avviso sulle categorie anche se i tuoi elementi hanno una categoria, apri il feed ed esegui Aggiorna — la seconda elaborazione solitamente si completa correttamente. In caso contrario, contatta la nostra assistenza.

Il feed è Pronto, ma Mira non riesce a trovare alcuni prodotti

Gli elementi privi di un tag obbligatorio (id, name, description, price, link) vengono ignorati senza alcuna segnalazione, quindi il feed può risultare Pronto anche se alcuni prodotti non sono presenti. Convalida il feed, correggi gli elementi segnalati ed esegui Aggiorna.

Un aggiornamento è bloccato su In attesa

L'elaborazione dei feed può richiedere del tempo per i cataloghi di grandi dimensioni. Se un aggiornamento rimane In attesa per più di qualche ora, contatta la nostra assistenza — possiamo riavviare l'elaborazione per te.


Problemi di web scraping

Mira non riesce a trovare le pagine del mio sito web

Verifica che le pagine siano accessibili pubblicamente senza effettuare l'accesso e che il tuo firewall consenta i nostri indirizzi IP (94.130.187.58, 188.245.65.74). Un singolo web scraping copre fino a 20 pagine — scegli quelle principali (FAQ, spedizioni, condizioni, pagine principali dei prodotti) anziché tutte. Se il sito web blocca completamente i crawler, puoi comunque completare la configurazione del tuo agente AI — descrivi la tua attività nel campo di testo proposto durante la configurazione iniziale e la descrizione verrà salvata come una normale fonte di tipo Contenuto testuale.

Il web scraping dura ore

Un web scraping che dura ore è bloccato. Contatta la nostra assistenza indicando l'URL che stai cercando di scansionare e verificheremo l'elaborazione da parte nostra.

Mira risponde con informazioni obsolete

Le fonti vengono aggiornate secondo il loro Intervallo di aggiornamento — puoi visualizzarlo e modificarlo direttamente nella tabella delle fonti (web scraping: ogni mese o ogni 2 settimane; feed del prodotto: ogni settimana, ogni giorno o ogni 12 ore). L'intervallo può anche essere impostato su Disattivato — una fonte impostata su Disattivato non si aggiorna mai autonomamente, quindi se Mira inizia a rispondere utilizzando dati obsoleti, controlla prima la colonna Intervallo di aggiornamento. Quando gli aggiornamenti automatici di un feed sono disattivati, sopra l'elenco dei feed appare una barra di avviso arancione con un pulsante per riattivarli.

Le nuove fonti hanno gli aggiornamenti automatici Attivati per impostazione predefinita, e gli aggiornamenti automatici sono disponibili con un Abbonamento a Mira AI. Dopo aver modificato il tuo sito web o catalogo, attendi il prossimo aggiornamento automatico oppure apri la fonte ed esegui Aggiorna Manualmente.


Pubblicazione e stati delle fonti

Il malfunzionamento di una singola fonte non impedisce la pubblicazione del tuo agente AI. La pubblicazione viene bloccata solo quando l'agente non ha Nessuna fonte pronta (un web scraping o un contenuto testuale), oppure mentre le fonti selezionate sono ancora in fase di creazione o aggiornamento. Se il pulsante Pubblica è disabilitato, controlla nella sezione Base di conoscenza se ci sono fonti ancora in elaborazione.


Qual è il prossimo passo?

Hai ricevuto la risposta alla tua domanda?