A Mira AI responde com base nas fontes de conhecimento conectadas — como extração de dados web, feed de produtos XML, conteúdos de texto e respostas personalizadas. Quando uma destas fontes apresenta problemas, a Mira pode deixar de responder a dúvidas sobre produtos ou fornecer informações desatualizadas. Este guia explica os erros mais comuns e como resolvê-los. Para acompanhar o estado de cada fonte, aceda à secção Base de conhecimento — um ícone junto ao nome da fonte indica mais detalhes ao passar o cursor sobre ele.
Requisitos do feed de produtos
A URL do feed precisa ser acessível publicamente (sem exigir login). Se o servidor utilizar firewall, autorize os endereços IP 94.130.187.58 e 188.245.65.74.
Limite de tamanho: o ficheiro do feed pode ter até 150 MB sem compressão (XML ou CSV, estrutura Google Merchant Center ou Heureka). Além disso, existe uma quota por conta para dados processados pelo feed, 50 MB por padrão. Atualizações do feed são contabilizadas nesta quota, mas apenas o que muda desde a última execução consome o limite. Ao eliminar um feed e adicioná-lo novamente, será processado tudo de novo. Se precisar de uma quota maior, contacte o nosso suporte.
Cada item precisa dos marcadores obrigatórios: id, nome, descrição, preço e link. Os itens que não têm algum destes campos serão ignorados durante o processamento.
Cada item deve ter uma categoria definida — itens sem categoria podem ser descartados e, nesses casos, a Mira não conseguirá responder a perguntas relacionadas.
Sugestão: antes de adicionar o feed, utilize um validador de feeds para identificar marcas ou campos ausentes antecipadamente. Quando persistirem falhas, os relatórios do validador costumam indicar exatamente quais itens do feed apresentam problemas. Pode validar o seu feed aqui.
Erros mais comuns em feeds de produtos
"Falha ao processar dados" / carregamento não termina
As causas mais frequentes são: ficheiro do feed superior a 150 MB, quota de dados do feed (50 MB padrão) esgotada, falta ou mau formato de campos obrigatórios, ou URL inacessível publicamente. Faça a validação do feed, verifique o tamanho do ficheiro e certifique-se de que a URL abre em navegação anónima sem login. Se houver filtros de tráfego no servidor, autorize os nossos IPs acima. Caso a quota já tenha sido usada, solicite ao nosso suporte o aumento para a sua conta.
"O tempo para download do ficheiro expirou"
O servidor hospedeiro do feed respondeu demasiado devagar e o tempo limite foi ultrapassado. Tente adicionar o feed novamente — cada nova tentativa reinicia o tempo de verificação — e confirme também a velocidade da ligação do seu servidor. Se o erro continuar, contacte o nosso suporte para que possamos verificar.
Aviso sobre categorias ausentes
Itens sem categoria são ignorados e a Mira não conseguirá responder sobre produtos ou categorias destes itens. Garanta que cada item do feed tem uma categoria definida. Se, logo após a primeira execução, surgir o aviso de categorias ausentes mesmo com os itens categorizados, clique em Atualizar no próprio feed — normalmente a segunda execução será bem-sucedida. Caso o aviso persista, peça ajuda ao nosso suporte.
O feed está Pronto, mas a Mira não encontra alguns produtos
Itens sem qualquer dos campos obrigatórios (id, nome, descrição, preço, link) são ignorados sem aviso, o que pode deixar produtos fora mesmo que o feed apareça como Pronto. Valide o feed, corrija os itens destacados e utilize o botão Atualizar.
Atualização parada como Pendente
Feeds com grandes catálogos podem demorar a processar. Se a atualização permanecer como Pendente por muitas horas, contacte o nosso suporte — reiniciamos o processamento para si.
Problemas ao extrair dados do site
A Mira não encontra páginas do meu site
Certifique-se de que as páginas podem ser abertas publicamente, sem login, e que o firewall permite os nossos IPs (94.130.187.58, 188.245.65.74). A extração cobre até 20 páginas — escolha as mais importantes (FAQ, envio, termos, principais páginas de produtos), não todas. Caso o site bloqueie completamente robôs, ainda é possível concluir a configuração do seu agente — utilize o campo de texto disponibilizado durante a configuração para descrever o negócio, este conteúdo será salvo como fonte de texto normal.
Utiliza SiteGround? Algumas regras de segurança da SiteGround podem bloquear o nosso rastreador mesmo com as páginas públicas e IPs autorizados, mantendo a fonte como indisponível. Solicite autorização para o nosso rastreador junto ao suporte da SiteGround. Se não for viável, adicione as principais informações dessas páginas como Conteúdo de texto.
Extração de dados não termina
Caso a extração fique parada por horas, contacte o nosso suporte e envie a URL que pretende analisar para verificarmos do nosso lado.
A Mira responde com dados desatualizados
As fontes são atualizadas conforme o intervalo definido — pode ver e ajustar diretamente na tabela de fontes (extração: mensal ou a cada 2 semanas; feed: semanal, diário ou a cada 12 horas). O intervalo pode ser definido como Desligado — fontes Desligadas não são atualizadas automaticamente e, caso a Mira passe a responder com dados antigos, primeiro confira a coluna do intervalo de atualização. Quando as atualizações automáticas estão desativadas, surge uma barra de aviso laranja no topo da lista de feeds, com um botão para as reativar.
Fontes novas têm as atualizações automáticas ativas por padrão e só estão disponíveis para quem tem subscrição Mira AI. Sempre que modificar o site ou catálogo, pode aguardar a atualização automática seguinte ou clicar em Atualizar manualmente na fonte.
Durante o período experimental, as atualizações automáticas ficam bloqueadas em todas as fontes: a coluna Intervalo de atualização aparece bloqueada e não pode ser alterada. Assim que passar para um plano pago, todas as fontes assumem automaticamente o intervalo padrão.
Publicação e estados das fontes
Se alguma fonte falhar, isso não impede a publicação do agente de IA. A publicação só é bloqueada caso não exista nenhuma fonte pronta (extração de dados web ou conteúdo de texto) ou enquanto estiverem a decorrer criações ou atualizações. Se o botão Publicar estiver indisponível, confira na secção Base de conhecimento se há fontes ainda em processamento.
O que fazer agora?
Como começar a treinar a Mira AI — gerir fontes de conhecimento e definir respostas personalizadas.
Como exportar feeds de produtos — gerar a URL de feed na sua plataforma de e-commerce.
Introdução ao assistente de compras Mira AI — configuração desde o início.