A Mira AI responde a partir das fontes de conhecimento que liga — web scrape, feed de produtos XML, conteúdo de texto e custom responses. Quando uma fonte falha, a Mira pode deixar de responder a perguntas sobre produtos ou responder com informação desatualizada. Este guia cobre os erros mais comuns e como resolvê-los. Pode ver o estado de cada fonte na secção Knowledge base — o ícone de estado junto ao nome mostra detalhes ao passar o cursor.
Requisitos do feed de produtos
O URL do feed deve ser acessível publicamente (sem login). Se o seu servidor usa firewall, permita os nossos endereços IP 94.130.187.58 e 188.245.65.74.
Tamanho máximo de 50 MB, em formato XML ou CSV (estrutura Google Merchant Center ou Heureka).
Cada artigo precisa das tags obrigatórias: id, name, description, price e link. Artigos aos quais falte alguma são ignorados durante o processamento.
Cada artigo deve ter uma categoria atribuída — artigos sem ela podem ser descartados, e a Mira deixa de conseguir responder a perguntas de produtos e categorias.
Dica: antes de adicionar o feed, passe-o por um validador de feeds para apanhar tags em falta cedo. Quando um feed falha repetidamente, o resultado do validador costuma mostrar exatamente que artigos são o problema. Pode validar o seu feed aqui.
Erros comuns do feed de produtos
"Failed to process data" / o carregamento nunca termina
Causas habituais: o feed excede 50 MB, faltam tags obrigatórias ou estão danificadas, ou o URL não é acessível publicamente. Valide o feed, verifique o tamanho e confirme que o URL abre numa janela anónima sem login. Se o servidor filtra o tráfego, permita os endereços IP indicados acima.
"O limite de tempo para transferir o ficheiro expirou"
O alojamento do seu feed respondeu demasiado devagar e a transferência expirou. Tente adicionar o feed novamente — a verificação corre de novo a cada tentativa — e verifique a velocidade de ligação do servidor. Se o erro voltar, contacte o nosso suporte.
Aviso sobre categorias em falta
Artigos sem categoria são ignorados e a Mira não consegue responder a partir deles a perguntas de produtos ou categorias. Primeiro adicione uma categoria a cada artigo do feed. Se a primeira compilação terminar com um aviso de categorias apesar de os artigos as terem, abra o feed e execute Update — a segunda compilação costuma concluir com sucesso. Caso contrário, contacte o nosso suporte.
O feed está Ready, mas a Mira não encontra alguns produtos
Artigos sem uma tag obrigatória (id, name, description, price, link) são ignorados silenciosamente — o feed pode estar Ready mesmo faltando produtos. Valide o feed, corrija os artigos assinalados e execute Update.
Uma atualização está presa em Pending
As compilações de catálogos grandes podem demorar. Se uma atualização ficar em Pending mais do que algumas horas, contacte o nosso suporte — reiniciaremos o processamento.
Problemas com o web scrape
A Mira não encontra páginas do meu site
Verifique se as páginas são acessíveis publicamente sem login e se a firewall permite os nossos IP (94.130.187.58, 188.245.65.74). Um scrape cobre até 20 páginas — escolha as principais (FAQ, envios, termos, páginas de produto principais) em vez de todas.
A análise corre durante horas
Um scrape que corre durante horas está preso. Contacte o nosso suporte com o URL que está a tentar analisar e verificaremos o processamento do nosso lado.
A Mira responde com informação desatualizada
As fontes atualizam-se segundo o seu Update interval — visível e alterável diretamente na tabela de fontes (web scrape: todos os meses ou de 2 em 2 semanas; feed de produtos: até duas vezes por dia). Depois de alterar o site ou o catálogo, aguarde a próxima atualização automática ou abra a fonte e execute Update manualmente.
Publicação e estados das fontes
Uma única fonte falhada não bloqueia a publicação do seu agente de IA. A publicação só é bloqueada quando nenhum web scrape está pronto, ou enquanto fontes selecionadas ainda estão a ser criadas ou atualizadas. Se o botão Publish estiver desativado, verifique na Knowledge base que fontes ainda estão em curso.
O que se segue?
Como começar a treinar a Mira AI — faça a gestão das fontes de conhecimento e custom responses.
Como exportar feeds de produtos — obtenha o URL do feed da sua plataforma de e-commerce.
Introdução à Mira AI — configuração completa de raiz.