Логотип Performance HubPerformance Hub
Раздел сайта: Документация

Интеграции и MCP

На этой странице

Всё, что AI Insights & People показывает в интерфейсе, — хронология, профили, отметки при входе и снимки отчётов — доступно программно через MCP (Model Context Protocol) с помощью семи инструментов insights_*. Предпочтительный способ работы с ними — устройство ИИ-агента вашего объекта: оно изначально поддерживает MCP и может как отвечать на вопросы в диалоге, так и выполнять автоматизации на основе этих данных.

Общие механизмы MCP — два способа подключения, ключи phk_…, области доступа — описаны в разделе Интеграции и MCP для видеонаблюдения. На этой странице подробнее рассматриваются сами инструменты аналитики.

Требования к доступу

Каждый инструмент insights_* применяет два уровня проверки, как и интерфейс:

  1. Доступ к модулю — у вызывающей учётной записи должен быть доступ к модулю «Видеонаблюдение» через её роли.
  2. Включение функции — на целевом объекте должна быть включена функция People; в противном случае инструмент возвращает ту же ошибку "People feature is not enabled for this facility", что и API.

Ограничение по объектам действует так же, как и везде: запрашивать можно только те объекты, к которым есть доступ у вашей учётной записи.

Семь инструментов

Программный аналог хронологии посещений людей — "the primary 'who was in the facility' view". Ищет блоки посещений с обнаружениями по диапазону дат, человеку, имени, типу совпадения (identified / unsure), статусу членства и группе камер. Это основной инструмент: вопросы о посещаемости, проверки во внерабочее время и расследования инцидентов начинаются с него.

Ищет зарегистрированных людей — программный аналог списка People — по имени, статусу членства (active, expired, on hold) и признакам, с подсчётом по фасетам. Используйте его, чтобы превратить вопрос «кто такой Alex?» в идентификатор человека, прежде чем переходить к его активности.

insights_person_get

Полный профиль одного человека, дополненный данными о его членстве, — программный аналог панели профиля.

insights_person_activity

История обнаружений человека за диапазон дат — его журнал посещений по каждому посещению и каждой камере. Естественно сочетается с insights_person_get: профиль даёт контекст, активность — историю.

insights_checkins

История отметок при входе на объекте из интеграции с системой управления участниками — записи проходов, на которых основаны сопоставление с учётом посещений и Self Learning. Полезен сам по себе («сколько было отметок вчера?») и как эталон для сравнения с данными камер.

insights_match_unidentified

Сопоставляет неидентифицированные обнаружения с записями отметок при входе по времени, чтобы предложить возможные совпадения личности, — облегчённая версия корреляции Self Learning, выполняемая по запросу; кроме того, выявляет группы предположительно дублирующихся профилей. Подходит для вопросов агенту вроде «кем может быть этот посетитель со статусом unsure?».

insights_report_snapshots

Ежедневные снимки отчётов: ключевые показатели и счётчики по камерам (обнаружения, треки, уникальные люди, соотношение identified/unsure, охват отметками при входе, демографические данные) за диапазон дат. Подходящий инструмент для панелей мониторинга и сводок: он читает заранее рассчитанные агрегаты, а не необработанные обнаружения.

Эффективные сценарии

  • Вопросы и ответы о посещаемости — "Who was in the facility at 6 this morning?", "When was Alex Nguyen last in?" — insights_timeline_search / insights_person_activity, ответы в диалоге от ИИ-агента.
  • Контроль прохода «паровозиком» — запланированная автоматизация, сверяющая insights_timeline_search с insights_checkins: по всем, кто неоднократно обнаруживался без соответствующего прохода по карте, менеджер получает ежедневную сводку.
  • Работа с участниками с истёкшим членством — участники с истёкшим членством, которые продолжают приходить (поиск по хронологии по статусу членства), попадают в список для последующего контакта; разговор с человеком остаётся за людьми, автоматизировано только обнаружение.
  • Еженедельная операционная сводка — данные insights_report_snapshots, обобщённые в командном чате: посещения, часы пик, доля unsure, нарушения доступа.
  • Поддержание качества идентификации — еженедельный запуск insights_match_unidentified, предлагающий вероятные личности и объединение дубликатов, чтобы очередь Self Learning оставалась короткой.
  • Smart Display на ваших экранах — необязательная идея для устройства ИИ-агента с включённым параметром MCP access (по умолчанию) и возможностями видеонаблюдения в его области доступа: автоматизация, запускаемая каждые несколько минут в часы прибытия, проверяет в insights_checkins (отметки при входе, синхронизированные из интеграции с вашей системой управления участниками) только что пришедших людей и обновляет приложение, опубликованное агентом на ваших Display Screens, например таблицу лидеров спортзала или поздравление с днём рождения в вестибюле. Отметки при входе поступают к агенту при его следующей плановой проверке, поэтому экран обновляется в течение нескольких минут. Для поздравления с днём рождения используется дата рождения, а это персональные данные: включайте только людей, давших на это согласие, соблюдайте обязательства вашей организации в области конфиденциальности и показывайте не больше чем имя.

Поскольку через тот же интерфейс MCP доступны и остальные возможности Performance Hub (управление дверями, управление устройствами, данные участников), автоматизации для данных о людях могут охватывать несколько модулей: "when an expired member is detected, check whether their door access also worked, and if so flag the access card" — это одна автоматизация ИИ-агента.

Что инструменты не предоставляют

  • Видео — прямые трансляции и воспроизведение передаются в браузеры, а не через MCP; см. раздел Интеграции и MCP для видеонаблюдения.
  • Изображения лиц и биометрические эталоны — инструменты возвращают метаданные и данные профилей, а не коллекции лиц.
  • Операции записи над данными людей — идентификация, объединение, добавление в чёрный список и удаление намеренно выполняются только в интерфейсе с подтверждением человеком.

Гостевые токены общего доступа не дают доступа ни к каким данным о людях — см. раздел Безопасность и конфиденциальность.