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

Integrations وMCP

في هذه الصفحة

كل ما يعرضه AI Insights & People في واجهته، من الخط الزمني والملفات الشخصية وعمليات تسجيل الوصول ولقطات التقارير، متاح برمجيًا من خلال MCP (Model Context Protocol) عبر سبع أدوات من نوع insights_*. الطريقة المفضلة لاستخدامها هي جهاز وكيل الذكاء الاصطناعي في منشأتك، الذي يتعامل مع MCP بشكل أصلي ويمكنه الإجابة عن الأسئلة بأسلوب المحادثة وتشغيل عمليات الأتمتة على البيانات.

الآليات العامة لـ MCP، أي طريقتا الوصول ومفاتيح phk_… وتحديد النطاق، مشروحة في Integrations وMCP في الدوائر التلفزيونية المغلقة. أما هذه الصفحة فتتعمق في أدوات insights نفسها.

متطلبات الوصول

تفرض كل أداة من نوع insights_* طبقتين، على غرار الواجهة:

  1. الوصول إلى الوحدة النمطية: يحتاج الحساب المستدعي إلى وحدة الدوائر التلفزيونية المغلقة من خلال أدواره.
  2. تفعيل الميزة: يجب أن تكون ميزة People مفعّلة في المنشأة المستهدفة؛ وإلا تُعيد الأداة الخطأ نفسه الذي تُعيده واجهات API: "People feature is not enabled for this facility".

يُطبَّق تحديد النطاق حسب المنشأة كما في كل مكان آخر: لا يمكنك الاستعلام إلا عن المنشآت التي يمكن لحسابك الوصول إليها.

الأدوات السبع

النسخة البرمجية من الخط الزمني للأشخاص، أي "the primary 'who was in the facility' view". تبحث في كتل زيارات الاكتشاف حسب نطاق التاريخ، والشخص، والاسم، ونوع المطابقة (identified / unsure)، وحالة العضوية، ومجموعة الكاميرات. هذه هي الأداة الأساسية: فأسئلة الحضور، وفحوص ما بعد ساعات العمل، والتحقيق في الحوادث تبدأ كلها من هنا.

تبحث في الأشخاص المسجلين، أي النسخة البرمجية من قائمة People، حسب الاسم، وحالة العضوية (نشطة، منتهية، معلّقة)، والسمات، مع أعداد لكل فئة. استخدمها لتحويل سؤال "من هو Alex؟" إلى معرّف شخص قبل التعمق في نشاطه.

insights_person_get

الملف الشخصي الكامل لشخص واحد، مُثرًى ببيانات عضويته، أي النسخة البرمجية من لوحة الملف الشخصي.

insights_person_activity

سجل اكتشافات شخص ما على مدى نطاق تاريخ، أي سجل زياراته لكل زيارة ولكل كاميرا. تقترن بشكل طبيعي مع insights_person_get: الملف الشخصي للسياق، والنشاط للسجل.

insights_checkins

سجل عمليات تسجيل الوصول في المنشأة من تكامل إدارة الأعضاء، أي سجلات تمرير البطاقات التي تشغّل المطابقة المدعومة بالزيارة وSelf Learning. مفيدة بمفردها ("كم عدد عمليات تسجيل الوصول أمس؟")، وكمرجع موثوق لمقارنة بيانات الكاميرات به.

insights_match_unidentified

تربط الاكتشافات غير المتعرّف عليها بسجلات تسجيل الوصول حسب الطابع الزمني لاقتراح مطابقات للهوية، وهي نسخة خفيفة عند الطلب من ربط Self Learning، كما تُظهر مجموعات الملفات المشتبه في تكرارها. مناسبة لأسئلة الوكيل من نوع "من قد يكون هذا الزائر غير المؤكد؟".

insights_report_snapshots

لقطات التقارير اليومية: مؤشرات الأداء الرئيسية والأعداد لكل كاميرا (الاكتشافات، والمسارات، والأشخاص الفريدون، والتقسيم بين identified/unsure، وتغطية تسجيل الوصول، والبيانات الديموغرافية) لنطاق تاريخ معين. هي الأداة المناسبة للوحات المعلومات والملخصات، إذ تقرأ مجاميع محسوبة مسبقًا بدلًا من الاكتشافات الخام.

أنماط تعمل بشكل جيد

  • أسئلة وأجوبة الحضور: "Who was in the facility at 6 this morning?" و*"When was Alex Nguyen last in?"*: باستخدام insights_timeline_search / insights_person_activity، ويجيب عنها وكيل الذكاء الاصطناعي بأسلوب المحادثة.
  • متابعة الدخول خلف الآخرين (tailgating): أتمتة مجدولة تقارن insights_timeline_search مع insights_checkins: يُرسل ملخص يومي إلى المدير عن أي شخص اكتُشف مرارًا دون تمرير بطاقة مطابق.
  • التواصل مع الأعضاء المنتهية عضويتهم: الأعضاء المنتهية عضويتهم الذين لا يزالون يزورون المنشأة (بحث في الخط الزمني حسب حالة العضوية) يُضافون إلى قائمة متابعة؛ تبقى المحادثة بشرية، بينما يكون الاكتشاف مؤتمتًا.
  • ملخص العمليات الأسبوعي: تلخيص insights_report_snapshots في دردشة الفريق: الزيارات، وساعات الذروة، ونسبة unsure، ومخالفات الوصول.
  • الحفاظ على جودة التعرّف: تشغيل insights_match_unidentified أسبوعيًا لاقتراح الهويات المرجحة وعمليات دمج المكررات، مما يُبقي قائمة Self Learning قصيرة.
  • Smart Display على شاشاتك: فكرة اختيارية لجهاز وكيل الذكاء الاصطناعي الذي يكون فيه MCP access مفعّلًا (الإعداد الافتراضي) وقدرة الدوائر التلفزيونية المغلقة ضمن نطاقه: أتمتة تعمل كل بضع دقائق خلال ساعات الوصول تفحص insights_checkins، أي عمليات تسجيل الوصول المتزامنة من تكامل نظام إدارة الأعضاء لديك، بحثًا عن الأشخاص الذين وصلوا للتو، وتحدّث تطبيقًا نشره الوكيل على Display Screens، مثل لوحة متصدّرين في نادٍ رياضي أو ترحيب بأعياد الميلاد في الردهة. تصل عمليات تسجيل الوصول إلى الوكيل في فحصه المجدول التالي، لذا تتحدث الشاشة خلال بضع دقائق. يستخدم الترحيب بأعياد الميلاد تاريخ الميلاد، وهو من المعلومات الشخصية: لا تُدرج إلا الأشخاص الذين وافقوا على ذلك، والتزم بواجبات الخصوصية في منظمتك، ولا تعرض أكثر من الاسم الأول.

نظرًا إلى أن واجهة MCP نفسها تشمل بقية Performance Hub (التحكم في الأبواب، وإدارة الأجهزة، وبيانات الأعضاء)، يمكن أن تمتد عمليات أتمتة بيانات الأشخاص عبر الوحدات النمطية: فـ "when an expired member is detected, check whether their door access also worked, and if so flag the access card" هي أتمتة واحدة لوكيل الذكاء الاصطناعي.

ما لا تكشفه الأدوات

  • الفيديو: يُقدَّم البث المباشر والتشغيل إلى المتصفحات، وليس عبر MCP؛ راجع Integrations وMCP في الدوائر التلفزيونية المغلقة.
  • صور الوجوه والمراجع البيومترية: تُعيد الأدوات البيانات الوصفية وبيانات الملفات الشخصية، وليس مجموعات الوجوه.
  • عمليات الكتابة على الأشخاص: التعرّف والدمج والإضافة إلى القائمة السوداء والحذف هي مسارات عمل في الواجهة تتطلب تأكيدًا بشريًا، وذلك عن قصد.

لا تتيح رموز مشاركة الضيوف الوصول إلى أي بيانات للأشخاص؛ راجع الأمان والخصوصية.