Logotipo de Performance HubPerformance Hub
Sección del sitio: Documentación

Integraciones y MCP

En esta página

Todo lo que AI Insights & People muestra en su interfaz (la línea de tiempo, los perfiles, los registros de entrada y las instantáneas de los informes) está disponible mediante programación a través de MCP (Model Context Protocol) con siete herramientas insights_*. La forma preferida de usarlas es el dispositivo de Agente de IA de tu instalación, que usa MCP de forma nativa y puede tanto responder preguntas de forma conversacional como ejecutar automatizaciones con los datos.

Los mecanismos generales de MCP (las dos vías de acceso, las claves phk_… y el alcance) se explican en Integraciones y MCP de CCTV. Esta página profundiza en las herramientas de insights.

Requisitos de acceso

Cada herramienta insights_* aplica dos niveles de control, igual que la interfaz:

  1. Acceso al módulo: la cuenta que hace la llamada necesita el módulo CCTV a través de sus roles.
  2. Habilitación de la función: la instalación de destino debe tener habilitada la función People; de lo contrario, la herramienta devuelve el mismo error "People feature is not enabled for this facility" que las API.

El alcance por instalación se aplica igual que en el resto de la plataforma: solo puedes consultar las instalaciones a las que tu cuenta tiene acceso.

Las siete herramientas

La línea de tiempo de personas mediante programación: "the primary 'who was in the facility' view". Busca bloques de visitas de detección por rango de fechas, persona, nombre, tipo de coincidencia (identified / unsure), estado de la membresía y grupo de cámaras. Es la herramienta principal: las preguntas de asistencia, las comprobaciones fuera del horario y la investigación de incidentes empiezan aquí.

Busca personas registradas (la lista People mediante programación) por nombre, estado de la membresía (activa, vencida, en pausa) y atributos, con recuentos por faceta. Úsala para convertir "¿quién es Alex?" en un ID de persona antes de profundizar en su actividad.

insights_person_get

El perfil completo de una persona, enriquecido con sus datos de membresía: el panel de perfil mediante programación.

insights_person_activity

El historial de detecciones de una persona en un rango de fechas: su registro de visitas, por visita y por cámara. Se complementa de forma natural con insights_person_get: el perfil para el contexto y la actividad para el historial.

insights_checkins

El historial de registros de entrada de la instalación desde la integración con el sistema de gestión de miembros: los registros de deslizamiento de tarjeta que hacen posibles la asociación asistida por la visita y Self Learning. Es útil por sí sola ("¿cuántos registros de entrada hubo ayer?") y como referencia real con la que comparar los datos de las cámaras.

insights_match_unidentified

Correlaciona las detecciones no identificadas con los registros de entrada por marca de tiempo para sugerir coincidencias de identidad: una versión ligera y a pedido de la correlación de Self Learning, que además muestra grupos de perfiles posiblemente duplicados. Es adecuada para preguntas como "¿quién podría ser este visitante unsure?" desde un agente.

insights_report_snapshots

Las instantáneas diarias de los informes: indicadores clave y recuentos por cámara (detecciones, seguimientos, personas únicas, división entre identificados y unsure, cobertura de registros de entrada, datos demográficos) para un rango de fechas. Es la herramienta adecuada para paneles y resúmenes, ya que lee agregados calculados previamente en lugar de detecciones sin procesar.

Patrones que funcionan bien

  • Preguntas y respuestas sobre asistencia: "Who was in the facility at 6 this morning?", "When was Alex Nguyen last in?"; insights_timeline_search / insights_person_activity, respondidas de forma conversacional por el Agente de IA.
  • Seguimiento de accesos indebidos (tailgating): una automatización programada que cruza insights_timeline_search con insights_checkins: a quien se detecte repetidamente sin un deslizamiento de tarjeta correspondiente se le incluye en un resumen diario para el gerente.
  • Contacto con miembros vencidos: los miembros vencidos que siguen visitando (búsqueda en la línea de tiempo por estado de la membresía) se envían a una lista de seguimiento; la conversación sigue siendo humana y la detección es automática.
  • Resumen semanal de operaciones: insights_report_snapshots resumido en el chat del equipo: visitas, horas pico, porcentaje de unsure e infracciones de acceso.
  • Higiene de la identificación: insights_match_unidentified ejecutado cada semana para proponer identidades probables y combinaciones de duplicados, de modo que la cola de Self Learning se mantenga corta.
  • Una Smart Display en tus pantallas: una idea opcional para un dispositivo de Agente de IA con MCP access activado (el valor predeterminado) y la capacidad de CCTV dentro de su alcance: una automatización que se ejecuta cada pocos minutos durante las horas de llegada consulta insights_checkins, los registros de entrada sincronizados desde la integración con tu sistema de gestión de miembros, para detectar a las personas que acaban de llegar, y actualiza una aplicación que el agente publicó en tus Display Screens, por ejemplo una clasificación del gimnasio o una bienvenida de cumpleaños en el vestíbulo. Los registros de entrada llegan al agente en su siguiente comprobación programada, por lo que la pantalla se actualiza en pocos minutos. Una bienvenida de cumpleaños usa la fecha de nacimiento, que es información personal: incluye solo a las personas que lo hayan aceptado, cumple las obligaciones de privacidad de tu organización y no muestres más que el nombre de pila.

Como la misma interfaz MCP abarca el resto de Performance Hub (control de puertas, gestión de dispositivos, datos de miembros), las automatizaciones con datos de personas pueden abarcar varios módulos: "when an expired member is detected, check whether their door access also worked, and if so flag the access card" es una sola automatización del Agente de IA.

Lo que las herramientas no exponen

  • Video: las transmisiones en vivo y la reproducción se sirven a los navegadores, no a través de MCP; consulta Integraciones y MCP de CCTV.
  • Imágenes faciales y referencias biométricas: las herramientas devuelven metadatos y datos de perfil, no las colecciones faciales.
  • Operaciones de escritura sobre personas: identificar, combinar, agregar a la lista negra y eliminar son flujos de trabajo de la interfaz con confirmación humana, por diseño.

Los tokens de uso compartido para invitados no tienen acceso a ningún dato de personas; consulta Seguridad y privacidad.