A Mira AI responde com base nas fontes de conhecimento que liga — uma extração de dados da web, um feed de produtos XML, conteúdo de texto e respostas personalizadas. Quando uma fonte falha, a Mira pode deixar de responder a perguntas sobre produtos ou responder com informações desatualizadas. Este guia aborda os erros mais comuns e como resolvê-los. Pode ver o estado de cada fonte na secção Base de conhecimento — um ícone de estado junto ao nome da fonte mostra detalhes quando passa o rato sobre ele.
Requisitos do feed de produtos
O URL do feed tem de estar acessível publicamente (sem necessidade de iniciar sessão). Se o seu servidor utilizar uma firewall, permita os nossos endereços IP 94.130.187.58 e 188.245.65.74.
O tamanho máximo é de 50 MB, em formato XML ou CSV (estrutura do Google Merchant Center ou da Heureka).
Cada item precisa das etiquetas obrigatórias: id, name, description, price e link. Os itens aos quais falte alguma delas são ignorados durante o processamento.
Cada item deve ter uma categoria atribuída — os itens sem categoria podem ser excluídos e, nesse caso, a Mira não consegue responder a perguntas sobre produtos e categorias.
Dica: Antes de adicionar o seu feed, utilize um validador de feeds para detetar antecipadamente etiquetas em falta. Quando um feed continua a falhar, os resultados do validador mostram geralmente quais são exatamente os itens problemáticos. Pode validar o seu feed Aqui.
Erros comuns do feed de produtos
"Falha ao processar os dados" / o carregamento nunca termina
As causas habituais: o feed tem mais de 50 MB, faltam etiquetas obrigatórias ou estas estão mal formatadas, ou o URL não está acessível publicamente. Valide o feed, verifique o seu tamanho e certifique-se de que o URL abre numa janela de navegação anónima sem iniciar sessão. Se o seu servidor filtrar o tráfego, permita os nossos endereços IP indicados acima.
"O tempo limite para descarregar o ficheiro expirou"
O alojamento do seu feed respondeu demasiado lentamente e a transferência excedeu o tempo limite. Tente adicionar o feed novamente — a verificação é executada de novo a cada tentativa — e verifique a velocidade de ligação do seu servidor. Se o erro continuar a ocorrer, contacte o nosso suporte e iremos investigar.
Aviso sobre categorias em falta
Os itens sem categoria são ignorados e a Mira não consegue responder a perguntas sobre produtos ou categorias com base nesses itens. Primeiro, adicione uma categoria a cada item do feed. Se a primeira criação do feed terminar com um aviso de categoria, apesar de os seus itens terem categorias, abra o feed e execute Atualizar — a segunda criação costuma ser concluída com êxito. Caso contrário, contacte o nosso suporte.
O feed está Pronto, mas a Mira não consegue encontrar alguns produtos
Os itens aos quais falta uma etiqueta obrigatória (id, name, description, price, link) são ignorados sem aviso, pelo que o feed pode estar Pronto mesmo que alguns produtos não estejam incluídos. Valide o feed, corrija os itens assinalados e execute Atualizar.
Uma atualização está bloqueada no estado Pendente
A criação de feeds pode demorar algum tempo no caso de catálogos grandes. Se uma atualização permanecer no estado Pendente durante mais de algumas horas, contacte o nosso suporte — podemos reiniciar o processamento.
Problemas com a extração de dados da web
A Mira não consegue encontrar páginas do meu site
Verifique se as páginas estão acessíveis publicamente sem iniciar sessão e se a sua firewall permite os nossos endereços IP (94.130.187.58, 188.245.65.74). Uma extração abrange até 20 páginas — escolha as principais (FAQ, envios, termos, páginas principais de produtos) em vez de todas. Se o site bloquear totalmente os rastreadores, ainda pode concluir a configuração do seu agente — descreva a sua empresa no campo de texto disponibilizado durante a configuração inicial, e essa descrição é guardada como uma fonte normal de Conteúdo de texto.
A extração de dados demora horas
Uma extração de dados que demora horas está bloqueada. Contacte o nosso suporte com o URL que está a tentar analisar e iremos verificar o processamento do nosso lado.
A Mira responde com informações desatualizadas
As fontes são atualizadas de acordo com o respetivo Intervalo de atualização — pode vê-lo e alterá-lo diretamente na tabela de fontes (extração de dados da web: todos os meses ou a cada 2 semanas; feed de produtos: todas as semanas, todos os dias ou a cada 12 horas). O intervalo também pode ser definido como Desativado — uma fonte com o intervalo Desativado nunca é atualizada automaticamente, por isso, se a Mira começar a responder com base em dados desatualizados, verifique primeiro a coluna Intervalo de atualização. Quando as atualizações automáticas de um feed estão desativadas, aparece uma barra de aviso laranja acima da lista de feeds, com um botão para voltar a ativar as atualizações.
As novas fontes têm as atualizações automáticas ativadas por predefinição, e as atualizações automáticas estão disponíveis com uma Subscrição da Mira AI. Depois de alterar o seu site ou catálogo, aguarde pela próxima atualização automática ou abra a fonte e execute Atualizar manualmente.
Publicação e estados das fontes
Uma única fonte com falha não impede a publicação do seu agente de IA. A publicação só é bloqueada quando o agente não tem nenhuma fonte pronta (uma extração de dados da web ou conteúdo de texto), ou enquanto as fontes selecionadas ainda estão a ser criadas ou atualizadas. Se o botão Publicar estiver desativado, verifique se existem fontes ainda em processamento na secção Base de conhecimento.
Qual é o próximo passo?
Como começar a treinar a Mira AI — gerir fontes de conhecimento e respostas personalizadas.
Como exportar feeds de produtos — obter um URL de feed da sua plataforma de comércio eletrónico.
Introdução ao Assistente de compras Mira AI — configuração completa de raiz.