โลโก้ Performance HubPerformance Hub
ส่วนของเว็บไซต์: เอกสาร

Integrations และ MCP

ในหน้านี้

ทุกสิ่งที่ AI Insights & People แสดงใน UI ได้แก่ ไทม์ไลน์ โปรไฟล์ การเช็คอิน และภาพรวมรายงาน สามารถเข้าถึงได้ผ่านโปรแกรมด้วย MCP (Model Context Protocol) ผ่านเครื่องมือ insights_* เจ็ดรายการ วิธีที่แนะนำในการใช้งานเครื่องมือเหล่านี้คืออุปกรณ์ตัวแทน AIของสถานที่ของคุณ ซึ่งรองรับ MCP โดยตรง และสามารถทั้งตอบคำถามในรูปแบบการสนทนาและเรียกใช้การทำงานอัตโนมัติกับข้อมูลได้

กลไกทั่วไปของ MCP ได้แก่ ช่องทางการเข้าถึงสองแบบ คีย์ phk_… และการกำหนดขอบเขต มีอธิบายไว้ใน Integrations และ MCP ของกล้องวงจรปิด หน้านี้จะลงรายละเอียดเชิงลึกเกี่ยวกับเครื่องมือ insights โดยเฉพาะ

ข้อกำหนดการเข้าถึง

เครื่องมือ insights_* ทุกรายการบังคับใช้การตรวจสอบสองชั้นเช่นเดียวกับ UI:

  1. การเข้าถึงโมดูล บัญชีที่เรียกใช้ต้องมีโมดูลกล้องวงจรปิดผ่านบทบาทของบัญชีนั้น
  2. การเปิดใช้งานฟีเจอร์ สถานที่เป้าหมายต้องเปิดใช้งานฟีเจอร์ People มิฉะนั้นเครื่องมือจะส่งกลับข้อผิดพลาด "People feature is not enabled for this facility" เช่นเดียวกับ API

การกำหนดขอบเขตตามสถานที่มีผลเช่นเดียวกับส่วนอื่น ๆ คุณสามารถสืบค้นได้เฉพาะสถานที่ที่บัญชีของคุณเข้าถึงได้เท่านั้น

เครื่องมือทั้งเจ็ด

ไทม์ไลน์ของบุคคลในรูปแบบโปรแกรม "the primary 'who was in the facility' view" ค้นหาบล็อกการเข้าใช้จากการตรวจจับตามช่วงวันที่ บุคคล ชื่อ ประเภทการจับคู่ (identified / unsure) สถานะสมาชิกภาพ และกลุ่มกล้อง นี่คือเครื่องมือหลัก คำถามเกี่ยวกับการเข้าใช้ การตรวจสอบนอกเวลาทำการ และการสืบสวนเหตุการณ์ล้วนเริ่มต้นที่นี่

ค้นหาบุคคลที่ลงทะเบียนไว้ ซึ่งเป็นรายการ Peopleในรูปแบบโปรแกรม ตามชื่อ สถานะสมาชิกภาพ (active, expired, on hold) และคุณลักษณะ พร้อมจำนวนในแต่ละหมวด ใช้เพื่อแปลงคำถาม "Alex คือใคร" เป็นรหัสบุคคลก่อนเจาะลึกไปยังกิจกรรม

insights_person_get

โปรไฟล์ฉบับเต็มของบุคคลหนึ่งคน เสริมด้วยข้อมูลสมาชิกภาพ ซึ่งเป็นแผงโปรไฟล์ในรูปแบบโปรแกรม

insights_person_activity

ประวัติการตรวจจับของบุคคลในช่วงวันที่ที่กำหนด ซึ่งเป็นบันทึกการเข้าใช้แยกตามการเข้าใช้แต่ละครั้งและกล้องแต่ละตัว ใช้คู่กับ insights_person_get ได้อย่างเป็นธรรมชาติ โดยใช้โปรไฟล์เพื่อดูบริบท และใช้กิจกรรมเพื่อดูประวัติ

insights_checkins

ประวัติการเช็คอินของสถานที่จากการผสานรวมระบบจัดการสมาชิก ซึ่งเป็นระเบียนการรูดบัตรที่ขับเคลื่อนการจับคู่โดยอาศัยการเข้าใช้และ Self Learning มีประโยชน์ทั้งเมื่อใช้เพียงลำพัง ("เมื่อวานมีการเช็คอินกี่ครั้ง") และใช้เป็นข้อมูลอ้างอิงที่ถูกต้องเพื่อเปรียบเทียบกับข้อมูลจากกล้อง

insights_match_unidentified

หาความสัมพันธ์ระหว่างการตรวจจับที่ไม่ระบุตัวกับระเบียนการเช็คอินตามเวลาเพื่อเสนอการจับคู่ตัวตน ซึ่งเป็นการหาความสัมพันธ์แบบ Self Learning ในรูปแบบที่เบาและเรียกใช้ได้ตามต้องการ และยังแสดงกลุ่มโปรไฟล์ที่สงสัยว่าซ้ำกันด้วย เหมาะสำหรับคำถามจากตัวแทน เช่น "ผู้มาเยือนที่ไม่แน่ใจคนนี้อาจเป็นใคร"

insights_report_snapshots

ภาพรวมรายงานรายวัน ได้แก่ KPI และจำนวนแยกตามกล้อง (การตรวจจับ แทร็ก บุคคลที่ไม่ซ้ำกัน สัดส่วนระบุตัวได้/ไม่แน่ใจ ความครอบคลุมของการเช็คอิน ข้อมูลประชากร) สำหรับช่วงวันที่ที่กำหนด เป็นเครื่องมือที่เหมาะสำหรับแดชบอร์ดและสรุปข้อมูล เนื่องจากอ่านข้อมูลรวมที่คำนวณไว้ล่วงหน้าแทนการตรวจจับดิบ

รูปแบบที่ใช้ได้ผลดี

  • ถามตอบเรื่องการเข้าใช้ "เมื่อเช้านี้เวลา 6 โมงมีใครอยู่ในสถานที่บ้าง", "Alex Nguyen มาครั้งล่าสุดเมื่อใด" ใช้ insights_timeline_search / insights_person_activity โดยตัวแทน AI ตอบในรูปแบบการสนทนา
  • การติดตามผลการเดินตามเข้า (tailgating) การทำงานอัตโนมัติตามกำหนดเวลาที่อ้างอิงไขว้ระหว่าง insights_timeline_search กับ insights_checkins ผู้ที่ถูกตรวจพบซ้ำ ๆ โดยไม่มีการรูดบัตรที่ตรงกันจะถูกส่งเป็นสรุปรายวันถึงผู้จัดการ
  • การติดต่อสมาชิกที่หมดอายุ สมาชิกที่หมดอายุแต่ยังมาใช้บริการ (ค้นหาในไทม์ไลน์ตามสถานะสมาชิกภาพ) จะถูกส่งเข้ารายการติดตามผล การสนทนายังคงเป็นหน้าที่ของคน ส่วนการตรวจจับทำงานโดยอัตโนมัติ
  • สรุปการปฏิบัติงานรายสัปดาห์ สรุป insights_report_snapshots ลงในแชทของทีม ได้แก่ การเข้าใช้ ชั่วโมงเร่งด่วน unsure % และการละเมิดการเข้าถึง
  • การดูแลความถูกต้องของการระบุตัวตน เรียกใช้ insights_match_unidentified ทุกสัปดาห์เพื่อเสนอตัวตนที่น่าจะเป็นและการรวมโปรไฟล์ที่ซ้ำกัน ช่วยให้คิว Self Learning สั้นอยู่เสมอ
  • Smart Display บนหน้าจอของคุณ แนวคิดที่ต้องเลือกเปิดใช้สำหรับอุปกรณ์ตัวแทน AI ที่เปิด MCP access ไว้ (ค่าเริ่มต้น) และมีความสามารถกล้องวงจรปิดอยู่ในขอบเขต โดยการทำงานอัตโนมัติที่เรียกใช้ทุกไม่กี่นาทีในช่วงเวลาที่ผู้คนมาถึงจะตรวจสอบ insights_checkins ซึ่งเป็นการเช็คอินที่ซิงค์จากการผสานรวมระบบจัดการสมาชิกของคุณ เพื่อหาผู้ที่เพิ่งมาถึง และอัปเดตแอปที่ตัวแทนเผยแพร่ไปยัง Display Screens ของคุณ เช่น กระดานจัดอันดับในยิม หรือการต้อนรับวันเกิดในล็อบบี้ การเช็คอินจะไปถึงตัวแทนในการตรวจสอบตามกำหนดเวลาครั้งถัดไป หน้าจอจึงอัปเดตภายในไม่กี่นาที การต้อนรับวันเกิดใช้วันเดือนปีเกิด ซึ่งเป็นข้อมูลส่วนบุคคล ให้รวมเฉพาะผู้ที่ให้ความยินยอมแล้ว ปฏิบัติตามข้อผูกพันด้านความเป็นส่วนตัวขององค์กรของคุณ และแสดงไม่เกินชื่อจริง

เนื่องจาก MCP ชุดเดียวกันนี้รองรับส่วนอื่น ๆ ของ Performance Hub ด้วย (การควบคุมประตู การจัดการอุปกรณ์ ข้อมูลสมาชิก) การทำงานอัตโนมัติด้านข้อมูลบุคคลจึงครอบคลุมได้หลายโมดูล เช่น "เมื่อตรวจพบสมาชิกที่หมดอายุ ให้ตรวจสอบว่าสิทธิ์การเข้าประตูของสมาชิกนั้นยังใช้งานได้หรือไม่ และหากใช้ได้ ให้ตั้งค่าสถานะบัตรเข้าใช้นั้น" ก็เป็นการทำงานอัตโนมัติของตัวแทน AI หนึ่งรายการ

สิ่งที่เครื่องมือไม่เปิดเผย

  • วิดีโอ สตรีมสดและการเล่นซ้ำให้บริการแก่เบราว์เซอร์ ไม่ใช่ผ่าน MCP ดู Integrations และ MCP ของกล้องวงจรปิด
  • ภาพใบหน้าและข้อมูลอ้างอิงชีวมิติ เครื่องมือจะส่งกลับเมทาดาทาและข้อมูลโปรไฟล์ ไม่ใช่ชุดข้อมูลใบหน้า
  • การดำเนินการเขียนข้อมูลบุคคล การระบุตัว การรวม การเพิ่มลงในบัญชีดำ และการลบ เป็นขั้นตอนใน UI ที่ต้องมีการยืนยันโดยบุคคล ซึ่งเป็นไปตามการออกแบบ

โทเค็นการแชร์สำหรับผู้เยี่ยมชมไม่มีสิทธิ์เข้าถึงข้อมูลบุคคลใด ๆ ดูความปลอดภัยและความเป็นส่วนตัว