Ir para conteúdo principal

Solução de problemas das fontes de conhecimento do Mira AI

Saiba como agir quando um feed de produtos ou extração de dados da web falha — erros frequentes, motivos e como corrigi-los.

Escrito por Michal Jindra

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?

Isto respondeu à sua pergunta?