Logotipo do Performance HubPerformance Hub
Seção do site: Documentação

Integrações e MCP

Nesta página

Tudo o que o AI Insights & People mostra na interface — a linha do tempo, os perfis, os check-ins e os snapshots de relatórios — está disponível de forma programática por meio do MCP (Model Context Protocol), com sete ferramentas insights_*. A forma preferencial de consumi-las é o appliance do Agente de IA da sua instalação, que fala MCP nativamente e pode tanto responder a perguntas em linguagem natural quanto executar automações com os dados.

Os mecanismos gerais do MCP — as duas formas de acesso, as chaves phk_… e o escopo — são abordados em Integrações e MCP do CFTV. Esta página se aprofunda nas próprias ferramentas de insights.

Requisitos de acesso

Cada ferramenta insights_* aplica duas camadas, espelhando a interface:

  1. Acesso ao módulo — a conta que faz a chamada precisa ter o módulo CFTV por meio das suas funções.
  2. Habilitação do recurso — a instalação de destino precisa ter o recurso People habilitado; caso contrário, a ferramenta retorna o mesmo erro "People feature is not enabled for this facility" que as APIs.

O escopo de instalação se aplica como em qualquer outro lugar: você só pode consultar instalações às quais a sua conta tem acesso.

As sete ferramentas

A linha do tempo de pessoas em formato programático — "the primary 'who was in the facility' view". Pesquisa blocos de visitas de detecção por intervalo de datas, pessoa, nome, tipo de correspondência (identified / unsure), status da associação e grupo de câmeras. É a ferramenta principal: perguntas sobre frequência, verificações fora do horário e investigações de incidentes começam aqui.

Pesquisa pessoas registradas — a lista People em formato programático — por nome, status da associação (ativa, expirada, suspensa) e atributos, com contagens por faceta. Use-a para transformar "quem é Alex?" em um ID de pessoa antes de detalhar a atividade.

insights_person_get

O perfil completo de uma pessoa, enriquecido com os dados da associação dela — o painel de perfil em formato programático.

insights_person_activity

O histórico de detecções de uma pessoa em um intervalo de datas — o registro de visitas, por visita e por câmera. Combina naturalmente com insights_person_get: o perfil para contexto e a atividade para o histórico.

insights_checkins

O histórico de check-ins da instalação vindo da integração com o sistema de gestão de membros — os registros de passagem de cartão que alimentam a correspondência assistida pela visita e o Self Learning. Útil por si só ("quantos check-ins ontem?") e como a referência confiável com a qual comparar os dados das câmeras.

insights_match_unidentified

Correlaciona detecções não identificadas com registros de check-in por data e hora para sugerir correspondências de identidade — uma versão leve e sob demanda da correlação do Self Learning, que também revela grupos de perfis possivelmente duplicados. Boa para perguntas de um agente como "quem pode ser este visitante unsure?".

insights_report_snapshots

Os snapshots diários de relatórios: KPIs e contagens por câmera (detecções, tracks, pessoas únicas, divisão entre identified/unsure, cobertura de check-ins, dados demográficos) para um intervalo de datas. A ferramenta certa para painéis e resumos — ela lê agregados pré-calculados em vez de detecções brutas.

Padrões que funcionam bem

  • Perguntas e respostas sobre frequência — "Who was in the facility at 6 this morning?", "When was Alex Nguyen last in?" — insights_timeline_search / insights_person_activity, respondidas em linguagem natural pelo Agente de IA.
  • Acompanhamento de tailgating — uma automação programada que cruza insights_timeline_search com insights_checkins: qualquer pessoa detectada repetidamente sem uma passagem de cartão correspondente entra em um resumo diário enviado ao gerente.
  • Contato com membros expirados — membros expirados que continuam visitando (pesquisa na linha do tempo por status da associação) são enviados para uma lista de acompanhamento; a conversa continua sendo humana, a detecção é automatizada.
  • Resumo semanal de operações — insights_report_snapshots resumido no chat da equipe: visitas, horários de pico, unsure %, violações de acesso.
  • Higiene de identificação — insights_match_unidentified executado semanalmente para propor identidades prováveis e mesclagens de duplicados, mantendo a fila do Self Learning curta.
  • Um Smart Display nas suas telas — uma ideia opcional para um dispositivo do Agente de IA com MCP access ativado (o padrão) e a capacidade de CFTV no escopo: uma automação executada a cada poucos minutos durante os horários de chegada consulta insights_checkins, os check-ins sincronizados pela integração com o seu sistema de gestão de membros, em busca de pessoas que acabaram de chegar e atualiza um app que o agente publicou nas suas Display Screens, por exemplo, um ranking de academia ou uma mensagem de aniversário no saguão. Os check-ins chegam ao agente na próxima verificação programada, então a tela é atualizada em poucos minutos. Uma mensagem de aniversário usa a data de nascimento, que é uma informação pessoal: inclua apenas pessoas que concordaram com isso, siga as obrigações de privacidade da sua organização e não mostre mais do que o primeiro nome.

Como a mesma superfície MCP abrange o restante do Performance Hub (controle de portas, gerenciamento de dispositivos, dados de membros), as automações com dados de pessoas podem envolver vários módulos: "when an expired member is detected, check whether their door access also worked, and if so flag the access card" é uma única automação do Agente de IA.

O que as ferramentas não expõem

  • Vídeo — transmissões ao vivo e reprodução são fornecidas aos navegadores, não pelo MCP; consulte Integrações e MCP do CFTV.
  • Imagens faciais e referências biométricas — as ferramentas retornam metadados e dados de perfil, não as coleções de rostos.
  • Operações de escrita sobre pessoas — identificar, mesclar, adicionar à lista de bloqueio e excluir são fluxos da interface com confirmação humana, por design.

Os tokens de compartilhamento de convidados não têm acesso a nenhum dado de pessoas — consulte Segurança e privacidade.