Tài liệu kỹ thuật
Dành cho CTO, kỹ sư tích hợp và đội vận hành: kiến trúc, cách kết nối MCP Server, API đặt lịch, sự kiện VMS và trạng thái dịch vụ.
1. Kiến trúc hệ thống
Nền tảng gồm ba khối chạy độc lập, giao tiếp qua API và hàng đợi sự kiện:
| Khối | Thành phần | Triển khai |
|---|---|---|
| AI Vision & VMS | Bộ thu luồng RTSP/ONVIF, dịch vụ suy luận AI, lưu trữ video/sự kiện, bản đồ giám sát | Edge tại cơ sở + trung tâm (Cloud VN / On-Premise) |
| Đặt lịch & Điều phối | Core (bộ đếm slot, sổ sự kiện ký số, đối soát), Edge node tại đối tác, dịch vụ thông báo | Core tại Việt Nam; Edge trên hạ tầng đối tác |
| MCP & AI Agent | MCP Server theo lĩnh vực, cổng xác thực OAuth/API key, Audit Log, hàng đợi phê duyệt | SaaS hoặc Private Cloud của khách hàng |
2. Kết nối MCP Server
MCP Server của TORITECH dùng giao thức Model Context Protocol qua HTTP (Streamable HTTP). Các trợ lý hỗ trợ MCP như Claude, ChatGPT, Gemini, Copilot có thể thêm connector bằng URL do TORITECH cấp.
- Nhận URL MCP và API key (hoặc thực hiện đăng nhập OAuth) sau khi kích hoạt dịch vụ.
- Trong trợ lý AI, mở phần cài đặt connector / tích hợp, thêm connector tuỳ chỉnh với URL được cấp.
- Khai báo key theo hướng dẫn kèm theo; không chia sẻ key qua kênh công khai.
- Thử một lệnh chỉ đọc, ví dụ: “Liệt kê các công cụ có sẵn”.
Ví dụ cấu hình (giá trị giả lập)
{
"mcpServers": {
"toritech-dvc": {
"url": "https://mcp.example.vn/dvc",
"headers": { "Authorization": "Bearer ••••••••••••" }
}
}
}
3. API đặt lịch (tóm tắt)
| Luồng | Mô tả |
|---|---|
| Lấy giờ trống | Đọc snapshot khung giờ theo cơ sở/ngày (cache 30–60 giây) |
| Giữ chỗ | Một lệnh giữ chỗ nhẹ trên bộ đếm slot chung; trả về mã đặt lịch |
| Xác nhận / Huỷ / Đổi giờ | Ghi sự kiện vào outbox, đẩy về Core theo lô |
| Đối soát | Cuối ngày gửi tổng số lượng, tổng tiền, hash cuối chuỗi |
Tài liệu OpenAPI đầy đủ và môi trường sandbox được cấp cho đối tác sau khi ký thỏa thuận tích hợp.
4. Sự kiện VMS
Sự kiện AI (phương tiện, vi phạm vùng, camera mất tín hiệu…) được đẩy qua Webhook/REST với mã sự kiện, thời gian, camera, ảnh trích đã làm mờ theo cấu hình. Ảnh chụp màn hình và log minh hoạ trong tài liệu luôn dùng dữ liệu giả lập.
5. Trạng thái dịch vụ
Khách hàng doanh nghiệp được cấp trang trạng thái và báo cáo SLA định kỳ theo hợp đồng. Thông báo sự cố và bảo trì có kế hoạch được gửi qua email/Zalo đã đăng ký. Trang trạng thái công khai đang được chuẩn bị.
6. Câu hỏi thường gặp
AI Agent có thể tự ý sửa, xoá dữ liệu ERP/kế toán không?
Mặc định MCP Server chỉ cấp quyền đọc. Các lệnh ghi, sửa, xoá hoặc gửi ra ngoài phải được khai báo trong phạm vi quyền và đi qua bước phê duyệt của người có thẩm quyền (Human-in-the-loop). Mọi lệnh đều có Audit Log.
Có tận dụng được camera và đầu ghi đang có không?
Có. Nền tảng VMS kết nối camera IP và đầu ghi NVR sẵn có qua chuẩn ONVIF/RTSP, không yêu cầu thay thiết bị nếu thiết bị đáp ứng yêu cầu tối thiểu về luồng video.
Thời gian triển khai thường mất bao lâu?
Một đợt thí điểm điển hình kéo dài khoảng 3 tháng: khảo sát 1–2 tuần, kết nối và cấu hình 3–5 tuần, vận hành thử và đo kết quả trong thời gian còn lại. Tiến độ cụ thể phụ thuộc hiện trạng hạ tầng.