Logo Performance HubPerformance Hub
Sekcja witryny: Dokumentacja

Integracje i MCP

Na tej stronie

Wszystko, co AI Insights & People pokazuje w interfejsie — oś czasu, profile, zameldowania i migawki raportów — jest dostępne programowo przez MCP (Model Context Protocol) za pomocą siedmiu narzędzi insights_*. Zalecanym sposobem korzystania z nich jest urządzenie Agent AI Twojego obiektu, które natywnie obsługuje MCP i może zarówno odpowiadać na pytania w formie rozmowy, jak i uruchamiać automatyzacje na tych danych.

Ogólne zasady działania MCP — dwa sposoby dostępu, klucze phk_…, zakresy — opisano na stronie Integracje i MCP w CCTV. Ta strona szczegółowo omawia same narzędzia insights.

Wymagania dotyczące dostępu

Każde narzędzie insights_* egzekwuje dwie warstwy kontroli, tak samo jak interfejs:

  1. Dostęp do modułu — konto wywołujące musi mieć moduł CCTV przypisany w swoich rolach.
  2. Włączenie funkcji — docelowy obiekt musi mieć włączoną funkcję People; w przeciwnym razie narzędzie zwraca ten sam błąd "People feature is not enabled for this facility" co interfejsy API.

Zakres obiektów działa tak samo jak wszędzie indziej: możesz wysyłać zapytania wyłącznie o obiekty, do których Twoje konto ma dostęp.

Siedem narzędzi

Programowy odpowiednik osi czasu osób — "the primary 'who was in the facility' view". Przeszukuje bloki wizyt z wykryciami według zakresu dat, osoby, imienia i nazwiska, typu dopasowania (zidentyfikowany / niepewny), statusu członkostwa i grupy kamer. To podstawowe narzędzie: od niego zaczynają się pytania o frekwencję, kontrole po godzinach otwarcia i dochodzenia w sprawie incydentów.

Przeszukuje zarejestrowane osoby — programowy odpowiednik listy People — według imienia i nazwiska, statusu członkostwa (aktywne, wygasłe, zawieszone) i atrybutów, z liczbami dla poszczególnych wartości filtrów. Używaj go, aby zamienić pytanie "kim jest Alex?" na identyfikator osoby przed przejściem do szczegółów aktywności.

insights_person_get

Pełny profil jednej osoby, wzbogacony o dane jej członkostwa — programowy odpowiednik panelu profilu.

insights_person_activity

Historia wykryć osoby w danym zakresie dat — jej dziennik wizyt, z podziałem na wizyty i kamery. Naturalnie łączy się z insights_person_get: profil zapewnia kontekst, aktywność — historię.

insights_checkins

Historia zameldowań w obiekcie pochodząca z integracji z systemem zarządzania członkami — rekordy odbić kart, na których opiera się dopasowywanie wspomagane wizytą oraz Self Learning. Przydatna sama w sobie ("ile było zameldowań wczoraj?") oraz jako punkt odniesienia do porównania z danymi z kamer.

insights_match_unidentified

Koreluje niezidentyfikowane wykrycia z rekordami zameldowań na podstawie znaczników czasu, aby zaproponować dopasowania tożsamości — to uproszczona, uruchamiana na żądanie wersja korelacji Self Learning, która dodatkowo wskazuje grupy prawdopodobnie zduplikowanych profili. Dobrze sprawdza się przy pytaniach agenta typu "kim może być ten niepewny odwiedzający?".

insights_report_snapshots

Dzienne migawki raportów: kluczowe wskaźniki i liczby dla poszczególnych kamer (wykrycia, ślady, unikalne osoby, podział na zidentyfikowane/niepewne, pokrycie zameldowań, dane demograficzne) dla zakresu dat. Właściwe narzędzie do pulpitów i podsumowań — odczytuje wstępnie obliczone agregaty zamiast surowych wykryć.

Sprawdzone wzorce

  • Pytania i odpowiedzi o frekwencję — "Kto był w obiekcie o 6 rano?", "Kiedy Alex Nguyen był tu ostatnio?" — insights_timeline_search / insights_person_activity, z odpowiedzią udzielaną w formie rozmowy przez Agenta AI.
  • Działania po wykryciu wejścia "na doczepkę" — zaplanowana automatyzacja porównująca insights_timeline_search z insights_checkins: każda osoba wielokrotnie wykryta bez odpowiadającego jej odbicia karty trafia do codziennego podsumowania dla kierownika.
  • Kontakt z członkami o wygasłym członkostwie — członkowie z wygasłym członkostwem, którzy nadal przychodzą (wyszukiwanie na osi czasu według statusu członkostwa), trafiają na listę do dalszego kontaktu; rozmowa pozostaje po stronie człowieka, zautomatyzowane jest tylko wykrywanie.
  • Cotygodniowe podsumowanie operacyjne — insights_report_snapshots podsumowane na czacie zespołu: wizyty, godziny szczytu, odsetek niepewnych, naruszenia dostępu.
  • Higiena identyfikacji — insights_match_unidentified uruchamiane co tydzień w celu proponowania prawdopodobnych tożsamości i scaleń duplikatów, co pozwala utrzymać krótką kolejkę Self Learning.
  • Smart Display na Twoich ekranach — opcjonalny pomysł dla urządzenia Agent AI z włączonym MCP access (ustawienie domyślne) i funkcją CCTV w zakresie: automatyzacja uruchamiana co kilka minut w godzinach przyjść sprawdza insights_checkins, czyli zameldowania synchronizowane z integracji z Twoim systemem zarządzania członkami, pod kątem osób, które właśnie przyszły, i aktualizuje aplikację opublikowaną przez agenta na Twoich Display Screens, na przykład tabelę wyników na siłowni lub urodzinowe powitanie w lobby. Zameldowania docierają do agenta przy jego następnym zaplanowanym sprawdzeniu, więc ekran aktualizuje się w ciągu kilku minut. Powitanie urodzinowe wykorzystuje datę urodzenia, która jest informacją osobową: uwzględniaj wyłącznie osoby, które wyraziły na to zgodę, przestrzegaj obowiązków swojej organizacji w zakresie prywatności i nie pokazuj niczego poza imieniem.

Ponieważ ta sama powierzchnia MCP obsługuje pozostałą część Performance Hub (sterowanie drzwiami, zarządzanie urządzeniami, dane członków), automatyzacje danych o osobach mogą obejmować wiele modułów: "gdy zostanie wykryty członek z wygasłym członkostwem, sprawdź, czy jego dostęp do drzwi również zadziałał, a jeśli tak, oznacz kartę dostępu" to jedna automatyzacja Agenta AI.

Czego narzędzia nie udostępniają

  • Wideo — strumienie na żywo i odtwarzanie są udostępniane przeglądarkom, a nie przez MCP; zobacz Integracje i MCP w CCTV.
  • Obrazy twarzy i wzorce biometryczne — narzędzia zwracają metadane i dane profili, a nie kolekcje twarzy.
  • Operacje zapisu dotyczące osób — identyfikacja, scalanie, dodawanie do czarnej listy i usuwanie to celowo procesy w interfejsie wymagające potwierdzenia przez człowieka.

Tokeny udostępniania dla gości nie mają dostępu do żadnych danych o osobach — zobacz Bezpieczeństwo i prywatność.