A Mira AI responde a partir das fontes de conhecimento que você conecta — um web scraping, um feed de produtos XML, conteúdo de 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 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 ao passar o mouse sobre ele.

As causas mais comuns: o arquivo do feed é maior que 150 MB, sua cota de dados do feed (50 MB por padrão) foi consumida, tags obrigatórias faltando ou malformadas, ou a URL não é publicamente acessível. Valide o feed, confira o tamanho e garanta que a URL abre em uma janela anônima do navegador sem fazer login. Se o seu servidor filtra tráfego, permita nossos endereços IP listados acima. Se a cota acabou, peça para nosso suporte aumentá-la.

A hospedagem do seu feed respondeu devagar demais e o download expirou. Tente adicionar o feed de novo — o teste é feito novamente a cada tentativa — e verifique a velocidade de conexão do seu servidor. Se o erro persistir, fale com nosso suporte e vamos investigar.

Itens sem categoria são ignorados, e a Mira não consegue responder perguntas sobre produto ou categoria desses itens. Primeiro adicione uma categoria a cada item do feed. Se a primeira importação do feed terminar com um aviso de categoria mesmo que seus itens tenham categorias, abra o feed e clique em Atualizar — normalmente a segunda importação conclui com sucesso. Se não funcionar, fale com nosso suporte.

Itens que não tiverem uma das tags obrigatórias (id, nome, descrição, preço, link) são ignorados silenciosamente, então um feed pode estar Pronto mas faltar alguns produtos. Valide o feed, corrija os itens sinalizados e clique em Atualizar.

A importação pode demorar para catálogos grandes. Se uma atualização ficar Pendente por várias horas, fale com nosso suporte — podemos reiniciar o processamento para você.

Confira se as páginas são publicamente acessíveis sem login, e se seu firewall permite nossos endereços IP (94.130.187.58, 188.245.65.74). O web scraping cobre até 50 páginas por conta — escolha as mais importantes (FAQ, envio, termos, principais páginas de produtos) em vez de tudo. Se o site bloquear totalmente crawlers, você ainda pode concluir a configuração do seu agente — explique seu negócio no campo de texto oferecido durante a configuração inicial e isso será salvo como uma fonte de conteúdo de texto regular.

Seu servidor está bloqueando nosso crawler? Algumas hospedagens têm regras de segurança que bloqueiam crawlers mesmo quando as páginas são públicas e nossos IPs estão permitidos. A fonte aparece então como indisponível. Se isso acontecer, fale com nosso suporte e envie a URL para verificarmos para você. Enquanto isso, você pode adicionar as informações principais dessas páginas como Conteúdo de texto.

Se o scraping já está rodando há horas, está travado. Fale com nosso suporte enviando a URL que você quer analisar e vamos conferir o processamento do nosso lado.

As fontes atualizam conforme o intervalo de Atualizar — você pode ver e mudar isso direto na tabela de fontes (web scraping: todo mês ou a cada duas semanas; feed de produto: toda semana, todo dia ou a cada 12 horas). O intervalo também pode ser definido como Desligado — uma fonte em Desligado nunca atualiza automaticamente, então, se a Mira começar a responder usando dados antigos, confira primeiro a coluna do intervalo de Atualizar. Quando as atualizações automáticas de um feed estão desligadas, uma barra de aviso laranja aparece acima da lista de feeds, com um botão para reativar as atualizações.

Novas fontes já vêm com 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 alterar seu site ou catálogo, espere a próxima atualização automática ou abra a fonte e clique em Atualizar manualmente.

No período de teste, as atualizações automáticas são bloqueadas para todas as fontes: o intervalo aparece como bloqueado e não pode ser alterado. Assim que você fizer upgrade para um plano pago, todas suas fontes mudam para o intervalo padrão automaticamente.

Uma única fonte com erro não impede publicar seu agente de IA. A publicação só é bloqueada quando o agente está sem nenhuma fonte pronta (web scraping ou conteúdo de texto), ou se as fontes selecionadas ainda estão sendo criadas ou atualizadas. Se o botão Publicar estiver desabilitado, confira a seção Base de conhecimento para ver se há fontes em andamento.