AI Setup Guide

Use this guide after the first project has at least one Space, one integration, and a few logical devices. AI works best when Haptique OS already has a clean model of the home.

Setup order

Create clear Spaces for the rooms or zones users control every day.
Add logical devices with names people naturally say out loud.
Assign each logical device to the right Space.
Create the main scenes and favorites before testing AI.
Enable AI for the Spaces and devices that should be controlled by chat.
Pair the mobile app so users can try AI chat from the same project.
Test a few small commands before allowing broad room or whole-home actions.

Naming for AI

Use names that match how people describe the home.

Use Main Lights instead of a channel or endpoint name.
Use Theater Projector instead of a model number.
Use Kitchen Music instead of an output identifier.
Use West Shades instead of a motor name.

Avoid duplicate names in the same Space. If two devices sound similar, add the room or purpose to the name.

Permissions and confirmations

Start with narrow permissions. Let AI control one Space first, then expand once the behavior is predictable.

Actions that affect many devices, change scenes, or create automations should ask for confirmation before they run. This keeps AI useful without making it careless.

First tests

Try commands that prove the model is understandable.

“Turn off the living room.”
“Set the kitchen lights to evening mode.”
“Start Movie Night in the theater.”
“What devices are in this room?”
“Create a reading scene for the bedroom.”

If a command targets the wrong device, fix the Space, logical device name, or scene name before adding more rooms.

Mobile AI chat

After the setup works on the controller, test the same project from mobile. Mobile chat is useful for quick room-level changes when users are away from the main screen.

Continue with AI Chat on Mobile.