Logotipo do Performance HubPerformance Hub
Seção do site: Documentação

Solução de problemas

Nesta página

Diagnóstico a partir dos sintomas para a camada de pessoas/IA. Para problemas de câmera, gravação, upload ou appliance, comece por Solução de problemas do CFTV — tudo aqui pressupõe que o vídeo em si esteja funcionando corretamente.

Nada aparece na linha do tempo de pessoas

A linha do tempo mostra "No face detections — There are no face detection items in this current view range of the timeline."

  1. O Rastreamento de pessoas está ativado? Ele é configurado por câmera e vem desativado por padrão — verifique cada câmera em Câmeras e dispositivos.
  2. O filtro de limite de detecção está ocultando tudo? Por padrão, as pessoas precisam de detecções suficientes ao longo de minutos suficientes para aparecer. Desative o filtro de limite — se as pessoas aparecerem, elas estavam apenas abaixo dos mínimos.
  3. Verifique a janela de datas — é fácil deixar o intervalo 1D/2D/3D e o seletor de data no dia errado.
  4. A câmera está realmente vendo rostos? A detecção de pessoas precisa de rostos com tamanho e ângulo utilizáveis. Uma câmera no teto apontada diretamente para baixo detecta cabeças, não rostos. Verifique o enquadramento da câmera na visualização ao vivo.
  5. Habilitação do recurso — se toda a área People estiver ausente ou as APIs retornarem "People feature is not enabled for this facility", o recurso não está habilitado; entre em contato com o seu gerente de conta.

Um membro nunca é identificado (sempre "Unsure")

É o problema mais comum, e quase sempre a causa é a foto:

  1. Verifique o status da foto. Na lista People, encontre o membro. Um selo "Invalid Photo" (a dica de ferramenta mostra a pontuação e o motivo da reprovação) ou o status "Not Processed" significa que a correspondência facial não tem com o que trabalhar. Corrija a foto no seu sistema de membros ou edite-a diretamente ("Edit Profile" → "Change").
  2. Não há foto? O Self Learning ainda pode identificar o membro pela correlação de visitas — verifique se ele está na fila e confirme que o Enhanced AI Analysis está ativado.
  3. Identifique manualmente uma vez. A ação "Identify This Person" no perfil unsure dele faz o vínculo imediatamente, e as shadow photos acumuladas melhoram a correspondência futura.
  4. Quase acertos persistentes (o pop-up mostra similaridade logo abaixo de 85%) → consulte Ajuste do reconhecimento facial — mas melhore a foto antes de mexer nos limites.

A mesma pessoa continua recebendo novos perfis "Unsure"

O reconhecimento não está vinculando as visitas dela:

  1. Mescle os duplicados — selecione os perfis na linha do tempo e mescle-os. Cada mesclagem consolida as referências faciais e aumenta a probabilidade de vínculo na próxima visita.
  2. Verifique a qualidade da imagem da câmera — domos sujos, contraluz (uma câmera voltada para uma entrada muito iluminada) e pouca luz produzem fotos de referência ruins demais para correspondência. A solução está na visão da câmera, não nas configurações.
  3. Se o problema ocorrer em toda a instalação, a predefinição de qualidade dos shadow profiles pode estar rigorosa demais para a sua iluminação — consulte a tabela de sintomas.

Pessoa errada identificada

É raro e merece ser tratado com seriedade:

  1. Corrija o registro: abra o perfil da pessoa e verifique as shadow photos — uma mesclagem incorreta ou uma foto adicionada automaticamente ruim geralmente fica visível. Remova as imagens erradas ou mescle/reidentifique com o membro correto.
  2. Se o vínculo foi feito pelo Self Learning, use "Unlink" no registro ("the self-learn record will be reverted") e use "Reject" na correspondência, informando um motivo, para que ela não seja proposta novamente.
  3. Torne a correspondência mais rigorosa: mova o Member Matching na direção de Strict — consulte Ajuste do reconhecimento facial.

Um pôster / manequim / TV continua aparecendo como pessoa

Isso é o comportamento esperado, e existe uma solução específica: adicione-o à lista de bloqueio. Abra o menu da falsa pessoa → "Add to Blacklist", com um motivo ("e.g. Store Mannequin"). As detecções futuras são descartadas antes de qualquer processamento. Se as detecções persistirem a partir de um segundo ângulo de câmera, adicione uma segunda entrada à lista de bloqueio a partir de uma dessas detecções.

Os relatórios estão vazios ou sem zonas

  1. Os relatórios têm atraso por design — os snapshots são gerados durante a noite para o dia anterior. Uma instalação nova vê dados a partir do segundo dia.
  2. "No zones configured — assign cameras to access zones in Settings" — as análises de zona precisam de zonas de acesso com câmeras atribuídas.
  3. Os KPIs parecem baixos em comparação com os check-ins — verifique quais câmeras têm o Rastreamento de pessoas ativado; os dados dos relatórios vêm somente de câmeras analisadas.

As violações de acesso parecem erradas

  1. Violações falsas após a configuração quase sempre são erros nas regras — um plano legítimo ausente da lista de permitidos de uma zona. Revise as regras de Membership Plans da zona antes de presumir algo sobre o comportamento dos membros.
  2. Lembre-se da definição: uma violação é uma incompatibilidade com a regra do plano — "excluded, or not in the allowed plans" —, incluindo as janelas de horário de Access Hours. Um membro com o plano certo no horário errado também comete uma violação.
  3. Zonas abertas nunca geram violações — se você espera violações de uma zona com o selo "Anyone can access", primeiro ela precisa de regras.
  1. O Enhanced AI Analysis precisa estar ativado — com ele desativado, a correlação não é executada (e a seção de configurações fica oculta).
  2. Verifique o nível de evidência — os perfis precisam do mínimo de visitas correlacionadas (padrão de 8). A guia In Pipeline mostra o progresso de cada perfil ("N/M visits"); visitantes pouco frequentes levam semanas para acumular evidências.
  3. Os check-ins precisam estar sendo sincronizados — sem dados de check-in, não há correlação. Verifique com a ferramenta MCP insights_checkins ou com o status da sua integração Partner.
  4. Uma guia "No Match" grande geralmente indica casais/duplas que sempre chegam juntos — o sistema se recusa a adivinhar entre dois candidatos. Identifique manualmente um deles.
  5. Uma guia "Unable to Link" grande indica problemas de qualidade dos dados do sistema de membros — normalmente registros sem os campos necessários para concluir o vínculo.

Uma mesclagem, identificação ou exclusão parece travada

Essas operações são executadas como processos em segundo plano monitorados — reatribuir um longo histórico de detecções leva tempo. Os cartões mostram estados transitórios ("PROCESSING", "DELETING..."); as mesclagens mostram "Processing N of M…" com uma opção "Retry Failed" em caso de falha parcial, e as exclusões com falha mostram "DELETE FAILED - RETRY". Tente novamente uma vez antes de entrar em contato com o suporte informando o ID da pessoa ("Copy Person ID").

Ao entrar em contato com o suporte

Inclua: o nome da instalação, o Person ID (que pode ser copiado de qualquer menu de bloco ou perfil), a câmera envolvida, a janela de data/hora e — em problemas de identificação — se o status da foto do membro é válido. Capturas de tela anonimizadas do pop-up (que mostra a pontuação de similaridade) agilizam a maioria das investigações de correspondência.