Passar para o conteúdo principal

Solução de problemas nas fontes de conhecimento da Mira AI

Veja o que fazer quando um product feed ou web scraping dá erro — principais erros, suas causas e como corrigir.

Escrito por Michal Jindra

A Mira AI responde usando as fontes de conhecimento que você conecta — um web scraping, um feed de produtos XML, conteúdo em texto e respostas personalizadas. Quando uma fonte falha, a Mira pode parar de responder perguntas de 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 Knowledge base — um ícone de status ao lado do nome da fonte mostra os detalhes ao passar o mouse sobre ele.


Requisitos do product feed

  • A URL do feed precisa estar publicamente acessível (não requer login). Se o seu servidor usa um firewall, libere nossos endereços IP 94.130.187.58 e 188.245.65.74.

  • Limite de tamanho: um arquivo de feed pode ter até 150 MB descompactado (XML ou CSV, estrutura Google Merchant Center ou Heureka). Além disso, sua conta possui uma cota de dados de feed processados, 50 MB por padrão. As atualizações de feed contam para essa cota, mas uma atualização processa apenas o que mudou desde a última execução, consumindo apenas uma fração. Se você excluir um feed e adicioná-lo de novo, todo o conteúdo volta a ser processado do zero. Precisa de mais cota? Fale com nossa equipe de suporte.

  • Cada item precisa ter as tags exigidas: id, nome, descrição, preço e link. Itens sem uma dessas tags são ignorados durante o processamento.

  • Cada item precisa de uma categoria atribuída — itens sem categoria podem ser descartados, e a Mira não pode responder perguntas sobre produtos ou categorias deles.

Dica: antes de adicionar seu feed, passe ele em um validador de feeds para encontrar tags que estejam faltando. Se um feed continuar falhando, normalmente o resultado do validador mostra exatamente quais itens estão com problema. Você pode validar seu feed aqui.


Erros comuns em product feeds

"Falha ao processar dados" / upload nunca finaliza

Causas usuais: o arquivo de feed está maior que 150 MB, sua cota de dados de feed (50 MB padrão) foi consumida, as tags exigidas estão faltando ou com erro, ou a URL não está publicamente acessível. Valide o feed, confira o tamanho, e veja se a URL abre numa janela anônima do navegador sem login. Se o seu servidor filtra o tráfego, libere os IPs listados acima. Se a cota foi consumida, peça para o nosso suporte aumentar.

"Tempo limite para download do arquivo expirou"

Seu servidor respondeu devagar demais e o download expirou. Tente adicionar o feed novamente — cada tentativa faz a verificação do zero — e confira a velocidade da conexão do seu servidor. Se o erro seguir, fale com nosso suporte que a gente investiga.

Aviso sobre categorias ausentes

Itens sem categoria são ignorados, e a Mira não pode responder perguntas de produtos ou categorias a partir deles. Primeiro, adicione uma categoria a cada item do feed. Se o primeiro processamento terminar com aviso de categoria mesmo os itens tendo categorias, abra o feed e clique em Atualizar — normalmente resolve na segunda execução. Se não resolver, fale com nosso suporte.

O feed está Pronto, mas a Mira não encontra alguns produtos

Itens sem uma tag obrigatória (id, nome, descrição, preço, link) são ignorados sem alerta, então o feed pode estar Pronto mas faltar produtos nele. Valide o feed, corrija os itens apontados e clique em Atualizar.

Uma atualização ficou travada em Pending

Processar feeds grandes pode levar algum tempo. Se uma atualização ficar Pending por várias horas, fale com nosso suporte — podemos reiniciar o processamento pra você.


Problemas com web scraping

A Mira não encontra páginas do meu site

Confira se as páginas estão publicamente acessíveis sem login e se o firewall permite nossos endereços IP (94.130.187.58, 188.245.65.74). Cada web scraping cobre até 20 páginas — escolha as principais (FAQ, envio, termos, principais páginas de produtos) ao invés de tentar capturar tudo. Se o website bloquear totalmente os crawlers, você ainda pode terminar de configurar seu agente — basta descrever sua empresa no campo de texto durante a configuração inicial, pois isso vira uma fonte de conteúdo em texto.

Hospedado no SiteGround? As regras de segurança do SiteGround podem bloquear nosso crawler mesmo que as páginas sejam públicas e os nossos IPs estejam liberados, então a fonte aparece como indisponível. Peça ao suporte do SiteGround para liberar nosso crawler. Se não conseguirem, insira as informações dessas páginas como conteúdo de texto manualmente.

Web scraping rodando há horas

Se o web scraping durar horas, é porque ficou travado. Fale com nosso suporte enviando a URL que tentou analisar para a gente verificar do nosso lado.

A Mira responde com informações desatualizadas

As fontes são atualizadas no intervalo de atualização — você pode ver e alterar esse valor direto na tabela de fontes (web scraping: mensal ou a cada 2 semanas; product feed: semanal, diário ou a cada 12 horas). O intervalo também pode ficar Desligado — uma fonte Desligada nunca será atualizada automaticamente, então se a Mira começar a responder com dados antigos, confira a coluna de intervalo primeiro. Quando o update automático de um feed está desligado, aparece uma barra laranja de aviso acima da lista de feeds, junto com um botão para ativar novamente.

Fontes novas têm atualização automática ativada por padrão e essa funcionalidade está disponível com uma assinatura Mira AI. Depois de atualizar seu site ou catálogo, você pode esperar o próximo update automático ou abrir a fonte e clicar em Atualizar manualmente.

Durante o período de teste, o update automático fica bloqueado para todas as fontes: o intervalo de atualização aparece bloqueado e não pode ser modificado. Assim que fizer upgrade para um plano pago, todas as suas fontes assumem o intervalo padrão automaticamente.


Publicação e estados das fontes

Uma única fonte falhando não impede a publicação do seu agente de IA. A publicação só é bloqueada quando nenhuma fonte está pronta (web scraping ou conteúdo em texto), ou enquanto fontes selecionadas ainda estão sendo criadas ou atualizadas. Se o botão Publicar estiver desativado, veja na seção Knowledge base se ainda há fontes em andamento.


E agora?

Respondeu à sua pergunta?