A Mira AI responde com base nas fontes de conhecimento que você conecta — um web scraping, um feed de produtos XML, conteúdo em texto e respostas personalizadas. Quando uma fonte falha, a Mira pode parar de responder perguntas sobre produtos ou responder com informações desatualizadas. Este guia cobre os erros mais comuns e como resolvê-los. Você pode ver o status 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 precisa ser publicamente acessível (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.
Limites de tamanho: um arquivo de feed pode ter até 150 MB descompactado (formato XML ou CSV, estrutura Google Merchant Center ou Heureka). Além disso, sua conta tem uma cota de dados processados do feed, 50 MB por padrão. As atualizações do feed contam para essa cota, mas uma atualização processa apenas o que mudou desde a última execução, usando muito pouco dessa cota. Excluir um feed e adicioná-lo novamente processa o feed inteiro do zero. Se precisar de uma cota maior, entre em contato com nossa equipe de suporte.
Cada item precisa das tags obrigatórias: id, name, description, price e link. Itens sem qualquer uma dessas tags são ignorados durante o processamento.
Cada item deve ter uma categoria atribuída — itens sem categoria podem ser descartados, e a Mira então não pode responder perguntas sobre produtos ou categorias.
Dica: Antes de adicionar seu feed, passe-o por um validador de feed para identificar tags faltando logo no início. Quando um feed continua falhando, o resultado do validador normalmente mostra exatamente quais itens estão com problema. Você pode validar seu feed aqui.
Erros comuns de feed de produtos
"Falha ao processar os dados" / o upload nunca termina
As causas mais comuns: o arquivo do feed tem mais de 150 MB, sua cota de dados de feed (50 MB por padrão) foi usada, as tags obrigatórias estão faltando ou com erro, ou a URL não é publicamente acessível. Valide o feed, confira seu tamanho e certifique-se de que a URL abre em uma janela anônima do navegador sem precisar logar. Se o servidor filtra o tráfego, permita nossos IPs mencionados acima. Se a cota foi usada, peça para nosso time de suporte aumentá-la.
"O tempo limite para baixar o arquivo expirou"
A hospedagem do seu feed respondeu muito devagar e o download expirou. Tente adicionar o feed novamente — a verificação é feita toda vez que tentar — e verifique a velocidade da conexão do seu servidor. Se o erro continuar aparecendo, fale com nosso suporte para investigarmos.
Aviso sobre categorias ausentes
Itens sem categoria são ignorados, e a Mira não pode responder perguntas sobre produtos ou categorias desses itens. Primeiro, adicione uma categoria para cada item do feed. Se a primeira execução do feed terminar com aviso de categoria mesmo com categorias atribuídas, abra o feed e clique em Atualizar — geralmente a segunda execução termina com sucesso. Se não funcionar, fale com nosso suporte.
O feed está Pronto, mas a Mira não encontra alguns produtos
Itens sem as tags obrigatórias (id, name, description, price, link) são ignorados silenciosamente, então o feed pode ficar Pronto mas alguns produtos ficam de fora. Valide o feed, corrija os itens sinalizados e execute a Atualização.
Uma atualização ficou travada como Pendente
A construção do feed pode demorar em catálogos grandes. Se uma atualização ficar como Pendente por mais de algumas horas, contate nosso suporte — podemos reiniciar o processamento para você.
Problemas de web scraping
A Mira não encontra páginas do meu site
Verifique se as páginas são publicamente acessíveis sem precisar fazer login e se seu firewall permite nossos IPs (94.130.187.58, 188.245.65.74). O web scraping cobre até 50 páginas por conta. Ao escanear seu site, a Mira AI pré-seleciona as páginas principais para você (envio, pagamento, devoluções, FAQ, contato, termos) e deixa de fora páginas de login, conta, carrinho e checkout, então confira a seleção e adicione qualquer página que estiver faltando. Páginas bloqueadas pelo robots.txt do seu site podem não ser exibidas, exceto páginas principais como envio ou termos. Detalhes de produtos pertencem ao seu feed de produtos XML, não ao web scraping. Se o site bloqueou crawlers completamente, você ainda pode finalizar a configuração do seu agente — descreva sua empresa no campo de texto oferecido durante a configuração, e isso será salvo como uma fonte de conteúdo em texto.
Seu provedor de hospedagem está bloqueando nosso crawler? Alguns provedores de hospedagem têm regras de segurança que bloqueiam crawlers mesmo que suas páginas sejam públicas e nossos IPs estejam liberados. A fonte aparece então como indisponível. Em caso disso, entre em contato com nosso suporte informando a URL que verificamos para você. Enquanto isso, você pode adicionar as informações dessas páginas como Conteúdo em texto.
Web scraping executa por horas
Se o scraping ficar rodando por horas, está travado. Fale com nosso suporte enviando a URL que tentou escanear e vamos verificar o processamento do nosso lado.
A Mira responde com informações desatualizadas
As fontes são atualizadas pelo intervalo definido na coluna de atualização — você pode ver e alterar isso diretamente na tabela de fontes (web scraping: todo mês ou a cada 2 semanas; feed de produtos: toda semana, todo dia ou a cada 12 horas). O intervalo também pode ser definido como Desligado — uma fonte em Off nunca se atualiza sozinha, então se a Mira responder com dados antigos, verifique a coluna de intervalo de atualização primeiro. Se as atualizações automáticas de um feed estiverem desativadas, uma barra de aviso laranja aparece acima da lista de feeds, com um botão para reativar as atualizações.
Novas fontes têm atualizações automáticas ativadas por padrão e as atualizações automáticas estão disponíveis com uma assinatura Mira AI. Após mudar seu site ou catálogo, você pode aguardar a próxima atualização automática ou abrir a fonte e clicar em Atualizar manualmente.
Durante o teste, as atualizações automáticas são bloqueadas para todas as fontes: o intervalo de atualização aparece bloqueado e não pode ser alterado. Assim que você atualizar para um plano pago, todas as suas fontes mudam automaticamente para o intervalo padrão de atualização.
Publicação e status 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 (web scraping ou conteúdo em texto), ou enquanto o processamento/criação de fontes selecionadas não termina. Se o botão Publicar estiver desativado, confira na seção Base de conhecimento quais fontes estão em andamento.
O que fazer depois?
Como começar a treinar a Mira AI — gerencie fontes de conhecimento e respostas personalizadas.
Como exportar feeds de produtos — obtenha a URL do feed da sua plataforma de e-commerce.
Introdução à Assistente de Compras Mira AI — configuração completa do zero.


