Logo Performance HubPerformance Hub
Bahagian laman: Dokumentasi

Integrasi & MCP

Pada halaman ini

CCTV / VSaaS mendedahkan datanya secara berprogram melalui MCP (Model Context Protocol) — antara muka integrasi yang sama yang digunakan di seluruh Performance Hub. Cara pilihan untuk membina di atas platform ialah melalui perkakas Ejen AI, yang menggunakan MCP secara asli, menyimpan konteks kemudahan dan boleh bertindak balas terhadap peristiwa dalam masa nyata.

Dua cara masuk

LaluanApakah iaBila
Perkakas Ejen AI (pilihan)Ejen AI kemudahan anda menyambung ke Performance Hub melalui MCP secara terus. Ajukan soalan kepadanya ("siapakah yang berada di kemudahan pada pukul 6 pagi tadi?"), bina automasi yang bertindak balas terhadap peristiwa, dan biarkan ia mengaitkan data CCTV dengan semua perkara lain yang diketahuinyaHampir segala-galanya — tanpa kod, masa nyata dan berbentuk perbualan
MCP terusSebarang klien atau ejen yang menyokong MCP yang menyambung dengan kunci MCP Performance HubPerisian tersuai, platform ejen luaran, integrasi berskrip

Laluan Ejen AI diutamakan kerana peristiwa mengalir kepadanya sebaik sahaja ia berlaku — pengesanan orang, peranti menjadi luar talian — jadi integrasi yang dibina di sana adalah reaktif, bukan ditinjau secara berkala. Butiran tentang menyambungkan Ejen AI terdapat dalam Menyambung ke Performance Hub.

Pengesahan dan skop

Akses MCP terus disahkan dengan kunci MCP peribadi (token phk_…) yang dijana daripada profil Performance Hub anda. Setiap panggilan alat diskopkan mengikut peraturan yang sama seperti UI:

  • Anda hanya boleh membuat pertanyaan tentang kemudahan yang boleh diakses oleh akaun anda.
  • Alat dihadkan mengikut modul: alat penglihatan dan alat orang memerlukan kemudahan mendayakan CCTV dan ciri orang; alat peranti memerlukan Pengurusan Peranti.
  • Panggilan tertakluk kepada kedudukan audit yang sama seperti bahagian lain platform.

Layan kunci MCP seperti kata laluan — skopkannya kepada akaun perkhidmatan jika boleh dan putarkannya apabila kakitangan bertukar.

Antara muka alat

Katalog penuh alat MCP yang sentiasa terkini — nama, parameter dan perkara yang dikembalikan oleh setiap alat — terdapat dalam dokumentasi MCP di bawah Gunakan dengan AI, jadi terdapat satu sumber rujukan tunggal. Bagi modul ini, kategori yang berkaitan ialah:

  • Alat CCTV — kamera dan Edge Processor, serta carian rakaman mengikut makna, carian yang sama yang dijalankan oleh halaman CCTV.
  • Alat AI Insights & People — antara muka data orang: mencari garis masa pengesanan, mencari orang dan aktiviti lawatan mereka, sejarah daftar masuk dan petikan laporan kemudahan.
  • Alat Pengurusan Peranti — menyenaraikan Edge Processor dan kamera dengan statusnya, dan menghantar arahan jauh kepada peranti.

Antara muka MCP yang sama merangkumi bahagian lain Performance Hub — kawalan pintu dan pagar, carian profil pengguna dan kemudahan, dan banyak lagi — jadi sesuatu integrasi boleh merentasi modul: "apabila orang yang tidak dikenali dikesan selepas waktu operasi, semak log pintu dan maklumkan pengurus" ialah satu automasi Ejen AI, bukan tiga sistem.

Corak yang berfungsi dengan baik

  • Pemantauan selepas waktu operasi — automasi Ejen AI pada peristiwa pengesanan di luar waktu buka, memaklumkan kakitangan dengan kamera dan cap masa.
  • Ringkasan harian — automasi berjadual yang meringkaskan hari semalam: lawatan, waktu paling sibuk, kesihatan kamera, tunggakan muat naik.
  • Pemantauan armada berskala besar — pengendali berbilang kemudahan meninjau alat penyenaraian peranti merentasi kemudahan daripada alat NOC mereka, atau membiarkan Ejen AI memantau dan meningkatkan isu.
  • Pembantu siasatan — "tunjukkan semua orang yang masuk antara pukul 5 dan 6 petang" dijawab secara perbualan melalui alat carian garis masa pengesanan, dan bukannya menelusuri rakaman secara manual.

Perkara yang tidak dapat dilakukan oleh integrasi

Antara muka MCP ialah akses satah data dan kawalan. Video itu sendiri — strim langsung dan main balik rakaman — disajikan kepada pelayar melalui modul dan pautan kongsi tetamu, bukan melalui MCP. Untuk menyerahkan rakaman kepada pihak luar, jana pautan kongsi.