Logo Performance HubPerformance Hub
Sekcja witryny: Dokumentacja

Integracje i MCP

Na tej stronie

CCTV / VSaaS udostępnia swoje dane programowo za pośrednictwem MCP (Model Context Protocol) — tego samego interfejsu integracji, który jest używany w całym Performance Hub. Preferowanym sposobem tworzenia rozwiązań na platformie jest urządzenie Agent AI, które natywnie obsługuje MCP, zna kontekst obiektu i może reagować na zdarzenia w czasie rzeczywistym.

Dwie ścieżki dostępu

ŚcieżkaCzym jestKiedy
Urządzenie Agent AI (preferowane)Agent AI Twojego obiektu od razu łączy się z Performance Hub przez MCP. Zadawaj mu pytania ("kto był w obiekcie dziś o 6 rano?"), twórz automatyzacje, które reagują na zdarzenia, i pozwól mu łączyć dane z CCTV ze wszystkim, co jeszcze wieNiemal wszystko — bez kodu, w czasie rzeczywistym i w formie rozmowy
Bezpośrednie MCPDowolny klient lub agent obsługujący MCP, który łączy się za pomocą klucza MCP Performance HubOprogramowanie niestandardowe, zewnętrzne platformy agentów, integracje oparte na skryptach

Ścieżka przez Agenta AI jest preferowana, ponieważ zdarzenia trafiają do niego na bieżąco — wykrycie osoby, przejście urządzenia w tryb offline — dzięki czemu zbudowane na niej integracje są reaktywne, a nie oparte na odpytywaniu. Szczegóły łączenia Agenta AI znajdziesz na stronie Łączenie z Performance Hub.

Uwierzytelnianie i zakres

Bezpośredni dostęp przez MCP jest uwierzytelniany za pomocą osobistego klucza MCP (tokenu phk_…) wygenerowanego w profilu Performance Hub. Każde wywołanie narzędzia podlega tym samym zasadom co interfejs:

  • Możesz wysyłać zapytania tylko dotyczące obiektów, do których Twoje konto ma dostęp.
  • Dostępność narzędzi zależy od modułów: narzędzia wizyjne i dotyczące osób wymagają, aby obiekt miał włączone CCTV i funkcje dotyczące osób; narzędzia urządzeń wymagają modułu Zarządzanie urządzeniami.
  • Wywołania podlegają tym samym zasadom audytu co reszta platformy.

Traktuj klucze MCP jak hasła — w miarę możliwości przypisuj je do kont usługowych i zmieniaj je, gdy zmieniają się pracownicy.

Dostępne narzędzia

Pełny, zawsze aktualny katalog narzędzi MCP — nazwy, parametry i zwracane dane — znajduje się w dokumentacji MCP w sekcji Korzystanie z AI, dzięki czemu istnieje jedno źródło informacji. W przypadku tego modułu istotne są następujące kategorie:

  • Narzędzia CCTV — kamery i urządzenia Edge Processor oraz wyszukiwanie nagrań według znaczenia, czyli to samo wyszukiwanie, które działa na stronie CCTV.
  • Narzędzia AI Insights & People — dane o osobach: przeszukiwanie osi czasu wykryć, wyszukiwanie osób i ich aktywności związanej z wizytami, historia zameldowań i migawki raportów obiektu.
  • Narzędzia modułu Zarządzanie urządzeniami — wyświetlanie listy urządzeń Edge Processor i kamer wraz z ich stanem oraz wysyłanie zdalnych poleceń do urządzeń.

Ten sam interfejs MCP obejmuje resztę Performance Hub — sterowanie drzwiami i bramami, wyszukiwanie profili użytkowników i obiektów i nie tylko — dzięki czemu integracja może obejmować wiele modułów: "gdy po godzinach pracy zostanie wykryta nieznana osoba, sprawdź dzienniki drzwi i powiadom kierownika" to jedna automatyzacja Agenta AI, a nie trzy systemy.

Sprawdzone wzorce

  • Monitorowanie po godzinach pracy — automatyzacja Agenta AI reagująca na zdarzenia wykrycia poza godzinami otwarcia i powiadamiająca pracowników, wraz z kamerą i znacznikiem czasu.
  • Codzienne podsumowanie — zaplanowana automatyzacja podsumowująca poprzedni dzień: wizyty, godziny największego ruchu, stan kamer, zaległości w przesyłaniu.
  • Monitorowanie floty urządzeń na dużą skalę — operatorzy wielu obiektów odpytują narzędzia do wyświetlania listy urządzeń we wszystkich obiektach za pomocą narzędzi swojego centrum NOC lub pozwalają Agentowi AI obserwować sytuację i eskalować problemy.
  • Asystent dochodzeń — na pytanie "pokaż wszystkich, którzy weszli między 17 a 18" odpowiada w formie rozmowy narzędzie przeszukiwania osi czasu wykryć, zamiast ręcznego przewijania nagrań.

Czego integracje nie mogą robić

Interfejs MCP zapewnia dostęp do danych i warstwy sterowania. Sam obraz — strumienie na żywo i odtwarzanie nagrań — jest udostępniany przeglądarkom za pośrednictwem modułu i linków udostępniania dla gości, a nie przez MCP. Aby przekazać nagrania podmiotowi zewnętrznemu, wygeneruj link udostępniania.