A Mira AI responde com base nas fontes de conhecimento que você conecta — web scraping, um feed de produtos XML, conteúdo de texto e respostas personalizadas. Quando uma fonte falha, a Mira pode parar de responder a perguntas sobre produtos ou responder com informações desatualizadas. Este guia aborda os erros mais comuns e como corrigi-los. Você pode ver o estado de cada fonte na seção Base de conhecimento — um ícone de status ao lado do nome da fonte mostra detalhes quando você passa o mouse sobre ele.
Requisitos do feed de produtos
A URL do feed deve ser acessível publicamente (sem necessidade de login). Se o seu servidor usa um firewall, permita 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 tags obrigatórias: id, name, description, price e link. Os itens sem qualquer uma delas são ignorados durante o processamento.
Cada item deve ter uma categoria atribuída — itens sem categoria podem ser descartados, e a Mira não consegue responder a perguntas sobre esses produtos e categorias.
Dica: antes de adicionar seu feed, use um validador de feeds para identificar tags ausentes antecipadamente. Quando um feed continua falhando, o resultado do validador geralmente mostra exatamente quais itens estão causando o problema. Você pode validar seu feed Aqui.
Erros comuns do feed de produtos
"Falha ao processar os dados" / o upload nunca termina
As causas mais comuns: o feed tem mais de 50 MB, as tags obrigatórias estão ausentes ou malformadas, ou a URL não é acessível publicamente. Valide o feed, verifique seu tamanho e confirme se a URL abre em uma janela anônima do navegador sem fazer login. Se o seu servidor filtra o tráfego, permita nossos endereços IP listados acima.
"O tempo limite para baixar o arquivo expirou"
A hospedagem do seu feed respondeu muito lentamente e o download atingiu o tempo limite. Tente adicionar o feed novamente — a verificação é executada de novo a cada tentativa — e verifique a velocidade de conexão do seu servidor. Se o erro persistir, entre em contato com nosso suporte e investigaremos.
Aviso sobre categorias ausentes
Itens sem categoria são ignorados, e a Mira não consegue responder a perguntas sobre esses produtos ou suas categorias. Primeiro, adicione uma categoria a cada item do feed. Se a primeira geração do feed terminar com um aviso de categoria mesmo que seus itens tenham categorias, abra o feed e execute Atualizar — a segunda geração geralmente é concluída com sucesso. Caso contrário, entre em contato com nosso suporte.
O feed está Pronto, mas a Mira não consegue encontrar alguns produtos
Itens sem uma tag obrigatória (id, name, description, price, link) são ignorados sem aviso, então o feed pode estar Pronto mesmo que alguns produtos não estejam nele. Valide o feed, corrija os itens sinalizados e execute Atualizar.
Uma atualização está parada em Pendente
A geração do feed pode levar algum tempo para catálogos grandes. Se uma atualização permanecer Pendente por mais de algumas horas, entre em contato com nosso suporte — podemos reiniciar o processamento para você.
Problemas com web scraping
A Mira não consegue encontrar páginas do meu site
Verifique se as páginas são acessíveis publicamente sem fazer login e se o seu firewall permite nossos endereços IP (94.130.187.58, 188.245.65.74). Um web scraping abrange até 20 páginas — escolha as principais (FAQ, envio, termos, páginas principais de produtos) em vez de todas. Se o site bloqueia totalmente os rastreadores, você ainda pode concluir a configuração do seu agente de IA — descreva sua empresa no campo de texto oferecido durante a configuração inicial, e essa descrição será salva como uma fonte comum de Conteúdo de texto.
O web scraping fica em execução por horas
Um web scraping que fica em execução por horas está travado. Entre em contato com nosso suporte informando a URL que você está tentando analisar e verificaremos o processamento do nosso lado.
A Mira responde com informações desatualizadas
As fontes são atualizadas de acordo com seu Intervalo de atualização — você pode vê-lo e alterá-lo diretamente na tabela de fontes (web scraping: a cada mês ou a cada 2 semanas; feed de produtos: a cada semana, a cada dia ou a cada 12 horas). O intervalo também pode ser definido como Desativado — uma fonte com o intervalo Desativado nunca é atualizada por conta própria, então, se a Mira começar a responder com dados desatualizados, verifique primeiro a coluna Intervalo de atualização. Quando as atualizações automáticas de um feed estão desativadas, uma barra de aviso laranja aparece acima da lista de feeds, com um botão para reativar as atualizações.
As novas fontes têm as atualizações automáticas ativadas por padrão, e as atualizações automáticas estão disponíveis com uma Assinatura da Mira AI. Depois de alterar seu site ou catálogo, aguarde a 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 bloqueia a publicação do seu agente de IA. A publicação só é bloqueada quando o agente não tem nenhuma fonte pronta (web scraping ou conteúdo de texto), ou enquanto as fontes selecionadas ainda estão sendo criadas ou atualizadas. Se o botão Publicar estiver desativado, verifique se há fontes ainda em processamento na seção Base de conhecimento.
Quais são os próximos passos?
Como começar a treinar a Mira AI — gerencie fontes de conhecimento e respostas personalizadas.
Como exportar feeds de produtos — obtenha uma URL de feed na sua plataforma de e-commerce.
Introdução ao Assistente de compras Mira AI — configuração completa do zero.


