Đăng Ký Thiết Bị
Thêm thiết bị phần cứng và liên kết với trợ lý thông qua Admin Panel.
Tổng Quan
Hướng dẫn này áp dụng cho board ESP32. Đăng ký thiết bị là bước thêm board phần cứng vào hệ thống để trợ lý có thể nhận diện và sử dụng thiết bị đó. Sau khi đăng ký, nền tảng biết thiết bị thuộc trợ lý nào, thuộc người dùng nào, đang dùng board và firmware nào, và có thể nhận cấu hình, phiên giọng nói, giao diện tùy chỉnh hoặc lệnh điều khiển.
Với thiết bị ESP32, cách đăng ký là dùng mã kích hoạt 6 số. Mã này xuất hiện trên màn hình thiết bị khi đã online nhưng chưa được liên kết với trợ lý.
Watch dùng flow pairing riêng với mã chữ-số. Không nhập mã Watch vào flow ESP32 gồm 6 số này.
Trước Khi Bắt Đầu
- Bạn đã có tài khoản trên Admin Panel và đã tạo ít nhất một trợ lý.
- Trợ lý đã có ít nhất một người dùng được đăng ký (trong mục Người Dùng của Admin Panel).
- Thiết bị đã được nạp firmware tương thích.
- Thiết bị đã kết nối Wi-Fi và có thể lấy cấu hình từ nền tảng.
Nếu chưa có tài khoản admin hoặc chưa tạo trợ lý, bạn cần thực hiện trước khi đăng ký thiết bị.
Đăng Ký Bằng Mã Kích Hoạt
Bước 1: Lấy Mã Kích Hoạt Trên Thiết Bị
- Bật nguồn board ESP32
- Chờ thiết bị kết nối Wi-Fi
- Màn hình thiết bị sẽ hiển thị mã 6 số
Bước 2: Tìm Thiết Bị Trong Admin Panel
- Đăng nhập vào Admin Panel
- Chọn trợ lý cần liên kết từ dropdown ở sidebar
- Vào mục Thiết Bị trong sidebar
- Trong phần Thêm thiết bị, tại bước 1. Tìm thiết bị, nhập mã 6 số
- Nhấn Tra cứu — hệ thống sẽ xác minh và hiển thị thông tin thiết bị, gồm mã, trạng thái, MAC và loại thiết bị
Bước 3: Gán Thiết Bị
- Tại bước 2. Gán thiết bị, chọn người dùng sẽ sở hữu thiết bị đã xác minh
- Nhấn Gán thiết bị
- Xác nhận trạng thái Đã kết nối; thiết bị sẽ xuất hiện trong danh sách bên dưới
Sau khi liên kết, thiết bị sẽ nhận cấu hình trợ lý trong lần kiểm tra OTA tiếp theo và có thể bắt đầu phiên giọng nói.
URL trực tiếp đến trang thiết bị: https://admin.assistantcore.com/assistants/<assistant_id>/devices
Nếu Không Tìm Thấy Mã
- Kiểm tra thiết bị đã bật nguồn và kết nối Wi-Fi.
- Nhập đúng 6 số đang hiển thị trên thiết bị, bao gồm cả số
0ở đầu nếu có. - Nếu mã không còn hợp lệ, khởi động lại thiết bị hoặc chờ thiết bị hiển thị mã mới rồi tra cứu lại.
Quản Lý Thiết Bị
Sau khi đăng ký, bạn có thể quản lý thiết bị trực tiếp trong bảng danh sách:
| Trường | Mô tả |
|---|---|
| Tên gọi | Tên thân thiện, có thể sửa trực tiếp trong bảng |
| Loại | ESP32 hoặc Watch, kèm trạng thái online/offline |
| Người dùng | Người sở hữu thiết bị, có thể đổi từ dropdown |
| MAC | Định danh phần cứng duy nhất |
| Phiên bản | Phiên bản firmware hiện tại |
| Lần online cuối | Thời điểm thiết bị gần nhất kết nối với nền tảng |
| Cập nhật tự động | Bật/tắt cập nhật firmware qua OTA |
| Giao diện | Tùy chỉnh theme cho thiết bị ESP32 đang online |
Đổi Người Sở Hữu
Trong bảng danh sách thiết bị, click vào dropdown Người dùng ở cột tương ứng và chọn người dùng mới.
Xóa Thiết Bị
Nhấn nút Xóa ở cuối hàng thiết bị. Thao tác này sẽ hủy liên kết thiết bị khỏi trợ lý.
Giới Hạn Thiết Bị
Giới hạn thiết bị phụ thuộc vào gói của chủ sở hữu và cấu hình hiện tại của nền tảng. Xem Gói & Giá để biết giới hạn mới nhất.
Bạn có thể gán nhiều thiết bị cho cùng một trợ lý. Việc sử dụng voice vẫn tiêu thụ credits theo model đang dùng và thời lượng phiên.
Một thiết bị chỉ nên được liên kết với một trợ lý tại một thời điểm để phiên giọng nói, bộ nhớ và công cụ thiết bị không bị trộn ngữ cảnh.