O Mira AI responde a partir das fontes de conhecimento que adicionar — uma extração de dados da web, um feed de produtos em XML, conteúdo em texto e respostas personalizadas. Quando uma fonte falha, o Mira pode deixar de responder a perguntas de produtos ou responder com informações desatualizadas. Este guia abrange os erros mais comuns e como resolvê-los. Pode consultar o estado de cada fonte na secção Base de conhecimento — um ícone de estado ao lado do nome da fonte mostra detalhes ao passar o cursor em cima.
Requisitos do feed de produtos
O URL do feed deve ser acessível publicamente (não requer login). Se o seu servidor utilizar firewall, autorize os nossos endereços IP 94.130.187.58 e 188.245.65.74.
Limites de tamanho: um ficheiro de feed pode ter até 150 MB descomprimido (XML ou CSV, estrutura Google Merchant Center ou Heureka). Além disso, a sua conta tem uma quota de dados de feed processados, por padrão 50 MB. As atualizações do feed descontam desta quota, mas uma atualização processa apenas o que mudou desde a última execução, usando muito pouco. Apagar um feed e adicioná-lo novamente processa o feed inteiro do zero. Se precisar de uma quota maior, contacte a nossa equipa de suporte.
Cada item precisa das etiquetas obrigatórias: id, nome, descrição, preço e link. Itens com alguma delas em falta são ignorados durante o processamento.
Cada item deve ter uma categoria atribuída — itens sem categoria podem ser descartados e o Mira não poderá responder a perguntas de produto ou categoria relativos a eles.
Dica: Antes de adicionar o seu feed, passe-o por um validador para identificar etiquetas em falta logo no início. Se um feed continuar a falhar, o resultado do validador normalmente mostra exatamente quais os itens com problemas. Pode validar o seu feed aqui.
Erros de feed de produtos mais comuns
"Falha ao processar dados" / o upload nunca termina
Causas habituais: ficheiro do feed acima de 150 MB, quota de dados do feed (50 MB por padrão) esgotada, etiquetas obrigatórias em falta ou malformadas, ou URL sem acesso público. Valide o feed, verifique o respetivo tamanho e confirme que o URL abre numa janela anónima sem login. Se o seu servidor filtra tráfego, autorize os IP referidos acima. Se a quota já estiver usada, peça à nossa equipa de suporte para aumentá-la.
"O tempo limite para descarregar o ficheiro expirou"
O hosting do seu feed respondeu lentamente e o download excedeu o tempo limite. Tente adicionar novamente o feed — cada tentativa faz a verificação de novo — e confirme a velocidade de ligação do seu servidor. Se o erro persistir, contacte o nosso suporte e investigaremos a situação.
Aviso sobre categorias em falta
Itens sem categoria são ignorados, e o Mira não conseguirá responder a perguntas de produto ou categoria atribuídas a eles. Primeiro, adicione uma categoria a cada item no feed. Se após a primeira execução do feed surgir um aviso de categoria mesmo com todas as categorias preenchidas, abra o feed e clique em Atualizar — normalmente a segunda execução conclui sem problemas. Se não, contacte o nosso suporte.
O feed está Pronto, mas o Mira não encontra alguns produtos
Itens com uma etiqueta obrigatória em falta (id, nome, descrição, preço, link) são ignorados silenciosamente, por isso o feed pode estar Pronto mesmo tendo produtos fora dele. Valide o feed, corrija os itens assinalados e clique em Atualizar.
Uma atualização ficou em Pendente
A construção do feed pode demorar em catálogos grandes. Se uma atualização permanecer em Pendente durante mais de umas horas, contacte o nosso suporte — podemos reiniciar o processamento para si.
Problemas com extração de dados da web
O Mira não encontra páginas do seu site
Confira se as páginas são publicamente acessíveis sem necessidade de login e se o firewall permite os nossos IP (94.130.187.58, 188.245.65.74). Uma extração cobre até 20 páginas — selecione as principais (FAQ, envios, termos, principais páginas de produtos) em vez de todas. Se o site bloquear totalmente rastreadores, ainda assim poderá terminar a configuração do seu agente — descreva a sua empresa no campo de texto apresentado durante a configuração inicial, e esse conteúdo será guardado como uma fonte de conteúdo de texto.
O seu alojamento está a bloquear o nosso rastreador? Alguns fornecedores de alojamento aplicam regras de segurança que bloqueiam rastreadores, mesmo se as páginas forem públicas e os nossos IPs estiverem autorizados. Nesse caso, a fonte ficará indisponível. Se isso acontecer, contacte a nossa equipa de suporte enviando o URL e verificamos por si. Enquanto isso, pode adicionar as informações principais dessas páginas como fonte de conteúdo de texto.
A extração demora horas
Uma extração que demora horas ficou presa. Contacte o nosso suporte, envie o URL que está a tentar analisar e verificamos o processamento do nosso lado.
O Mira responde com informações desatualizadas
As fontes são atualizadas conforme o intervalo de Atualização — pode ver e alterar isso diretamente na tabela de fontes (extração da web: mensal ou a cada 2 semanas; feed de produtos: semanal, diário ou a cada 12 horas). O intervalo também pode estar configurado como Desligado — uma fonte Desligada nunca é atualizada automaticamente, portanto, se o Mira responder com dados antigos, verifique primeiro a coluna do intervalo de atualização. Quando as atualizações automáticas do feed estão desligadas, aparece uma barra laranja acima da lista de feeds com um botão para voltar a ativar as atualizações.
Novas fontes vêm com atualizações automáticas ativas por padrão, e as atualizações automáticas estão disponíveis com uma subscrição Mira AI. Após alterar o seu site ou catálogo, pode aguardar pela próxima atualização automática ou abrir a fonte e executar Atualizar manualmente.
Durante o período de avaliação, as atualizações automáticas estão bloqueadas para todas as fontes: o intervalo de atualização será apresentado como bloqueado e não será possível alterá-lo. Assim que atualizar para um plano pago, todas as fontes mudam automática e imediatamente para o intervalo padrão.
Publicação e estados das fontes
Uma única fonte com falha não bloqueia a publicação do seu agente de IA. Só é impossível publicar se o agente não tiver nenhuma fonte pronta (extração de dados da web ou conteúdo de texto), ou se as fontes selecionadas ainda estiverem a ser criadas ou atualizadas. Se o botão Publicar estiver desativado, confira a secção Base de conhecimento para ver quais fontes ainda estão em processamento.
O que fazer a seguir?
Como começar a treinar o Mira AI — gerir fontes de conhecimento e respostas personalizadas.
Como exportar feeds de produtos — obter o URL do feed da sua plataforma de comércio eletrónico.
Introdução ao assistente de compras Mira AI — configuração completa desde o início.


