Performance Hub-logoPerformance Hub
Sitesectie: Documentatie

Integraties en MCP

Op deze pagina

Alles wat AI Insights & People in de interface toont (de tijdlijn, profielen, check-ins en momentopnamen van rapporten) is programmatisch beschikbaar via MCP (Model Context Protocol) met zeven insights_*-tools. De aanbevolen manier om ze te gebruiken is het AI-agent-apparaat van je faciliteit, dat standaard MCP spreekt en zowel vragen in een gesprek kan beantwoorden als automatiseringen op de gegevens kan uitvoeren.

De algemene werking van MCP (de twee toegangswegen, phk_…-sleutels, afbakening) wordt beschreven in Integraties en MCP van Camerabewaking. Deze pagina gaat dieper in op de insights-tools zelf.

Toegangsvereisten

Elke insights_*-tool hanteert twee lagen, net als de interface:

  1. Moduletoegang: het aanroepende account heeft via zijn rollen de module Camerabewaking nodig.
  2. Functie ingeschakeld: voor de doelfaciliteit moet de functie People zijn ingeschakeld; anders geeft de tool dezelfde foutmelding "People feature is not enabled for this facility" als de API's.

Afbakening per faciliteit geldt net als overal: je kunt alleen faciliteiten opvragen waar je account toegang toe heeft.

De zeven tools

De programmatische tijdlijn van personen: "the primary 'who was in the facility' view". Doorzoekt blokken met detectiebezoeken op datumbereik, persoon, naam, koppelingstype (geïdentificeerd / onzeker), lidmaatschapsstatus en cameragroep. Dit is het werkpaard: vragen over aanwezigheid, controles buiten openingstijden en onderzoek naar incidenten beginnen allemaal hier.

Doorzoekt geregistreerde personen, de programmatische lijst People, op naam, lidmaatschapsstatus (actief, verlopen, gepauzeerd) en kenmerken, met aantallen per facet. Gebruik dit om "wie is Alex?" om te zetten in een persoons-ID voordat je de activiteit induikt.

insights_person_get

Het volledige profiel van één persoon, verrijkt met de lidmaatschapsgegevens: het programmatische profielpaneel.

insights_person_activity

De detectiegeschiedenis van een persoon over een datumbereik: het bezoeklogboek, per bezoek en per camera. Past goed bij insights_person_get: het profiel voor context, de activiteit voor de geschiedenis.

insights_checkins

De check-ingeschiedenis van de faciliteit uit de integratie met het ledenbeheersysteem: de pasregistraties die de basis vormen voor koppeling op basis van bezoek en Self Learning. Op zichzelf nuttig ("hoeveel check-ins waren er gisteren?") en als de werkelijke referentie om cameragegevens mee te vergelijken.

insights_match_unidentified

Correleert niet-geïdentificeerde detecties op tijdstempel met check-inregistraties om identiteitskoppelingen voor te stellen: een lichte versie op aanvraag van de correlatie van Self Learning, die ook vermoedelijke groepen dubbele profielen naar voren brengt. Goed voor vragen van een agent als "wie zou deze onzekere bezoeker kunnen zijn?".

insights_report_snapshots

De dagelijkse momentopnamen van rapporten: KPI's en aantallen per camera (detecties, tracks, unieke personen, verdeling geïdentificeerd/onzeker, dekking van check-ins, demografie) voor een datumbereik. De juiste tool voor dashboards en overzichten: deze leest vooraf berekende totalen in plaats van ruwe detecties.

Patronen die goed werken

  • Vragen over aanwezigheid: "Who was in the facility at 6 this morning?", "When was Alex Nguyen last in?": insights_timeline_search / insights_person_activity, in een gesprek beantwoord door de AI-agent.
  • Opvolging van meelopen: een geplande automatisering die insights_timeline_search vergelijkt met insights_checkins: iedereen die herhaaldelijk wordt gedetecteerd zonder bijbehorende pasregistratie, komt in een dagelijks overzicht voor de manager.
  • Contact met verlopen leden: verlopen leden die nog steeds langskomen (zoeken op de tijdlijn op lidmaatschapsstatus) worden doorgezet naar een opvolglijst; het gesprek blijft menselijk, de detectie is geautomatiseerd.
  • Wekelijks operationeel overzicht: insights_report_snapshots samengevat in de teamchat: bezoeken, piekuren, onzeker %, toegangsovertredingen.
  • Identificatiehygiëne: insights_match_unidentified wekelijks uitvoeren om waarschijnlijke identiteiten en samenvoegingen van dubbele profielen voor te stellen, zodat de wachtrij van Self Learning kort blijft.
  • Een Smart Display op je schermen: een optioneel idee voor een AI-agent-apparaat met MCP access aan (de standaard) en de mogelijkheid Camerabewaking binnen het bereik: een automatisering die tijdens aankomsturen om de paar minuten draait, controleert insights_checkins, de check-ins die zijn gesynchroniseerd vanuit de integratie met je ledenbeheersysteem, op personen die net zijn aangekomen en werkt een app bij die de agent op je Display Screens heeft gepubliceerd, bijvoorbeeld een ranglijst in een sportschool of een verjaardagswelkom in de lobby. Check-ins bereiken de agent bij de volgende geplande controle, dus het scherm wordt binnen een paar minuten bijgewerkt. Een verjaardagswelkom gebruikt de geboortedatum, en dat is persoonlijke informatie: neem alleen personen op die daarmee hebben ingestemd, volg de privacyverplichtingen van je organisatie en toon niet meer dan een voornaam.

Omdat dezelfde MCP-interface ook de rest van Performance Hub ontsluit (deurbediening, apparaatbeheer, ledengegevens), kunnen automatiseringen met gegevens over personen meerdere modules omvatten: "when an expired member is detected, check whether their door access also worked, and if so flag the access card" is één automatisering van de AI-agent.

Wat de tools niet beschikbaar stellen

  • Video: livestreams en afspelen worden aan browsers geleverd, niet via MCP; zie Integraties en MCP van Camerabewaking.
  • Gezichtsbeelden en biometrische referenties: de tools geven metadata en profielgegevens terug, niet de gezichtsverzamelingen.
  • Schrijfbewerkingen op personen: identificeren, samenvoegen, op de zwarte lijst zetten en verwijderen zijn bewust workflows in de interface met menselijke bevestiging.

Tokens voor delen met gasten hebben geen toegang tot gegevens over personen: zie Beveiliging en privacy.