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 seção Knowledge base — o ícone de estado junto ao nome mostra detalhes ao passar o cursor.

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 em uma janela anônima sem login. Se o servidor filtra o tráfego, permita os endereços IP indicados acima.

O hospedagem do seu feed respondeu demasiado devagar e o download 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, contate o nosso suporte.

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, contate o nosso suporte.

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.

As compilações de catálogos grandes podem demorar. Se uma atualização ficar em Pending mais do que algumas horas, contate o nosso suporte — reiniciaremos o processamento.

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. Se o site bloquear totalmente os crawlers, você ainda pode concluir a configuração do agente — descreva seu negócio no campo de texto oferecido durante o onboarding, e ele será salvo como uma fonte normal de conteúdo de texto.

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.

As fontes são atualizadas conforme o Update interval — você vê e altera isso diretamente na tabela de fontes (web scrape: 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 estar em Off — uma fonte em Off nunca se atualiza sozinha; então, se a Mira começar a responder com dados antigos, verifique primeiro a coluna Update interval. Quando um feed está com as atualizações automáticas desligadas, uma barra de aviso laranja aparece acima da lista de feeds, com um botão para reativá-las.

Fontes novas têm as atualizações automáticas ativadas por padrão, e as atualizações automáticas estão disponíveis com uma assinatura do Mira AI. Depois de mudar seu site ou catálogo, aguarde a próxima atualização automática ou abra a fonte e execute Update manualmente.

Uma única fonte com falha não bloqueia a publicação do seu agente de IA. A publicação só fica bloqueada quando o agente não tem nenhuma fonte pronta (um web scrape 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 na Knowledge base as fontes ainda em andamento.