HomeAssistant Integration

🏡 HomeAssistant Integration là gì?

💡

Định nghĩa

HomeAssistant là nền tảng smart home mã nguồn mở phổ biến nhất. VietBot tích hợp HomeAssistant thông qua Long-Lived Access Token, cho phép AI Assistant điều khiển mọi thiết bị trong ngôi nhà của bạn — hoàn toàn bằng giọng nói.

Voice Control

Điều khiển bằng giọng nói

"Bật đèn phòng khách", "Tắt điều hòa", "Khóa cửa chính" — bot thực hiện ngay lập tức.

Auto Discovery

Tự động nhận diện thiết bị

Bot tự động liệt kê tất cả thiết bị từ HomeAssistant API. Không cần cấu hình thủ công từng thiết bị.

State Query

Kiểm tra trạng thái

"Đèn phòng ngủ còn bật không?", "Nhiệt độ nhà bao nhiêu?", "Camera cổng có nhìn thấy gì?".

Scene Activation

Kích hoạt Scene

Tạo scene trong HomeAssistant ("Đi ngủ", "Ra ngoài", "Xem phim") → bot kích hoạt bằng 1 câu nói.

Natural Language

Ngôn ngữ tự nhiên

Không cần lệnh cố định. Bot hiểu ý đồ từ câu nói tự nhiên: "Lạnh quá, bật sưởi lên được không?".

Security

Bảo mật

Sử dụng Long-Lived Access Token. Token được lưu trong config, không chia sẻ qua mạng.

📱 Thiết bị được hỗ trợ

💡

Đèn thông minh

🌡️

Điều hòa / Sưởi

🔌

Ổ cắm thông minh

🚪

Khóa cửa

📹

Camera / Doorbell

🎵

Loa / Media Player

🌬️

Quạt thông minh

🚿

Bình nước nóng

🪟

Rèm / Cửa cuốn

🌦️

Cảm biến thời tiết

🔔

Chuông cửa

📳

Cảm biến chuyển động

🔑 Cấu hình HomeAssistant

1

Cài đặt HomeAssistant

Cài HomeAssistant trên Raspberry Pi, NAS, hoặc máy chủ. Hướng dẫn: home-assistant.io/installation

2

Tạo Long-Lived Access Token

Vào HomeAssistant → Profile (biểu tượng người dùng) → Long-Lived Access Tokens → Tạo token mới → Copy token.

3

Cấu hình trong Web Manager

Đăng nhập web.vietbot.vn → Chọn Agent → Vào tab Plugin Information → Nhập HomeAssistant URL và Token → Bấm Lưu.

4

Bật HomeAssistant Tool

Vào Chỉnh sửa chức năng → Enable Tools → Bật home_assistant.

# Ví dụ cấu hình trong Plugin Information
HomeAssistant URL:  https://homeassistant.local:8123
HomeAssistant Token: eyJ0eXAiOiJKV1Q...
# Lưu ý: URL phải accessible từ VietBot server

🎙️ Ví dụ câu lệnh thoại

ON/OFF

Bật/Tắt thiết bị

"Bật đèn phòng khách", "Tắt điều hòa phòng ngủ", "Bật quạt phòng làm việc"

Dimmer

Điều chỉnh độ sáng

"Làm đèn sáng hơn", "Giảm độ sáng xuống 50%", "Đèn tối nhất có thể"

Temperature

Cài nhiệt độ

"Cài điều hòa 25 độ", "Bật sưởi 28 độ", "Tăng nhiệt thêm 2 độ"

Query

Hỏi trạng thái

"Cửa chính khóa chưa?", "Nhiệt độ ngoài trời bao nhiêu?", "Đèn nào còn bật?"

Scene

Kích hoạt scene

"Tôi đi ngủ đây", "Kích hoạt chế độ ra ngoài", "Chuẩn bị xem phim"

Lock

Khóa cửa

"Khóa cửa chính", "Mở cửa garage", "Cửa sau có khóa không?"

📡 Luồng xử lý

# Luồng HomeAssistant Integration
User: "Bật đèn phòng khách giúp tôi"
  │
  ▼
# 1. LLM nhận câu nói → trigger home_assistant tool
Tool: home_assistant
Args: { action: "turn_on", device: "đèn phòng khách" }
  │
  ▼
# 2. Gọi HomeAssistant REST API
POST https://homeassistant.local:8123/api/services/light/turn_on
Headers: { Authorization: Bearer  }
Data:   { entity_id: "light.phong_khach" }
  │
  ▼
# 3. HomeAssistant điều khiển thiết bị thực tế
→ Gửi Zigbee/Z-Wave/WiFi command đến đèn
  │
  ▼
# 4. HA trả về kết quả
Response: { success: true, state: "on" }
  │
  ▼
# 5. Bot xác nhận bằng giọng nói
Bot: "Đã bật đèn phòng khách rồi nhé."
# ⏱️ Thời gian: ~1-3 giây từ câu nói đến thiết bị bật

⚠️ Lưu ý quan trọng

🔒

Bảo mật

Token HomeAssistant có quyền điều khiển TẤT CẢ thiết bị. Không chia sẻ token với người khác. Nếu nghi ngờ bị lộ → xóa token cũ và tạo token mới ngay.

🌐

Kết nối mạng

HomeAssistant server phải accessible từ VietBot server. Nếu VietBot chạy trên cloud/server khác network → cần mở port HA hoặc dùng VPN/Ngrok.

✅

Khuyến nghị

Chạy HomeAssistant trong cùng mạng LAN với VietBot server để độ trễ thấp nhất và bảo mật tốt nhất.

← Quay lại trang chủ Mở Web Manager →

Điều khiển HomeAssistant