Logo Performance HubPerformance Hub
Bahagian laman: Dokumentasi

Integrasi & MCP

Pada halaman ini

Segala yang ditunjukkan oleh AI Insights & People dalam UInya — garis masa, profil, daftar masuk dan petikan laporan — tersedia secara pengaturcaraan melalui MCP (Model Context Protocol) menerusi tujuh alat insights_*. Cara pilihan untuk menggunakannya ialah perkakas Ejen AI kemudahan anda, yang menyokong MCP secara asli dan boleh menjawab soalan secara perbualan serta menjalankan automasi terhadap data tersebut.

Mekanik MCP umum — dua cara masuk, kunci phk_…, penskopan — diterangkan dalam Integrasi & MCP CCTV. Halaman ini menerangkan alat insights itu sendiri dengan lebih mendalam.

Keperluan akses

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

  1. Akses modul — akaun yang memanggil memerlukan modul CCTV melalui peranannya.
  2. Pendayaan ciri — kemudahan sasaran mesti mempunyai ciri People didayakan; jika tidak, alat mengembalikan ralat "People feature is not enabled for this facility" yang sama seperti API.

Penskopan kemudahan terpakai seperti di tempat lain: anda hanya boleh membuat pertanyaan bagi kemudahan yang boleh diakses oleh akaun anda.

Tujuh alat

Garis masa People secara pengaturcaraan — "the primary 'who was in the facility' view". Mencari blok lawatan pengesanan mengikut julat tarikh, orang, nama, jenis padanan (dikenal pasti / unsure), status keahlian dan kumpulan kamera. Inilah alat utama: soalan kehadiran, semakan selepas waktu operasi dan siasatan insiden semuanya bermula di sini.

Mencari orang yang berdaftar — senarai People secara pengaturcaraan — mengikut nama, status keahlian (aktif, tamat tempoh, ditangguhkan) dan atribut, dengan kiraan faset. Gunakannya untuk menukar "siapa Alex?" kepada ID orang sebelum meneliti aktiviti.

insights_person_get

Profil penuh seseorang, diperkaya dengan data keahliannya — panel profil secara pengaturcaraan.

insights_person_activity

Sejarah pengesanan seseorang dalam julat tarikh — log lawatannya, bagi setiap lawatan dan setiap kamera. Sesuai digandingkan dengan insights_person_get: profil untuk konteks, aktiviti untuk sejarah.

insights_checkins

Sejarah daftar masuk kemudahan daripada integrasi pengurusan ahli — rekod leretan yang menggerakkan pemadanan berbantukan lawatan dan Self Learning. Berguna dengan sendirinya ("berapa banyak daftar masuk semalam?") dan sebagai kebenaran asas untuk dibandingkan dengan data kamera.

insights_match_unidentified

Mengorelasikan pengesanan yang tidak dikenal pasti dengan rekod daftar masuk mengikut cap masa untuk mencadangkan padanan identiti — versi ringan atas permintaan bagi korelasi Self Learning, dan ia juga memaparkan kumpulan profil yang disyaki pendua. Sesuai untuk soalan "siapa mungkin pelawat unsure ini?" daripada ejen.

insights_report_snapshots

Petikan laporan harian: KPI dan kiraan bagi setiap kamera (pengesanan, jejak, orang unik, pecahan dikenal pasti/unsure, liputan daftar masuk, demografi) untuk julat tarikh. Alat yang sesuai untuk papan pemuka dan ringkasan — ia membaca agregat yang telah dikira terlebih dahulu dan bukannya pengesanan mentah.

Corak yang berkesan

  • Soal 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 perbualan oleh Ejen AI.
  • Susulan tailgating — automasi berjadual yang merujuk silang insights_timeline_search dengan insights_checkins: sesiapa yang dikesan berulang kali tanpa leretan yang sepadan dihantar dalam ringkasan harian kepada pengurus.
  • Hubungan dengan ahli tamat tempoh — ahli tamat tempoh yang masih melawat (carian garis masa mengikut status keahlian) dimasukkan ke dalam senarai susulan; perbualan tetap dikendalikan manusia, pengesanan diautomasikan.
  • Ringkasan operasi mingguan — insights_report_snapshots diringkaskan ke dalam sembang pasukan: lawatan, waktu puncak, unsure %, pelanggaran akses.
  • Kebersihan pengenalpastian — insights_match_unidentified dijalankan setiap minggu untuk mencadangkan identiti yang mungkin dan penggabungan pendua, memastikan baris gilir Self Learning kekal pendek.
  • Smart Display pada skrin anda — idea pilihan ikut serta untuk peranti Ejen AI dengan MCP access dihidupkan (lalai) dan keupayaan CCTV dalam skopnya: automasi yang berjalan setiap beberapa minit semasa waktu ketibaan menyemak insights_checkins, iaitu daftar masuk yang disegerakkan daripada integrasi sistem pengurusan ahli anda, untuk orang yang baru tiba dan mengemas kini aplikasi yang diterbitkan oleh ejen ke Display Screens anda, contohnya papan pendahulu gim atau ucapan selamat hari jadi di lobi. Daftar masuk sampai kepada ejen pada semakan berjadual seterusnya, jadi skrin dikemas kini dalam masa beberapa minit. Ucapan hari jadi menggunakan tarikh lahir, iaitu maklumat peribadi: masukkan hanya orang yang telah bersetuju, patuhi kewajipan privasi organisasi anda, dan paparkan tidak lebih daripada nama pertama.

Oleh sebab permukaan MCP yang sama turut membawa bahagian lain Performance Hub (kawalan pintu, pengurusan peranti, data ahli), automasi data orang boleh merentas modul: "apabila ahli tamat tempoh dikesan, semak sama ada akses pintunya juga berjaya, dan jika ya tandakan kad akses tersebut" ialah satu automasi Ejen AI.

Perkara yang tidak didedahkan oleh alat

  • Video — strim langsung dan main balik disampaikan kepada pelayar, bukan melalui MCP; lihat Integrasi & MCP CCTV.
  • Imej wajah dan rujukan biometrik — alat mengembalikan metadata dan data profil, bukan koleksi wajah.
  • Operasi tulis pada orang — kenal pasti, gabung, senarai hitam dan padam ialah aliran kerja UI dengan pengesahan manusia, mengikut reka bentuk.

Token kongsi tetamu tidak mempunyai akses kepada sebarang data orang — lihat Keselamatan & privasi.