Logo Performance HubPerformance Hub
Mục trang: Tài liệu

Khắc phục sự cố

Trên trang này

Chẩn đoán theo triệu chứng cho lớp con người/AI. Đối với các sự cố về camera, ghi hình, tải lên hoặc thiết bị, hãy bắt đầu với Khắc phục sự cố CCTV — mọi nội dung ở đây đều giả định bản thân video hoạt động bình thường.

Không có gì xuất hiện trên dòng thời gian về con người

Dòng thời gian hiển thị "No face detections — There are no face detection items in this current view range of the timeline."

  1. Theo dõi người đã được bật chưa? Cài đặt này áp dụng theo từng camera và tắt theo mặc định — hãy kiểm tra từng camera trong Camera và thiết bị.
  2. Bộ lọc ngưỡng phát hiện có đang ẩn mọi thứ không? Theo mặc định, một người cần có đủ số lần phát hiện trong đủ số phút để xuất hiện. Hãy tắt bộ lọc ngưỡng — nếu có người xuất hiện, nghĩa là họ chỉ nằm dưới mức tối thiểu.
  3. Kiểm tra khoảng ngày — khoảng 1D/2D/3D và bộ chọn ngày rất dễ bị để nhầm ở ngày khác.
  4. Camera có thực sự nhìn thấy khuôn mặt không? Tính năng phát hiện người cần khuôn mặt có kích thước và góc độ phù hợp. Một camera gắn trần nhìn thẳng xuống sẽ phát hiện đỉnh đầu, không phải khuôn mặt. Hãy kiểm tra khung hình của camera trong chế độ xem trực tiếp.
  5. Bật tính năng — nếu toàn bộ khu vực People bị thiếu hoặc các API trả về "People feature is not enabled for this facility", tính năng chưa được bật; hãy liên hệ với người quản lý tài khoản của bạn.

Một hội viên không bao giờ được nhận dạng (luôn là "Unsure")

Đây là vấn đề phổ biến nhất, và hầu như luôn do ảnh:

  1. Kiểm tra trạng thái ảnh. Trong danh sách People, hãy tìm hội viên. Huy hiệu "Invalid Photo" (chú giải hiển thị điểm và lý do không đạt) hoặc trạng thái "Not Processed" có nghĩa là việc đối chiếu khuôn mặt không có dữ liệu để làm việc. Hãy sửa ảnh trong hệ thống hội viên của bạn, hoặc chỉnh sửa trực tiếp ("Edit Profile" → "Change").
  2. Hoàn toàn không có ảnh? Self Learning vẫn có thể nhận dạng họ từ tương quan lượt ghé thăm — hãy kiểm tra xem họ có đang nằm trong hàng đợi của tính năng này không, và xác nhận rằng Enhanced AI Analysis đã được bật.
  3. Nhận dạng thủ công một lần. Thao tác "Identify This Person" trên hồ sơ unsure của họ sẽ liên kết ngay lập tức, và các shadow photo được tích lũy dần sẽ cải thiện việc đối chiếu sau này.
  4. Liên tục suýt khớp (cửa sổ chi tiết khi di chuột hiển thị độ tương đồng chỉ dưới 85%) → xem Tinh chỉnh nhận dạng khuôn mặt — nhưng hãy cải thiện ảnh trước khi thay đổi các ngưỡng.

Cùng một người liên tục nhận hồ sơ "Unsure" mới

Hệ thống nhận dạng không liên kết các lượt ghé thăm của họ với nhau:

  1. Gộp các bản trùng lặp — chọn các hồ sơ trên dòng thời gian và gộp. Mỗi lần gộp đều hợp nhất các ảnh tham chiếu khuôn mặt và giúp lượt ghé thăm tiếp theo có nhiều khả năng được liên kết hơn.
  2. Kiểm tra chất lượng hình ảnh của camera — vòm camera bẩn, ngược sáng (camera hướng về một lối vào sáng) và thiếu sáng đều tạo ra ảnh tham chiếu quá kém để đối chiếu. Cách khắc phục là điều chỉnh khung hình camera, không phải cài đặt.
  3. Nếu tình trạng xảy ra trên toàn cơ sở, cấu hình chất lượng đặt sẵn của shadow profile có thể quá khắt khe so với điều kiện ánh sáng của bạn — xem bảng triệu chứng.

Nhận dạng sai người

Hiếm gặp và cần được xử lý nghiêm túc:

  1. Sửa bản ghi: mở hồ sơ của người đó và kiểm tra các shadow photo — một lần gộp sai hoặc ảnh tự động thêm không đúng thường có thể nhìn thấy được. Hãy xóa hình ảnh sai, hoặc gộp/nhận dạng lại với đúng hội viên.
  2. Nếu Self Learning tạo ra liên kết, hãy dùng "Unlink" trên bản ghi ("the self-learn record will be reverted") và "Reject" kết quả khớp kèm lý do để nó không được đề xuất lại.
  3. Siết chặt việc đối chiếu: chuyển Member Matching về phía Strict — xem Tinh chỉnh nhận dạng khuôn mặt.

Một áp phích / ma-nơ-canh / TV liên tục xuất hiện như một người

Hệ thống đang hoạt động đúng thiết kế, và có một cách khắc phục chuyên dụng: đưa vào danh sách đen. Mở menu của người giả → "Add to Blacklist" kèm lý do ("e.g. Store Mannequin"). Các lần phát hiện sau này sẽ bị loại bỏ trước mọi bước xử lý. Nếu các lần phát hiện vẫn tiếp diễn từ một góc camera thứ hai, hãy thêm một mục danh sách đen thứ hai từ một trong các lần phát hiện đó.

Báo cáo trống hoặc thiếu khu vực

  1. Báo cáo bị trễ theo thiết kế — ảnh chụp nhanh được tạo qua đêm cho ngày hôm trước. Một cơ sở hoàn toàn mới sẽ thấy dữ liệu từ ngày thứ hai.
  2. "No zones configured — assign cameras to access zones in Settings" — phân tích khu vực cần có khu vực truy cập đã được gán camera.
  3. KPI có vẻ thấp so với số lượt check-in — hãy kiểm tra những camera nào đã bật Theo dõi người; dữ liệu báo cáo chỉ đến từ các camera được phân tích.

Vi phạm quyền truy cập có vẻ không đúng

  1. Các vi phạm sai sau khi thiết lập hầu như luôn do lỗi quy tắc — một gói hợp lệ bị thiếu trong danh sách được phép của khu vực. Hãy xem lại các quy tắc Membership Plans của khu vực trước khi kết luận về hành vi của hội viên.
  2. Hãy nhớ định nghĩa: một vi phạm là sự không khớp với quy tắc gói — "excluded, or not in the allowed plans" — bao gồm cả các khung thời gian từ Access Hours. Một hội viên có đúng gói nhưng đến sai thời gian vẫn bị tính là vi phạm.
  3. Khu vực mở không bao giờ phát sinh vi phạm — nếu bạn mong đợi vi phạm từ một khu vực có huy hiệu "Anyone can access", khu vực đó cần có quy tắc trước.
  1. Enhanced AI Analysis phải được bật — khi tắt, phép tương quan hoàn toàn không chạy (và phần cài đặt bị ẩn).
  2. Kiểm tra ngưỡng bằng chứng — hồ sơ cần đạt số lượt ghé thăm có tương quan tối thiểu (mặc định 8). Thẻ In Pipeline hiển thị tiến độ của từng hồ sơ ("N/M visits"); những khách ghé thăm không thường xuyên cần nhiều tuần để tích lũy bằng chứng.
  3. Lượt check-in phải đang được đồng bộ — không có dữ liệu check-in thì không có tương quan. Hãy xác minh bằng công cụ MCP insights_checkins hoặc trạng thái tích hợp Partner của bạn.
  4. Thẻ "No Match" có nhiều mục thường là do các cặp đôi/nhóm hai người luôn đến cùng nhau — hệ thống từ chối đoán giữa hai ứng viên. Hãy nhận dạng thủ công một trong hai người.
  5. Thẻ "Unable to Link" có nhiều mục cho thấy vấn đề chất lượng dữ liệu trong hệ thống hội viên — thường là các bản ghi thiếu những trường cần thiết để hoàn tất liên kết.

Thao tác gộp, nhận dạng hoặc xóa có vẻ bị treo

Các thao tác này chạy dưới dạng tiến trình nền được theo dõi — việc gán lại một lịch sử phát hiện dài cần thời gian. Các thẻ hiển thị trạng thái tạm thời ("PROCESSING", "DELETING..."); thao tác gộp hiển thị "Processing N of M…" kèm tùy chọn "Retry Failed" khi thất bại một phần, và thao tác xóa thất bại hiển thị "DELETE FAILED - RETRY". Hãy thử lại một lần trước khi liên hệ bộ phận hỗ trợ kèm ID người ("Copy Person ID").

Khi bạn liên hệ bộ phận hỗ trợ

Hãy cung cấp: tên cơ sở, Person ID (có thể sao chép từ menu của bất kỳ ô hoặc hồ sơ nào), camera liên quan, khoảng ngày/giờ và — đối với các vấn đề nhận dạng — trạng thái ảnh của hội viên có hợp lệ hay không. Ảnh chụp màn hình đã ẩn danh của cửa sổ chi tiết khi di chuột (hiển thị điểm tương đồng) giúp rút ngắn hầu hết các cuộc điều tra về đối chiếu.