Performance Hub logosuPerformance Hub
Site bölümü: Belgeler

Entegrasyonlar ve MCP

Bu sayfada

AI Insights & People'ın arayüzünde gösterdiği her şey (zaman çizelgesi, profiller, girişler ve rapor anlık görüntüleri), yedi insights_* aracı ile MCP (Model Context Protocol) üzerinden programlı olarak kullanılabilir. Bunları kullanmanın tercih edilen yolu tesisinizin Yapay Zeka Ajanı cihazıdır: bu cihaz MCP'yi yerel olarak konuşur ve hem soruları sohbet biçiminde yanıtlayabilir hem de veriler üzerinde otomasyonlar çalıştırabilir.

Genel MCP işleyişi (iki erişim yolu, phk_… anahtarları, kapsam belirleme) CCTV Entegrasyonlar ve MCP sayfasında ele alınmıştır. Bu sayfa insights araçlarının kendisini daha ayrıntılı inceler.

Erişim gereksinimleri

Her insights_* aracı, arayüzle aynı şekilde iki katman uygular:

  1. Modül erişimi: çağrıyı yapan hesabın rolleri aracılığıyla CCTV modülüne sahip olması gerekir.
  2. Özelliğin etkinleştirilmesi: hedef tesiste People özelliğinin etkinleştirilmiş olması gerekir; aksi halde araç, API'lerle aynı "People feature is not enabled for this facility" hatasını döndürür.

Tesis kapsamı her yerde olduğu gibi uygulanır: yalnızca hesabınızın erişebildiği tesisleri sorgulayabilirsiniz.

Yedi araç

Programlı Kişi zaman çizelgesi: "the primary 'who was in the facility' view". Algılama ziyaret bloklarını tarih aralığı, kişi, ad, eşleşme türü (identified / unsure), üyelik durumu ve kamera grubuna göre arar. Asıl iş yükünü taşıyan araç budur: katılım soruları, mesai sonrası kontroller ve olay incelemeleri burada başlar.

Kayıtlı kişileri, yani programlı People listesini, ad, üyelik durumu (active, expired, on hold) ve özelliklere göre, sonuç sayılarıyla birlikte arar. Etkinliğe inmeden önce "Alex kim?" sorusunu bir kişi kimliğine çözmek için kullanın.

insights_person_get

Bir kişinin üyelik verileriyle zenginleştirilmiş tam profili; programlı profil paneli.

insights_person_activity

Bir kişinin bir tarih aralığındaki algılama geçmişi; ziyaret bazında ve kamera bazında ziyaret günlüğü. insights_person_get ile doğal olarak birlikte kullanılır: bağlam için profil, geçmiş için etkinlik.

insights_checkins

Üye yönetimi entegrasyonundan alınan tesis giriş geçmişi; ziyaret destekli eşleştirmeyi ve Self Learning özelliğini besleyen kart okutma kayıtları. Tek başına ("dün kaç giriş oldu?") ve kamera verilerini karşılaştırmak için temel gerçek olarak kullanışlıdır.

insights_match_unidentified

Kimlik eşleşmeleri önermek için tanımlanmamış algılamaları zaman damgasına göre giriş kayıtlarıyla ilişkilendirir; Self Learning ilişkilendirmesinin hafif, isteğe bağlı bir sürümüdür ve şüpheli yinelenen profil gruplarını da ortaya çıkarır. Bir ajandan gelen "bu unsure ziyaretçi kim olabilir?" soruları için uygundur.

insights_report_snapshots

Günlük rapor anlık görüntüleri: bir tarih aralığı için temel performans göstergeleri ve kamera bazında sayılar (algılamalar, izler, benzersiz kişiler, identified/unsure dağılımı, giriş kapsamı, demografik bilgiler). Gösterge panelleri ve özetler için doğru araçtır; ham algılamalar yerine önceden hesaplanmış toplamları okur.

İyi çalışan örüntüler

  • Katılım soru-cevap: "Who was in the facility at 6 this morning?", "When was Alex Nguyen last in?"; insights_timeline_search / insights_person_activity, Yapay Zeka Ajanı tarafından sohbet biçiminde yanıtlanır.
  • Arkadan geçme takibi: insights_timeline_search sonuçlarını insights_checkins ile karşılaştıran zamanlanmış bir otomasyon; eşleşen bir kart okutması olmadan tekrar tekrar algılanan herkes için yöneticiye günlük bir özet gönderilir.
  • Süresi dolmuş üyelere ulaşma: hâlâ ziyaret eden süresi dolmuş üyeler (üyelik durumuna göre zaman çizelgesi araması) bir takip listesine aktarılır; insanlarla yapılan görüşme insanlara kalır, algılama otomatikleşir.
  • Haftalık operasyon özeti: insights_report_snapshots ekip sohbetine özetlenir: ziyaretler, yoğun saatler, unsure %, erişim ihlalleri.
  • Tanımlama hijyeni: olası kimlikleri ve yinelenen profil birleştirmelerini önermek için insights_match_unidentified haftalık çalıştırılır; böylece Self Learning kuyruğu kısa kalır.
  • Ekranlarınızda bir Smart Display: MCP access açık (varsayılan) ve kapsamında CCTV yeteneği bulunan bir Yapay Zeka Ajanı cihazı için isteğe bağlı bir fikir: varış saatlerinde birkaç dakikada bir çalışan bir otomasyon, üye yönetim sistemi entegrasyonunuzdan senkronize edilen girişleri, yani insights_checkins aracını yeni gelen kişiler için kontrol eder ve ajanın Display Screens ekranlarınıza yayımladığı bir uygulamayı günceller; örneğin bir spor salonu liderlik tablosu veya bir lobi doğum günü karşılaması. Girişler ajana bir sonraki zamanlanmış kontrolünde ulaşır, bu nedenle ekran birkaç dakika içinde güncellenir. Doğum günü karşılaması kişisel bir bilgi olan doğum tarihini kullanır: yalnızca buna onay vermiş kişileri dahil edin, organizasyonunuzun gizlilik yükümlülüklerine uyun ve ilk addan fazlasını göstermeyin.

Aynı MCP yüzeyi Performance Hub'ın geri kalanını da (kapı kontrolü, aygıt yönetimi, üye verileri) taşıdığından kişi verisi otomasyonları modüller arasında uzanabilir: "when an expired member is detected, check whether their door access also worked, and if so flag the access card" tek bir Yapay Zeka Ajanı otomasyonudur.

Araçların sunmadıkları

  • Video: canlı yayınlar ve oynatma MCP üzerinden değil, tarayıcılara sunulur; bkz. CCTV Entegrasyonlar ve MCP.
  • Yüz görüntüleri ve biyometrik referanslar: araçlar yüz koleksiyonlarını değil, meta verileri ve profil verilerini döndürür.
  • Kişiler üzerinde yazma işlemleri: tanımlama, birleştirme, kara listeye ekleme ve silme, tasarım gereği insan onayı gerektiren arayüz iş akışlarıdır.

Misafir paylaşım belirteçlerinin hiçbir kişi verisine erişimi yoktur; bkz. Güvenlik ve gizlilik.