شعار Performance HubPerformance Hub
قسم الموقع: الوثائق

استكشاف الأخطاء وإصلاحها

في هذه الصفحة

تشخيص يبدأ من العَرَض لطبقة الأشخاص/الذكاء الاصطناعي. لمشكلات الكاميرات أو التسجيل أو الرفع أو الأجهزة، ابدأ بـ استكشاف أخطاء الدوائر التلفزيونية المغلقة وإصلاحها، إذ يفترض كل ما هنا أن الفيديو نفسه يعمل بشكل سليم.

لا يظهر شيء في الخط الزمني للأشخاص

يعرض الخط الزمني "No face detections — There are no face detection items in this current view range of the timeline."

  1. هل تتبع الأشخاص مفعّل؟ إنه إعداد لكل كاميرا وغير مفعّل افتراضيًا؛ تحقق من كل كاميرا في الكاميرات والأجهزة.
  2. هل يُخفي مرشّح حد الاكتشاف كل شيء؟ افتراضيًا، يحتاج الأشخاص إلى عدد كافٍ من الاكتشافات على مدى عدد كافٍ من الدقائق كي يظهروا. أوقف مرشّح الحد؛ فإذا ظهر الأشخاص، فهذا يعني أنهم كانوا دون الحد الأدنى فقط.
  3. تحقق من نافذة التاريخ: من السهل ترك نطاق 1D/2D/3D ومنتقي التاريخ على اليوم الخطأ.
  4. هل ترى الكاميرا وجوهًا فعلًا؟ يحتاج الكشف عن الأشخاص إلى وجوه بحجم وزاوية قابلين للاستخدام. فالكاميرا المثبتة في السقف والموجهة إلى الأسفل مباشرةً تكتشف الرؤوس، لا الوجوه. تحقق من إطار الكاميرا في العرض المباشر.
  5. تفعيل الميزة: إذا كانت منطقة People بأكملها مفقودة أو كانت واجهات API تُعيد "People feature is not enabled for this facility"، فالميزة غير مفعّلة؛ تواصل مع مدير حسابك.

لا يُتعرّف على عضو أبدًا (دائمًا "Unsure")

هذه هي المشكلة الأكثر شيوعًا، وسببها دائمًا تقريبًا هو الصورة:

  1. تحقق من حالة الصورة. في قائمة People، ابحث عن العضو. تعني شارة "Invalid Photo" (يعرض التلميح الدرجة وسبب الإخفاق) أو الحالة "Not Processed" أن مطابقة الوجوه لا تملك ما تعمل عليه. أصلح الصورة في نظام الأعضاء لديك، أو حرّرها مباشرةً ("Edit Profile" ← "Change").
  2. لا توجد صورة إطلاقًا؟ يظل بإمكان Self Learning التعرّف عليه من خلال ربط الزيارات؛ تحقق مما إذا كان موجودًا في قائمته، وتأكد من تفعيل Enhanced AI Analysis.
  3. تعرّف عليه يدويًا مرة واحدة. يربط إجراء "Identify This Person" على ملفه غير المؤكد الملف فورًا، وتُحسّن صور الظل المتراكمة لديه المطابقة مستقبلًا.
  4. إخفاقات وشيكة متكررة (تُظهر النافذة المنبثقة عند التمرير تشابهًا أقل بقليل من 85%) ← راجع ضبط التعرّف على الوجوه، لكن حسّن الصورة قبل تغيير الحدود.

يحصل الشخص نفسه باستمرار على ملفات "Unsure" جديدة

لا يربط التعرّف زياراته ببعضها:

  1. ادمج المكررات: حدد الملفات في الخط الزمني وادمجها. كل عملية دمج توحّد المراجع الوجهية وتزيد احتمال ربط الزيارة التالية.
  2. تحقق من جودة صورة الكاميرا: القباب المتسخة، والإضاءة الخلفية (كاميرا موجهة نحو مدخل ساطع)، والإضاءة المنخفضة كلها تُنتج صورًا مرجعية رديئة جدًا لا تصلح للمطابقة. والحل في زاوية الكاميرا، لا في الإعدادات.
  3. إذا كانت المشكلة على مستوى المنشأة بأكملها، فقد يكون الإعداد المسبق لجودة ملفات الظل صارمًا جدًا بالنسبة إلى الإضاءة لديك؛ راجع جدول الأعراض.

التعرّف على شخص خاطئ

نادر الحدوث، ويستحق التعامل معه بجدية:

  1. أصلح السجل: افتح الملف الشخصي للشخص وتحقق من صور الظل الخاصة به، فعادةً ما يكون الدمج الخاطئ أو الصورة المضافة تلقائيًا السيئة واضحًا. أزل الصور الخاطئة، أو ادمج/أعد التعرّف وفق العضو الصحيح.
  2. إذا كان Self Learning هو من أنشأ الربط، فاستخدم "Unlink" على السجل ("the self-learn record will be reverted") ثم "Reject" المطابقة مع ذكر السبب حتى لا تُقترح مرة أخرى.
  3. شدّد المطابقة: انقل Member Matching نحو Strict؛ راجع ضبط التعرّف على الوجوه.

يستمر ظهور ملصق / مجسّم / تلفاز على أنه شخص

هذا سلوك متوقع وفق التصميم، وله حل مخصص: أضفه إلى القائمة السوداء. افتح قائمة الشخص الزائف ← "Add to Blacklist" مع ذكر السبب ("e.g. Store Mannequin"). تُستبعد الاكتشافات المستقبلية قبل أي معالجة. إذا استمرت الاكتشافات من زاوية كاميرا ثانية، فأضف إدخالًا ثانيًا إلى القائمة السوداء من أحد تلك الاكتشافات.

التقارير فارغة أو تنقصها المناطق

  1. تتأخر التقارير بحكم التصميم: تُنشأ اللقطات ليلًا لليوم السابق. لذا ترى المنشأة الجديدة تمامًا البيانات اعتبارًا من اليوم الثاني.
  2. "No zones configured — assign cameras to access zones in Settings": تحتاج تحليلات المناطق إلى مناطق وصول مُسندة إليها كاميرات.
  3. تبدو مؤشرات الأداء الرئيسية منخفضة مقارنةً بعمليات تسجيل الوصول: تحقق من الكاميرات التي فُعّل عليها تتبع الأشخاص؛ فبيانات التقارير لا تأتي إلا من الكاميرات التي تخضع للتحليل.

تبدو مخالفات الوصول خاطئة

  1. المخالفات الزائفة بعد الإعداد هي في الغالب أخطاء في القواعد: خطة مشروعة غير مدرجة في قائمة الخطط المسموح بها في منطقة ما. راجع قواعد Membership Plans الخاصة بالمنطقة قبل افتراض أن المشكلة في سلوك العضو.
  2. تذكّر التعريف: المخالفة هي عدم تطابق مع قاعدة الخطة، "excluded, or not in the allowed plans"، بما في ذلك النوافذ الزمنية من Access Hours. فالعضو المشترك في الخطة الصحيحة في الوقت الخطأ يُعدّ مخالفًا أيضًا.
  3. المناطق المفتوحة لا تُصدر مخالفات أبدًا: إذا كنت تتوقع مخالفات من منطقة تحمل شارة "Anyone can access"، فإنها تحتاج إلى قواعد أولًا.
  1. يجب تفعيل Enhanced AI Analysis: عند إيقافه، لا يعمل الربط إطلاقًا (ويُخفى قسم الإعدادات).
  2. تحقق من مستوى الأدلة المطلوب: تحتاج الملفات إلى الحد الأدنى من الزيارات المترابطة (الافتراضي 8). تعرض علامة التبويب In Pipeline التقدم لكل ملف ("N/M visits")؛ ويستغرق الزوار غير المنتظمين أسابيع لتجميع الأدلة.
  3. يجب أن تكون عمليات تسجيل الوصول متزامنة: لا بيانات لتسجيل الوصول، لا ربط. تحقق باستخدام أداة MCP insights_checkins أو من حالة تكامل Partner لديك.
  4. غالبًا ما تمثّل علامة تبويب "No Match" الكبيرة أزواجًا/ثنائيات يصلون معًا دائمًا، إذ يرفض النظام التخمين بين مرشحين اثنين. تعرّف يدويًا على أحدهما.
  5. تشير علامة تبويب "Unable to Link" الكبيرة إلى جودة البيانات في نظام الأعضاء، وعادةً ما تكون سجلات تنقصها الحقول اللازمة لإتمام الربط.

يبدو أن عملية دمج أو تعرّف أو حذف عالقة

تعمل هذه العمليات كعمليات في الخلفية يمكن تتبعها، وإعادة نسب سجل اكتشافات طويل تستغرق وقتًا. تعرض البطاقات حالات مؤقتة ("PROCESSING" و*"DELETING...")؛ وتعرض عمليات الدمج "Processing N of M…" مع خيار "Retry Failed" عند الإخفاق الجزئي، وتعرض عمليات الحذف الفاشلة "DELETE FAILED - RETRY". أعد المحاولة مرة واحدة قبل التواصل مع الدعم مع ذكر معرّف الشخص ("Copy Person ID"*).

عند التواصل مع الدعم

أرفق: اسم المنشأة، ومعرّف الشخص (يمكن نسخه من قائمة أي مربع أو ملف شخصي)، والكاميرا المعنية، ونافذة التاريخ/الوقت، وفي مشكلات التعرّف، ما إذا كانت حالة صورة العضو صالحة. تختصر لقطات الشاشة المجهّلة للنافذة المنبثقة عند التمرير (التي تعرض درجة التشابه) معظم تحقيقات المطابقة.