A Mira AI responde com base nas fontes de conhecimento que você conecta — seja web scraping, feed de produtos em XML, conteúdo em texto ou respostas personalizadas. Se uma fonte apresenta problema, a Mira pode parar de responder perguntas sobre produtos ou usar informações desatualizadas. Este guia mostra os erros mais comuns e como corrigi-los. Você pode ver o status de cada fonte na seção Base de conhecimento — um ícone ao lado do nome da fonte mostra mais detalhes: é só passar o mouse por cima.
Requisitos do feed de produtos
A URL do feed precisa ser pública (não pode pedir login). Se o seu servidor tiver firewall, libere nossos endereços IP: 94.130.187.58 e 188.245.65.74.
Limite de tamanho: o arquivo do feed pode ter até 150 MB descompactado (XML ou CSV, estrutura Google Merchant Center ou Heureka). Além disso, sua conta tem uma cota de 50 MB processados do feed por padrão. Toda atualização conta para a cota, mas só o que mudou é processado, então consome bem pouco. Se você apagar e adicionar o feed de novo, ele será processado inteiro, do zero. Precisa de mais espaço? Fale com nosso suporte.
Cada item precisa das tags: id, nome, descrição, preço e link. Sem alguma delas, o item é ignorado no processamento.
Cada item deve estar em uma categoria — itens sem categoria podem ser descartados e, nesse caso, a Mira não consegue responder perguntas sobre os produtos ou categorias.
Dica: Antes de adicionar seu feed, passe ele em um validador para identificar tags faltando logo de cara. Se o feed continuar com erro, o relatório do validador costuma apontar certinho os itens com problema. Valide seu feed aqui.
Erros comuns em feeds de produtos
"Falha ao processar os dados" / upload sem fim
Principais motivos: feed com mais de 150 MB, cota de dados (50 MB por padrão) estourada, tags obrigatórias faltando/corrompidas ou URL não pública. Valide o feed, confira o tamanho, e teste a URL numa janela anônima (sem login). Se o servidor filtra acesso, libere nossos IPs. Se a cota acabou, peça aumento para nosso suporte.
"Tempo limite para download expirou"
Seu feed demorou demais para responder e o download falhou. Tente adicionar de novo — sempre fazemos uma nova tentativa — e veja se o servidor está rápido. Se continuar assim, fale com nosso suporte que a gente ajuda a investigar.
Aviso de categoria ausente
Items sem categoria são ignorados e a Mira não responde perguntas sobre eles. Primeiro, adicione uma categoria para cada item do feed. Se o primeiro processamento mostrar esse aviso mesmo já tendo categorias, abra o feed e clique em Atualizar — normalmente já resolve de segunda. Se não funcionar, fale com nosso suporte.
Feed está Pronto, mas a Mira não encontra alguns produtos
Itens sem alguma das tags obrigatórias (id, nome, descrição, preço, link) são ignorados sem aviso, então o feed pode estar Pronto e mesmo assim faltar produto. Valide e ajuste os itens apontados e clique em Atualizar.
Atualização ficou presa em Pendente
Processar feeds grandes pode demorar. Se a atualização ficar em Pendente por horas, fale com nosso suporte — a gente reinicia o processamento pra você.
Problemas com web scraping
A Mira não encontra páginas no seu site
Veja se as páginas são públicas, sem login, e se seu firewall libera nossos IPs (94.130.187.58, 188.245.65.74). O web scraping cobre até 20 páginas — escolha as mais relevantes (FAQ, envio, termos, páginas principais de produto) em vez de tudo. Se o site bloquear crawlers, você ainda pode finalizar a configuração do agente — basta contar sobre seu negócio no campo de texto mostrado durante a integração, e salvamos isso como fonte padrão em texto.
Seu provedor de hospedagem está bloqueando nosso crawler? Alguns provedores têm regras que barram crawlers, mesmo com páginas públicas e IPs liberados. Nesse caso, a fonte fica indisponível. Se isso acontecer, avise nosso suporte com a URL que verificamos para você. Enquanto isso, inclua as informações principais dessas páginas como conteúdo em texto.
Web scraping travado
Se o web scraping fica rodando por horas, está travado. Fale com nosso suporte, envie a URL que tentou analisar e nós vamos conferir no sistema.
A Mira responde com informações antigas
As fontes se atualizam conforme seu intervalo definido — você vê e muda isso direto na lista de fontes (web scraping: mensal ou cada 2 semanas; feed de produtos: semanal, diário ou a cada 12h). O intervalo também pode estar Desligado — neste caso, a fonte nunca é atualizada automaticamente. Se a Mira começar a usar dados desatualizados, confira primeiro a coluna de Intervalo de atualização. Quando o feed está sem atualização automática, aparece um aviso laranja acima da lista, com um botão para ativar.
Novas fontes já vêm com atualização automática ativada por padrão, e esse recurso está disponível com uma assinatura da Mira AI. Mudou o site ou catálogo? Você pode esperar a próxima atualização automática ou abrir a fonte e clicar em Atualizar na hora.
Durante o teste, as atualizações automáticas ficam bloqueadas em todas as fontes: o intervalo aparece bloqueado e não dá pra mudar. Assim que você migrar para um plano pago, todas as suas fontes voltam automaticamente para o intervalo padrão.
Publicação e status das fontes
Ter uma fonte com erro não bloqueia a publicação do seu agente de IA. Só não dá pra publicar se o agente estiver sem nenhuma fonte pronta (web scraping ou texto) ou se ainda houver fontes em criação/atualização. Se o botão Publicar estiver desativado, confira na Base de conhecimento se falta alguma fonte terminar de processar.
E agora?
Como treinar a Mira AI — gerencie fontes de conhecimento e respostas personalizadas.
Como exportar feeds de produtos — veja como pegar a URL do seu feed na sua plataforma de e-commerce.
Veja como configurar do zero a Assistente de Compras Mira AI — passo a passo completo.


