Performance Hub 徽标Performance Hub
网站版块： 文档

集成与 MCP

本页内容

AI Insights & People 在界面中显示的所有内容（时间线、档案、签到记录和报告快照）都可以通过 **MCP（Model Context Protocol）**中的七个 insights_* 工具以编程方式获取。使用这些工具的首选方式是您设施的人工智能代理设备，它原生支持 MCP，既能以对话方式回答问题，也能基于这些数据运行自动化。

通用的 MCP 机制（两种接入方式、phk_… 密钥、范围限定）在 CCTV 集成与 MCP 中说明。本页更深入地介绍 insights 工具本身。

访问要求

每个 insights_* 工具都会执行两层检查，与界面保持一致：

  1. 模块访问：调用账户需要通过其角色获得 CCTV 模块。
  2. 功能启用：目标设施必须已启用 People 功能；否则该工具会返回与 API 相同的 "People feature is not enabled for this facility" 错误。

设施范围限定与其他地方一样适用：您只能查询您的账户有权访问的设施。

七个工具

以编程方式访问的人员时间线，即 "the primary 'who was in the facility' view"。按日期范围、人员、姓名、匹配类型（identified / unsure）、会员状态和摄像头组搜索检测到访块。这是最常用的工具：到访问题、非营业时间检查和事件调查都从这里开始。

按姓名、会员状态（active、expired、on hold）和属性搜索已登记人员（即以编程方式访问的 People 列表），并返回分面计数。在深入查看活动之前，可以用它将"Alex 是谁？"解析为人员 ID。

insights_person_get

某个人的完整档案，并附有其会员数据，即以编程方式访问的档案面板。

insights_person_activity

某个人在某一日期范围内的检测历史，即按到访和按摄像头列出的到访日志。它与 insights_person_get 自然搭配：档案提供背景信息，活动提供历史记录。

insights_checkins

来自会员管理集成的设施签到历史，即为到访辅助匹配和 Self Learning 提供支持的刷卡记录。它本身就很有用（"昨天有多少次签到？"），也可作为与摄像头数据进行比对的基准事实。

insights_match_unidentified

按时间戳将未识别检测与签到记录相关联，以建议身份匹配。这是 Self Learning 关联的轻量级按需版本，同时还会列出疑似重复的档案组。适合代理回答"这位 unsure 访客可能是谁？"之类的问题。

insights_report_snapshots

某一日期范围内的每日报告快照：KPI 和按摄像头的计数（检测、轨迹、独立人数、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（默认开启）且范围内包含 CCTV 功能的人工智能代理设备。一项在到达高峰时段每隔几分钟运行一次的自动化会检查 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 提供；请参阅 CCTV 集成与 MCP。
  • 人脸图像和生物特征参考：这些工具返回元数据和档案数据，而不是人脸集合。
  • 对人员的写入操作：识别、合并、加入黑名单和删除均为需要人工确认的界面工作流程，这是有意的设计。

访客共享令牌无法访问任何人员数据，请参阅安全与隐私。