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

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

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

CCTV / VSaaS предоставляет свои данные программно через MCP (Model Context Protocol) — тот же интерфейс интеграции, который используется во всем Performance Hub. Предпочтительный способ разработки на основе платформы — через устройство ИИ-агента, которое изначально поддерживает MCP, знает контекст объекта и может реагировать на события в реальном времени.

Два способа подключения

ПутьЧто этоКогда использовать
Устройство ИИ-агента (предпочтительно)ИИ-агент вашего объекта сразу подключается к Performance Hub через MCP. Задавайте ему вопросы ("кто был на объекте сегодня в 6 утра?"), создавайте автоматизации, реагирующие на события, и позвольте ему сопоставлять данные видеонаблюдения со всем остальным, что ему известноПочти всегда — без кода, в реальном времени и в формате диалога
Прямое подключение к MCPЛюбой клиент или агент с поддержкой MCP, подключающийся с ключом MCP Performance HubСобственное ПО, внешние платформы агентов, интеграции на основе скриптов

Путь через ИИ-агента предпочтителен, потому что события поступают к нему по мере возникновения — обнаружение человека, переход устройства в состояние оффлайн, — поэтому созданные там интеграции реагируют на события, а не опрашивают систему. Подробности подключения ИИ-агента приведены в разделе Подключение к Performance Hub.

Аутентификация и область действия

Для прямого доступа к MCP используется личный ключ MCP (токен phk_…), созданный в вашем профиле Performance Hub. Каждый вызов инструмента ограничивается теми же правилами, что и интерфейс:

  • Запрашивать данные можно только по объектам, к которым у вашей учетной записи есть доступ.
  • Инструменты доступны в зависимости от модуля: для инструментов компьютерного зрения и данных о людях на объекте должны быть включены видеонаблюдение и функции, связанные с людьми; для инструментов устройств требуется модуль Управление устройствами.
  • На вызовы распространяются те же правила аудита, что и на остальную часть платформы.

Обращайтесь с ключами MCP как с паролями: по возможности привязывайте их к служебным учетным записям и меняйте при смене персонала.

Набор инструментов

Полный и всегда актуальный каталог инструментов MCP — названия, параметры и возвращаемые данные — находится в документации по MCP в разделе Use with AI, чтобы у вас был единый источник достоверной информации. Для этого модуля актуальны следующие категории:

  • Инструменты видеонаблюдения — камеры и Edge Processor, а также поиск по записанным видеозаписям по смыслу — тот же поиск, что выполняется на странице видеонаблюдения.
  • Инструменты AI Insights & People — доступ к данным о людях: поиск по временной шкале обнаружений, поиск людей и их посещений, история отметок о посещении и снимки отчетов по объекту.
  • Инструменты Управление устройствами — список Edge Processor и камер с их состоянием и отправка удаленных команд на устройства.

Тот же интерфейс MCP охватывает и остальную часть Performance Hub — управление дверями и воротами, поиск профилей пользователей и объектов и многое другое, — поэтому интеграция может охватывать несколько модулей: "если в нерабочее время обнаружен неизвестный человек, проверить журналы дверей и уведомить руководителя" — это одна автоматизация ИИ-агента, а не три системы.

Удачные сценарии

  • Мониторинг в нерабочее время — автоматизация ИИ-агента по событиям обнаружения вне часов работы, уведомляющая персонал с указанием камеры и времени.
  • Ежедневная сводка — запланированная автоматизация, подводящая итоги вчерашнего дня: посещения, самые загруженные часы, состояние камер, очередь загрузки.
  • Мониторинг крупного парка устройств — операторы с несколькими объектами опрашивают инструменты списка устройств по всем объектам из средств своего центра мониторинга сети (NOC) или поручают наблюдение и эскалацию ИИ-агенту.
  • Помощник в расследованиях — запрос "покажи всех, кто вошел между 5 и 6 часами вечера" обрабатывается в формате диалога с помощью инструментов поиска по временной шкале обнаружений, без ручной прокрутки.

Чего не могут интеграции

Интерфейс MCP предоставляет доступ к данным и уровню управления. Само видео — потоки в реальном времени и воспроизведение записей — передается в браузеры через модуль и гостевые ссылки для общего доступа, а не через MCP. Чтобы передать видеозаписи внешней стороне, создайте ссылку для общего доступа.