시작하기

이 페이지의 내용

이 가이드는 시설을 "CCTV 녹화" 단계에서 "People 타임라인에서 회원 식별" 단계로 안내합니다. CCTV / VSaaS 모듈이 이미 실행 중이라고 가정합니다. 즉, 엣지 프로세서가 온라인 상태이고, 카메라가 추가되어 있으며, 영상이 녹화되고 있어야 합니다.

1단계: 기능 활성화

AI Insights & People은 CCTV 모듈 위에 구성되는 시설 기능입니다. Performance Hub 계정 관리자가 시설별로 활성화합니다.

  • People: 핵심 기능으로, 사람 타임라인, 프로필, 회원 매칭, 보고서, 접근 구역 및 insights_* MCP 도구가 포함됩니다.
  • AI Insights: Self Learning 상관 분석 및 히트맵 사전 생성 같은 백그라운드 처리에 사용되는 고급 분석 계층입니다.

활성화되면 Performance Hub 사이드바에 AI Insights & People이 표시되고, 공유 Settings 사이드바에 Access Zones, People, Face Recognition, Insights 그룹이 표시됩니다. 기능이 없는 시설에 대해 People API를 호출하면 *"People feature is not enabled for this facility"*가 반환됩니다. 문제 해결을 참조하십시오.

2단계: 카메라별로 사람 추적 켜기

사람 감지는 카메라별로 선택해서 사용합니다. CCTV 모듈에서 각 카메라의 설정을 열고 사람 추적을 활성화하십시오(카메라 및 기기 참조).

신중하게 선택하십시오.

  • 입구, 리셉션 및 주요 구역처럼 출석, 식별 또는 접근 구역 관리가 필요한 곳에서는 활성화하십시오.
  • 사람 인텔리전스가 도움이 되지 않는 곳(주차장, 기계실)에서는 활성화하지 마십시오. AI로 분석되는 모든 피드는 어플라이언스의 추론 용량을 사용합니다. 일반적으로 어플라이언스는 녹화만 할 때보다 AI 추론을 할 때 약 절반의 카메라 피드를 처리합니다. 모델별 수치는 하드웨어를 참조하십시오.
  • 개인정보 보호가 중요한 구역(화장실, 탈의실)에는 카메라를 절대 설치해서는 안 됩니다. 보안 및 개인정보 보호를 참조하십시오.

3단계: Enhanced AI Analysis 켜기

Settings → General(CCTV에 속한 설정)에서 Enhanced AI Analysis를 활성화하십시오.

"히트맵, 경로 추적, 자동 학습을 포함한 더 풍부한 메타데이터를 생성합니다. 이 기능을 비활성화하면 자동 프로필 매칭도 꺼집니다. 스토리지 사용량이 증가합니다."

이 설정을 켜야 Self Learning을 사용할 수 있습니다. 꺼져 있으면 Self Learning 설정 섹션이 숨겨지고 상관 분석 파이프라인이 실행되지 않습니다. 기본 얼굴 매칭은 이 설정 없이도 작동하지만, 이 모듈을 도입하는 시설이라면 거의 항상 켜 두는 것이 좋습니다.

4단계: 회원 동기화 연결

회원 매칭을 하려면 매칭할 회원이 있어야 합니다. Performance Hub의 Partner 통합은 회원 관리 시스템에서 다음 항목을 동기화합니다.

  • 회원 기록: 이름, 멤버십 상태, 플랜, 태그 및 프로필 사진.
  • 체크인: 카드 스와이프/입장 이벤트로, 방문 기반 매칭과 Self Learning에 사용됩니다.

동기화된 사진은 인식에 사용되기 전에 자동으로 품질 검사를 거칩니다(선명도, 조명, 자세, 가림 여부와 함께 반려동물이나 만화 같은 사람이 아닌 이미지를 거부하는 콘텐츠 검사). 검사에 실패한 사진은 People 목록에 "Invalid Photo" 배지로 표시되며, Photo Status("Valid Photo", "Invalid Photo", "Not Processed")로 필터링하여 찾을 수 있습니다. 사진이 유효하지 않은 회원은 얼굴 매칭을 할 수 없지만, Self Learning은 방문 상관 분석으로 여전히 식별할 수 있습니다.

동기화할 선택적 연락처 필드(이메일, 휴대전화, 주소)는 Settings → People → Profile Info에서 제어합니다.

회원 관리 시스템이 없습니까? 사람을 수동으로 추가하거나("Add people") 파일에서 일괄로 **"Import Members"**를 할 수 있습니다. 사람 및 프로필을 참조하십시오.

5단계: 첫 식별 결과 확인

실행 후 하루 이내에 다음을 확인할 수 있습니다.

  1. Timeline이 채워짐: AI Insights & People → Timeline을 여십시오. 식별된 회원은 이름으로 표시되고, 새 방문객은 *"Unsure - "*로 표시됩니다. 사람 타임라인을 참조하십시오.

People 타임라인

그림 1: 첫날의 People 타임라인: 식별된 회원과 "Unsure" 방문객이 섞여 있습니다

  1. 개인 프로필이 채워짐: 아무 사람이나 클릭하면 활동 로그, 방문 패턴 및 AI 인사이트를 볼 수 있습니다. 사람 및 프로필을 참조하십시오.

  2. 다음 날부터 보고서가 표시됨: 보고서 스냅샷은 전날을 기준으로 야간에 생성되므로, Reports 보기에는 첫 하루가 지난 후부터 데이터가 표시됩니다.

6단계: 첫 주 조정

실제 데이터가 들어오기 시작하면 다음 작업을 하는 것이 좋습니다.

작업위치이유
오탐 블랙리스트 등록Timeline → 사람 메뉴 → "Add to Blacklist"포스터, 마네킹, 화면이 매일 얼굴로 감지될 수 있으며, 블랙리스트에 등록하면 영구적으로 제외됩니다. 블랙리스트를 참조하십시오
중복된 unsure 프로필 병합Timeline → 타일 선택 → "Merge"초기에는 한 방문객에게 섀도 프로필이 두 개 생길 수 있습니다. 병합하면 시스템이 같은 사람임을 학습합니다
단골 방문객 수동 식별사람 메뉴 → "Identify This Person"회원 사진이 없거나 품질이 낮은 사람의 인식을 빠르게 진행합니다
Self Learning 대기열 검토Self Learning 탭 → "Pending Review"자동 회원 상관 결과를 승인하거나 거부합니다
접근 구역 설정Settings → Access Zones카메라를 구역에 매핑하여 Reports와 접근 위반 감지에 구조를 제공합니다. 접근 구역을 참조하십시오
보존 기간 확인Settings → 클라우드 스토리지AI 메타데이터 보존 기간의 기본값은 24개월입니다. 개인정보 처리방침과 일치하는지 확인하십시오. 보안 및 개인정보 보호를 참조하십시오

변경을 고려하기 전에 최소 2주 정도는 인식 임계값을 Balanced 프리셋으로 유지하십시오. 언제, 어떻게 조정해야 하는지는 얼굴 인식 조정을 참조하십시오.

다음 단계