Logo Performance HubPerformance Hub
Mục trang: Tài liệu

Tích hợp và MCP

Trên trang này

Mọi thứ AI Insights & People hiển thị trong giao diện — dòng thời gian, hồ sơ, lượt check-in và ảnh chụp nhanh báo cáo — đều có thể truy cập bằng lập trình thông qua MCP (Model Context Protocol) qua bảy công cụ insights_*. Cách được khuyến nghị để sử dụng chúng là thiết bị AI Agent của cơ sở bạn, thiết bị này hỗ trợ MCP nguyên bản, vừa có thể trả lời câu hỏi theo dạng hội thoại vừa có thể chạy các tác vụ tự động trên dữ liệu.

Cơ chế MCP chung — hai cách kết nối, khóa phk_…, phạm vi — được trình bày trong Tích hợp và MCP của CCTV. Trang này đi sâu hơn vào chính các công cụ insights.

Yêu cầu truy cập

Mọi công cụ insights_* đều áp dụng hai lớp kiểm soát, tương tự như giao diện:

  1. Truy cập mô-đun — tài khoản gọi công cụ cần có mô-đun CCTV thông qua các vai trò của mình.
  2. Bật tính năng — cơ sở đích phải được bật tính năng People; nếu không, công cụ sẽ trả về cùng lỗi "People feature is not enabled for this facility" như các API.

Phạm vi cơ sở được áp dụng như ở mọi nơi khác: bạn chỉ có thể truy vấn những cơ sở mà tài khoản của bạn có quyền truy cập.

Bảy công cụ

Phiên bản lập trình của dòng thời gian về con người — "the primary 'who was in the facility' view". Tìm kiếm các khối lượt ghé thăm được phát hiện theo khoảng ngày, người, tên, loại đối chiếu (identified / unsure), trạng thái hội viên và nhóm camera. Đây là công cụ chủ lực: các câu hỏi về lượt có mặt, kiểm tra ngoài giờ và điều tra sự cố đều bắt đầu từ đây.

Tìm kiếm những người đã đăng ký — phiên bản lập trình của danh sách People — theo tên, trạng thái hội viên (đang hoạt động, đã hết hạn, đang tạm dừng) và thuộc tính, kèm số lượng theo từng nhóm. Dùng công cụ này để chuyển câu hỏi "Alex là ai?" thành một ID người trước khi đi sâu vào hoạt động.

insights_person_get

Toàn bộ hồ sơ của một người, được bổ sung dữ liệu hội viên — phiên bản lập trình của bảng hồ sơ.

insights_person_activity

Lịch sử phát hiện của một người trong một khoảng ngày — nhật ký ghé thăm của họ, theo từng lượt ghé thăm và từng camera. Kết hợp tự nhiên với insights_person_get: hồ sơ để có ngữ cảnh, hoạt động để có lịch sử.

insights_checkins

Lịch sử check-in của cơ sở từ tích hợp quản lý hội viên — các bản ghi quẹt thẻ làm nền tảng cho đối chiếu có hỗ trợ từ lượt ghé thăm và Self Learning. Hữu ích khi dùng riêng ("hôm qua có bao nhiêu lượt check-in?") và làm dữ liệu chuẩn để so sánh với dữ liệu camera.

insights_match_unidentified

Tương quan các lần phát hiện chưa được nhận dạng với bản ghi check-in theo dấu thời gian để gợi ý danh tính phù hợp — một phiên bản nhẹ, theo yêu cầu của phép tương quan Self Learning, đồng thời cũng chỉ ra các nhóm hồ sơ nghi trùng lặp. Phù hợp với các câu hỏi kiểu "khách chưa chắc chắn này có thể là ai?" từ một agent.

insights_report_snapshots

Các ảnh chụp nhanh báo cáo hằng ngày: KPI và số liệu theo từng camera (lần phát hiện, vệt theo dõi, số người duy nhất, tỷ lệ đã nhận dạng/chưa chắc chắn, mức độ bao phủ check-in, nhân khẩu học) cho một khoảng ngày. Đây là công cụ phù hợp cho bảng tổng quan và bản tóm tắt — nó đọc các số liệu tổng hợp đã tính trước thay vì các lần phát hiện thô.

Các mô hình sử dụng hiệu quả

  • Hỏi đáp về lượt có mặt — "Who was in the facility at 6 this morning?", "When was Alex Nguyen last in?" — insights_timeline_search / insights_person_activity, được AI Agent trả lời theo dạng hội thoại.
  • Theo dõi trường hợp đi theo sau (tailgating) — một tác vụ tự động theo lịch đối chiếu insights_timeline_search với insights_checkins: bất kỳ ai được phát hiện nhiều lần mà không có lượt quẹt thẻ tương ứng sẽ được đưa vào bản tóm tắt hằng ngày gửi cho người quản lý.
  • Liên hệ hội viên đã hết hạn — các hội viên đã hết hạn nhưng vẫn ghé thăm (tìm kiếm dòng thời gian theo trạng thái hội viên) được chuyển vào danh sách cần liên hệ; cuộc trò chuyện vẫn do con người thực hiện, còn việc phát hiện được tự động hóa.
  • Bản tóm tắt vận hành hằng tuần — insights_report_snapshots được tóm tắt vào kênh trò chuyện của nhóm: lượt ghé thăm, giờ cao điểm, tỷ lệ unsure %, vi phạm quyền truy cập.
  • Duy trì chất lượng nhận dạng — chạy insights_match_unidentified hằng tuần để đề xuất danh tính khả dĩ và các lần gộp trùng lặp, giúp hàng đợi Self Learning luôn ngắn.
  • Smart Display trên màn hình của bạn — một ý tưởng tùy chọn cho thiết bị AI Agent có bật MCP access (mặc định) và có khả năng CCTV trong phạm vi: một tác vụ tự động chạy vài phút một lần trong giờ khách đến sẽ kiểm tra insights_checkins, tức các lượt check-in được đồng bộ từ tích hợp hệ thống quản lý hội viên của bạn, để tìm những người vừa đến và cập nhật một ứng dụng mà agent đã xuất bản lên Display Screens của bạn, chẳng hạn bảng xếp hạng phòng tập hoặc lời chào mừng sinh nhật ở sảnh. Lượt check-in đến agent ở lần kiểm tra theo lịch tiếp theo, vì vậy màn hình được cập nhật trong vòng vài phút. Lời chào mừng sinh nhật sử dụng ngày sinh, vốn là thông tin cá nhân: chỉ đưa vào những người đã đồng ý, tuân thủ các nghĩa vụ về quyền riêng tư của tổ chức bạn và không hiển thị gì ngoài tên gọi.

Vì cùng một giao diện MCP cũng phục vụ phần còn lại của Performance Hub (điều khiển cửa, quản lý thiết bị, dữ liệu hội viên), các tác vụ tự động dựa trên dữ liệu về con người có thể trải rộng trên nhiều mô-đun: "when an expired member is detected, check whether their door access also worked, and if so flag the access card" chỉ là một tác vụ tự động của AI Agent.

Những gì các công cụ không cung cấp

  • Video — luồng trực tiếp và phát lại được phục vụ cho trình duyệt, không qua MCP; xem Tích hợp và MCP của CCTV.
  • Hình ảnh khuôn mặt và dữ liệu tham chiếu sinh trắc học — các công cụ trả về siêu dữ liệu và dữ liệu hồ sơ, không trả về các bộ sưu tập khuôn mặt.
  • Thao tác ghi đối với người — nhận dạng, gộp, đưa vào danh sách đen và xóa là các quy trình trên giao diện cần con người xác nhận, theo thiết kế.

Mã chia sẻ dành cho khách không có quyền truy cập vào bất kỳ dữ liệu nào về con người — xem Bảo mật và quyền riêng tư.