Logo Performance HubPerformance Hub
Section du site : Documentation

Intégrations et MCP

Sur cette page

Tout ce qu'AI Insights & People affiche dans son interface (la chronologie, les profils, les enregistrements d'arrivée et les instantanés de rapports) est accessible par programmation via MCP (Model Context Protocol) grâce à sept outils insights_*. Le moyen privilégié de les utiliser est le boîtier Agent IA de votre installation, qui parle MCP nativement et peut à la fois répondre aux questions de manière conversationnelle et exécuter des automatisations sur ces données.

Le fonctionnement général de MCP (les deux points d'accès, les clés phk_…, la portée) est décrit dans Intégrations et MCP de la Vidéosurveillance. Cette page approfondit les outils insights eux-mêmes.

Conditions d'accès

Chaque outil insights_* applique deux niveaux de contrôle, à l'image de l'interface :

  1. Accès au module : le compte appelant doit disposer du module Vidéosurveillance par l'intermédiaire de ses rôles.
  2. Activation de la fonctionnalité : la fonctionnalité People doit être activée pour l'installation ciblée ; sinon, l'outil renvoie la même erreur "People feature is not enabled for this facility" que les API.

La portée par installation s'applique comme partout ailleurs : vous ne pouvez interroger que les installations auxquelles votre compte a accès.

Les sept outils

La chronologie des personnes par programmation : "the primary 'who was in the facility' view". Recherche les blocs de visites détectées par plage de dates, personne, nom, type de correspondance (identifiée / unsure), statut d'abonnement et groupe de caméras. C'est l'outil de base : les questions de fréquentation, les vérifications en dehors des heures d'ouverture et les enquêtes sur les incidents commencent toutes ici.

Recherche les personnes enregistrées (la liste People par programmation) par nom, statut d'abonnement (actif, expiré, suspendu) et attributs, avec le nombre de résultats par facette. Utilisez-le pour transformer « qui est Alex ? » en identifiant de personne avant d'examiner son activité.

insights_person_get

Le profil complet d'une personne, enrichi de ses données d'abonnement : le panneau de profil par programmation.

insights_person_activity

L'historique des détections d'une personne sur une plage de dates : son journal de visites, par visite et par caméra. Se combine naturellement avec insights_person_get : le profil pour le contexte, l'activité pour l'historique.

insights_checkins

L'historique des enregistrements d'arrivée de l'installation provenant de l'intégration de gestion des membres : les passages de badge qui alimentent la correspondance assistée par la visite et Self Learning. Utile en soi (« combien d'enregistrements hier ? ») et comme référence à laquelle comparer les données des caméras.

insights_match_unidentified

Corrèle les détections non identifiées avec les enregistrements d'arrivée par horodatage pour suggérer des correspondances d'identité : une version légère et à la demande de la corrélation Self Learning, qui fait également ressortir les groupes de profils susceptibles d'être des doublons. Idéal pour les questions du type « qui pourrait être ce visiteur unsure ? » posées par un agent.

insights_report_snapshots

Les instantanés de rapports quotidiens : indicateurs clés et décomptes par caméra (détections, pistes, personnes uniques, répartition identifiés/unsure, couverture des enregistrements d'arrivée, données démographiques) pour une plage de dates. L'outil adapté aux tableaux de bord et aux synthèses : il lit des agrégats précalculés plutôt que des détections brutes.

Modèles qui fonctionnent bien

  • Questions-réponses sur la fréquentation : "Who was in the facility at 6 this morning?", "When was Alex Nguyen last in?", avec insights_timeline_search / insights_person_activity, l'Agent IA répondant de manière conversationnelle.
  • Suivi du tailgating : une automatisation planifiée qui croise insights_timeline_search avec insights_checkins ; toute personne détectée à plusieurs reprises sans passage de badge correspondant fait l'objet d'une synthèse quotidienne envoyée au responsable.
  • Relance des membres expirés : les membres expirés qui continuent de venir (recherche dans la chronologie par statut d'abonnement) sont ajoutés à une liste de suivi ; la conversation reste humaine, la détection est automatisée.
  • Synthèse hebdomadaire des opérations : insights_report_snapshots résumé dans la messagerie de l'équipe : visites, heures de pointe, pourcentage unsure, violations d'accès.
  • Hygiène de l'identification : insights_match_unidentified exécuté chaque semaine pour proposer des identités probables et des fusions de doublons, afin de garder la file Self Learning courte.
  • Un Smart Display sur vos écrans : une idée facultative pour un appareil Agent IA dont l'MCP access est activé (par défaut) et dont la portée inclut la capacité Vidéosurveillance. Une automatisation qui s'exécute toutes les quelques minutes pendant les heures d'arrivée consulte insights_checkins, les enregistrements d'arrivée synchronisés depuis l'intégration de votre système de gestion des membres, pour repérer les personnes qui viennent d'arriver, et met à jour une application que l'agent a publiée sur vos Display Screens, par exemple un classement de salle de sport ou un message d'anniversaire dans le hall. Les enregistrements d'arrivée parviennent à l'agent lors de sa prochaine vérification planifiée, si bien que l'écran se met à jour en quelques minutes. Un message d'anniversaire utilise la date de naissance, qui est une donnée personnelle : n'incluez que les personnes qui y ont consenti, respectez les obligations de votre organisation en matière de confidentialité et n'affichez rien de plus qu'un prénom.

Comme la même interface MCP couvre le reste de Performance Hub (contrôle des portes, gestion des appareils, données des membres), les automatisations sur les données des personnes peuvent couvrir plusieurs modules : "when an expired member is detected, check whether their door access also worked, and if so flag the access card" constitue une seule automatisation Agent IA.

Ce que les outils n'exposent pas

  • La vidéo : les flux en direct et la lecture sont fournis aux navigateurs, pas via MCP ; consultez Intégrations et MCP de la Vidéosurveillance.
  • Les images de visages et les références biométriques : les outils renvoient des métadonnées et des données de profil, pas les collections de visages.
  • Les opérations d'écriture sur les personnes : l'identification, la fusion, l'ajout à la liste noire et la suppression sont des flux de l'interface soumis à une confirmation humaine, par conception.

Les jetons de partage invité n'ont accès à aucune donnée sur les personnes : consultez Sécurité et confidentialité.