A Mira AI responde com base nas fontes de conhecimento que forem adicionadas — seja extração de dados da web, feed de produtos XML, conteúdo em texto ou respostas personalizadas. Se alguma dessas fontes falhar, a Mira pode deixar de responder a perguntas sobre produtos ou apresentar informações desatualizadas. Este guia explica os erros mais frequentes e como resolvê-los. Pode acompanhar o estado de cada fonte na secção Base de conhecimento — um ícone junto ao nome da fonte informa o estado, com detalhes ao passar o cursor por cima.
Requisitos para o feed de produtos
O URL do feed deve ser publicamente acessível (não pode exigir login). Se houver firewall no servidor, liberte os nossos endereços IP 94.130.187.58 e 188.245.65.74.
Limites de tamanho: cada ficheiro de feed pode ter até 150 MB descompactados (nos formatos XML ou CSV, com estrutura Google Merchant Center ou Heureka). Existe ainda uma quota de processamento de dados por conta, que é de 50 MB por padrão. As atualizações do feed também contam para essa quota, mas processam apenas as alterações desde a última atualização, consumindo normalmente uma parcela muito pequena. Eliminar e adicionar novamente um feed implica processar todo o conteúdo do zero. Caso precise de aumentar a sua quota, entre em contacto com a equipa de apoio.
Cada item do feed deve conter obrigatoriamente as etiquetas: id, nome, descrição, preço e link. Qualquer item que falte uma destas etiquetas não será considerado durante o processamento.
Todos os itens precisam de uma categoria definida — itens sem categoria podem ser ignorados e, nesse caso, a Mira não conseguirá responder a perguntas relacionadas com produtos e categorias.
Sugestão: Antes de adicionar o feed, use um validador de feeds para identificar antecipadamente eventuais etiquetas em falta. Quando um feed continua com falhas, o resultado da validação geralmente indica exatamente onde estão os problemas. Pode validar o feed aqui.
Erros frequentes em feeds de produtos
"Falha ao processar os dados" / carregamento não conclui
Principais causas: ficheiro do feed acima de 150 MB, quota de dados excedida (50 MB por padrão), etiquetas obrigatórias ausentes ou com erro, ou URL inacessível publicamente. Valide o feed, confirme o tamanho e teste se o URL abre normalmente numa janela anónima do navegador, sem inicio de sessão. Caso exista filtro no servidor, permita o acesso com os IPs indicados acima. Se atingiu a quota, peça à nossa equipa de apoio para aumentar o limite.
"Tempo limite para transferência expirou"
O servidor que aloja o feed demorou demasiado, e a transferência ultrapassou o tempo permitido. Tente adicionar o feed novamente — a verificação será feita de novo em cada tentativa — e confira a velocidade da ligação do servidor. Se continuar a acontecer, contacte o apoio para analisarmos o caso.
Aviso de categorias ausentes
Itens sem categoria são ignorados e, assim, a Mira não poderá responder a perguntas de produto ou categoria baseadas nesses itens. Certifique-se de que cada item no feed tem uma categoria. Se, mesmo assim, o primeiro carregamento terminar com aviso, abra o feed e clique em Atualizar — normalmente, à segunda tentativa finaliza sem problemas. Caso não resolva, entre em contacto com o apoio.
O feed está Pronto mas a Mira não encontra alguns produtos
Itens sem qualquer das etiquetas obrigatórias (id, nome, descrição, preço, link) são ignorados sem aviso. Por isso, o feed pode aparecer como Pronto, mas faltar produtos. Valide o feed, corrija os itens destacados e clique em Atualizar.
Uma atualização ficou presa em Pendente
Atualizações em feeds de grandes catálogos podem ser mais demoradas. Se uma atualização ficar em Pendente por várias horas, contacte o apoio — podemos reiniciar o processamento para si.
Problemas ao extrair dados da web
A Mira não encontra páginas do meu site
Verifique se as páginas estão acessíveis publicamente, sem necessidade de login, e se o firewall do servidor já permite acesso pelos nossos IPs (94.130.187.58, 188.245.65.74). Só é possível extrair até 50 páginas por conta — priorize as principais, como FAQ, envios, condições ou páginas principais dos produtos, em vez do site inteiro. Se o site estiver a bloquear completamente rastreadores, pode terminar a configuração do agente — basta preencher o campo de descrição do negócio durante a integração; essa informação é registada como fonte em texto.
O alojamento está a bloquear o nosso rastreador? Alguns serviços de alojamento aplicam políticas de segurança que barram rastreadores, mesmo que as páginas estejam públicas e os nossos IPs tenham sido autorizados. Se for o caso, a fonte aparecerá como indisponível. Nessa situação, contacte o apoio com o URL para verificarmos por si. Até lá, a alternativa é adicionar manualmente o conteúdo-chave dessas páginas no campo de texto.
A extração demora muito tempo
Se a extração se prolonga por horas, está bloqueada. Contacte o apoio e envie o URL das páginas, para analisarmos o processamento.
A Mira responde com informações antigas
As fontes são atualizadas conforme o intervalo definido em Atualizar — pode visualizar e alterar essa configuração diretamente na tabela de fontes (extração web: mensal ou a cada 2 semanas; feed de produtos: semanal, diário ou a cada 12 horas). O intervalo pode estar Desligado — neste caso, a fonte nunca se atualiza automaticamente, então, se a Mira começar a responder com informações antigas, verifique primeiro a coluna Intervalo de atualização. Quando as atualizações automáticas de um feed estão desativadas, aparece uma barra laranja acima da lista, com um botão para reativar as atualizações.
Novas fontes têm as atualizações automáticas ativas por padrão, e só pode utilizar essa função se tiver uma subscrição Mira AI. Ao modificar o site ou catálogo, pode aguardar pela próxima atualização automática ou abrir a fonte para clicar em Atualizar e atualizar manualmente.
Durante o período experimental, as atualizações automáticas estão desativadas para todas as fontes: o intervalo aparecerá bloqueado e não pode ser alterado. Assim que avançar para um plano pago, todas as fontes adotam automaticamente o intervalo padrão.
Estados de publicação e fontes
Se alguma fonte falhar, isso não impede a publicação do seu agente de IA. Apenas não é possível publicar se o agente estiver sem qualquer fonte pronta (extração web ou conteúdo em texto), ou se as fontes ainda estiverem a ser criadas ou atualizadas. Se o botão Publicar estiver inativo, verifique a secção Base de conhecimento para identificar fontes ainda em processamento.
E agora, o que fazer?
Como começar a treinar a Mira AI — gerir fontes de conhecimento e respostas personalizadas.
Como exportar feeds de produtos — aprenda a obter o URL do feed na sua plataforma de e-commerce.
Introdução ao assistente de compras Mira AI — configuração completa do início ao fim.