Logo Performance HubPerformance Hub
Bagian situs: Dokumentasi

Integrasi & MCP

Di halaman ini

Semua yang ditampilkan AI Insights & People di UI-nya — linimasa, profil, check-in, dan snapshot laporan — tersedia secara terprogram melalui MCP (Model Context Protocol) melalui tujuh alat insights_*. Cara yang disarankan untuk menggunakannya adalah perangkat Agen AI fasilitas Anda, yang mendukung MCP secara native dan dapat menjawab pertanyaan secara percakapan sekaligus menjalankan otomatisasi terhadap data tersebut.

Mekanisme MCP umum — dua cara masuk, kunci phk_…, cakupan — dibahas di Integrasi & MCP CCTV. Halaman ini membahas lebih dalam tentang alat insights itu sendiri.

Persyaratan akses

Setiap alat insights_* menerapkan dua lapisan, sama seperti UI:

  1. Akses Modul — akun yang melakukan panggilan memerlukan modul CCTV melalui perannya.
  2. Pengaktifan fitur — fasilitas target harus mengaktifkan fitur People; jika tidak, alat mengembalikan galat "People feature is not enabled for this facility" yang sama seperti API.

Cakupan fasilitas berlaku seperti di tempat lain: Anda hanya dapat mengkueri fasilitas yang dapat diakses oleh akun Anda.

Tujuh alat

Linimasa People versi terprogram — "the primary 'who was in the facility' view". Mencari blok kunjungan deteksi berdasarkan rentang tanggal, orang, nama, jenis kecocokan (teridentifikasi / unsure), status keanggotaan, dan grup kamera. Inilah alat utamanya: pertanyaan kehadiran, pemeriksaan di luar jam operasional, dan investigasi insiden semuanya dimulai di sini.

Mencari orang yang terdaftar — daftar People versi terprogram — berdasarkan nama, status keanggotaan (aktif, kedaluwarsa, ditangguhkan), dan atribut, dengan jumlah faset. Gunakan untuk mengubah pertanyaan "siapa Alex?" menjadi ID orang sebelum menelusuri aktivitasnya.

insights_person_get

Profil lengkap satu orang, diperkaya dengan data keanggotaannya — panel profil versi terprogram.

insights_person_activity

Riwayat deteksi seseorang selama rentang tanggal — log kunjungannya, per kunjungan dan per kamera. Secara alami dipasangkan dengan insights_person_get: profil untuk konteks, aktivitas untuk riwayat.

insights_checkins

Riwayat check-in fasilitas dari integrasi manajemen anggota — catatan gesek kartu yang mendukung pencocokan berbantuan kunjungan dan Self Learning. Berguna dengan sendirinya ("berapa banyak check-in kemarin?") dan sebagai kebenaran dasar untuk membandingkan data kamera.

insights_match_unidentified

Mengorelasikan deteksi yang tidak teridentifikasi dengan catatan check-in berdasarkan stempel waktu untuk menyarankan kecocokan identitas — versi ringan sesuai permintaan dari korelasi Self Learning, dan alat ini juga menampilkan grup profil yang diduga duplikat. Cocok untuk pertanyaan "siapa kira-kira pengunjung unsure ini?" dari sebuah agen.

insights_report_snapshots

Snapshot laporan harian: KPI dan jumlah per kamera (deteksi, jejak, orang unik, pembagian teridentifikasi/unsure, cakupan check-in, demografi) untuk rentang tanggal. Alat yang tepat untuk dasbor dan ringkasan — alat ini membaca agregat yang sudah dihitung sebelumnya, bukan deteksi mentah.

Pola yang berfungsi dengan baik

  • Tanya jawab kehadiran — "Who was in the facility at 6 this morning?", "When was Alex Nguyen last in?" — insights_timeline_search / insights_person_activity, dijawab secara percakapan oleh Agen AI.
  • Tindak lanjut tailgating — otomatisasi terjadwal yang mencocokkan silang insights_timeline_search dengan insights_checkins: siapa pun yang terdeteksi berulang kali tanpa gesek kartu yang sesuai akan dimasukkan ke ringkasan harian untuk manajer.
  • Penjangkauan anggota kedaluwarsa — anggota kedaluwarsa yang masih berkunjung (pencarian linimasa berdasarkan status keanggotaan) dimasukkan ke daftar tindak lanjut; percakapannya tetap dilakukan oleh manusia, deteksinya yang diotomatisasi.
  • Ringkasan operasional mingguan — insights_report_snapshots dirangkum ke obrolan tim: kunjungan, jam sibuk, unsure %, pelanggaran akses.
  • Kebersihan identifikasi — insights_match_unidentified dijalankan setiap minggu untuk mengusulkan kemungkinan identitas dan penggabungan duplikat, sehingga antrean Self Learning tetap pendek.
  • Smart Display di layar Anda — ide opsional untuk perangkat Agen AI dengan MCP access aktif (default) dan kemampuan CCTV dalam cakupannya: otomatisasi yang berjalan setiap beberapa menit selama jam kedatangan memeriksa insights_checkins, yaitu check-in yang disinkronkan dari integrasi sistem manajemen anggota Anda, untuk orang yang baru saja tiba dan memperbarui aplikasi yang diterbitkan agen ke Display Screens Anda, misalnya papan peringkat gym atau sambutan ulang tahun di lobi. Check-in sampai ke agen pada pemeriksaan terjadwal berikutnya, sehingga layar diperbarui dalam beberapa menit. Sambutan ulang tahun menggunakan tanggal lahir, yang merupakan informasi pribadi: sertakan hanya orang yang telah menyetujuinya, patuhi kewajiban privasi organisasi Anda, dan tampilkan tidak lebih dari nama depan.

Karena antarmuka MCP yang sama juga mencakup bagian lain Performance Hub (kontrol pintu, manajemen perangkat, data anggota), otomatisasi data orang dapat mencakup beberapa modul: "when an expired member is detected, check whether their door access also worked, and if so flag the access card" adalah satu otomatisasi Agen AI.

Yang tidak diekspos oleh alat

  • Video — streaming langsung dan pemutaran disajikan ke browser, bukan melalui MCP; lihat Integrasi & MCP CCTV.
  • Citra wajah dan referensi biometrik — alat mengembalikan metadata dan data profil, bukan koleksi wajah.
  • Operasi tulis pada orang — identifikasi, penggabungan, daftar hitam, dan penghapusan adalah alur kerja UI dengan konfirmasi manusia, sesuai rancangan.

Token berbagi tamu tidak memiliki akses ke data orang apa pun — lihat Keamanan & privasi.