Per iniziare
In questa pagina
Questa guida porta una struttura da "registrazione TVCC" a "identificazione dei membri sulla timeline People". Presuppone che il tuo modulo CCTV / VSaaS sia già attivo e funzionante: un Edge Processor online, telecamere aggiunte, riprese in registrazione.
Passaggio 1: attiva la funzionalità
AI Insights & People è una funzionalità della struttura che si appoggia al modulo TVCC. Viene attivata per ogni struttura dal tuo account manager del Performance Hub:
- People: la funzionalità principale: timeline delle persone, profili, abbinamento dei membri, report, zone di accesso e gli strumenti MCP
insights_*. - AI Insights: il livello di analisi avanzata usato dall'elaborazione in background, come la correlazione di Self Learning e la pre-generazione delle mappe di calore.
Una volta attivata, AI Insights & People compare nella barra laterale del Performance Hub e i gruppi Access Zones, People, Face Recognition e Insights compaiono nella barra laterale Settings condivisa. Se un'API People viene chiamata per una struttura senza la funzionalità, restituisce "People feature is not enabled for this facility": vedi Risoluzione dei problemi.
Passaggio 2: attiva Tracciamento delle persone per ogni telecamera
Il rilevamento delle persone si attiva per singola telecamera. Nel modulo TVCC, apri le impostazioni di ogni telecamera e attiva Tracciamento delle persone (vedi Telecamere e dispositivi).
Scegli con attenzione:
- Attivalo su ingressi, reception e zone chiave: ovunque tu voglia copertura per presenze, identificazione o zone di accesso.
- Evitalo dove l'analisi delle persone non aggiunge nulla (parcheggi, locali tecnici): ogni flusso analizzato dall'AI consuma capacità di inferenza dell'appliance. Come regola generale, un'appliance gestisce circa la metà dei flussi di telecamere con l'inferenza AI rispetto alla sola registrazione; vedi L'hardware per i valori di ciascun modello.
- Le aree sensibili per la privacy (bagni, spogliatoi) non devono mai avere telecamere: vedi Sicurezza e privacy.
Passaggio 3: attiva Enhanced AI Analysis
In Settings → General (un'impostazione di TVCC), attiva Enhanced AI Analysis:
"Genera metadati più dettagliati tra cui mappe termiche, tracciamento dei percorsi e autoapprendimento. La disattivazione disabiliterà anche l'abbinamento automatico dei profili. Aumenta l'utilizzo dello spazio di archiviazione."
È questa impostazione a sbloccare Self Learning: se è disattivata, la sezione delle impostazioni Self Learning è nascosta e la pipeline di correlazione non viene eseguita. L'abbinamento facciale di base funziona anche senza, ma per una struttura che adotta questo modulo conviene quasi sempre tenerla attiva.
Passaggio 4: collega la sincronizzazione dei membri
L'abbinamento dei membri ha bisogno di membri con cui confrontare i volti. L'integrazione Partner del Performance Hub sincronizza i dati dal tuo sistema di gestione dei membri:
- Record dei membri: nome, stato dell'iscrizione, piani, tag e foto del profilo.
- Check-in: eventi di passaggio badge/ingresso, che alimentano l'abbinamento assistito dalla visita e Self Learning.
Le foto sincronizzate vengono sottoposte automaticamente a un controllo di qualità prima di essere usate per il riconoscimento (nitidezza, illuminazione, posa, occlusione, oltre a un controllo dei contenuti che rifiuta le immagini che non ritraggono persone, come animali domestici o cartoni animati). Le foto che non superano il controllo mostrano un badge "Invalid Photo" nell'elenco People e puoi filtrare per Photo Status ("Valid Photo", "Invalid Photo", "Not Processed") per trovarle. Un membro con una foto non valida non può essere abbinato tramite il volto, ma Self Learning può comunque identificarlo tramite la correlazione delle visite.
Puoi scegliere quali campi di contatto facoltativi sincronizzare (email, cellulare, indirizzo) in Settings → People → Profile Info.
Non hai un sistema di gestione dei membri? Puoi comunque aggiungere persone manualmente ("Add people") o importarle in blocco con "Import Members" da un file: vedi Persone e profili.
Passaggio 5: osserva le prime identificazioni
Entro un giorno di funzionamento dovresti vedere:
- La Timeline che si popola: apri AI Insights & People → Timeline. I membri identificati compaiono con il loro nome; i nuovi visitatori compaiono come "Unsure - ". Vedi Timeline delle persone.

Figura 1: la timeline People il primo giorno: un insieme di membri identificati e visitatori "Unsure"
-
I profili delle persone che si completano: fai clic su una persona qualsiasi per vederne il registro delle attività, i modelli di visita e gli approfondimenti AI. Vedi Persone e profili.
-
I report che compaiono dal giorno successivo: gli snapshot dei report vengono generati durante la notte per il giorno precedente, quindi la vista Reports inizia a mostrare dati dopo il primo giorno completo.
Passaggio 6: messa a punto della prima settimana
Alcune operazioni utili da fare quando arrivano i dati reali:
| Attività | Dove | Perché |
|---|---|---|
| Inserire in blacklist i falsi positivi | Timeline → menu della persona → "Add to Blacklist" | Poster, manichini e schermi possono essere rilevati come volti ogni giorno: inserirli in blacklist li scarta in modo permanente. Vedi Blacklist |
| Unire i profili unsure duplicati | Timeline → seleziona i riquadri → "Merge" | All'inizio, un visitatore può ritrovarsi con due shadow profile; unirli insegna al sistema che si tratta della stessa persona |
| Identificare manualmente i visitatori abituali | Menu della persona → "Identify This Person" | Accelera il riconoscimento delle persone con foto dei membri mancanti o di scarsa qualità |
| Rivedere la coda di Self Learning | Scheda Self Learning → "Pending Review" | Approva o rifiuta le correlazioni automatiche con i membri |
| Configurare le zone di accesso | Settings → Access Zones | Associa le telecamere alle zone, in modo che i report e il rilevamento delle violazioni di accesso abbiano una struttura. Vedi Zone di accesso |
| Verificare la conservazione | Settings → Archiviazione cloud | La conservazione dei metadati AI è impostata per impostazione predefinita su 24 mesi: verifica che corrisponda alla tua informativa sulla privacy. Vedi Sicurezza e privacy |
Lascia le soglie di riconoscimento sui preset Balanced per almeno un paio di settimane prima di valutare modifiche: vedi Ottimizzazione del riconoscimento facciale per sapere quando e come regolarle.
Passaggi successivi
- Come funziona: comprendi la pipeline prima di regolarla.
- Timeline delle persone: la vista operativa quotidiana.
- Integrazioni e MCP: interroga i dati delle persone dal tuo Agente AI.