El asistente de SharKNX te permite trabajar con tu instalación KNX escribiendo lo que quieres hacer: "is 1.1.5 alive?", "which devices are in room 101?", "set the kitchen temperature to 21". Responde preguntas sobre tu proyecto ETS y ejecuta tareas relacionadas con pasarelas, dispositivos, direcciones de grupo y el monitor - siempre después de mostrarte lo que va a hacer.
Esta página explica cómo funciona el asistente y por qué se comporta así. Para empezar a usarlo, consulta Cómo usar el asistente.
Un asistente KNX, no un chatbot
El asistente tiene una sola función: entender solicitudes sobre una instalación KNX. Conoce un conjunto fijo de tareas - gateways, dispositivos, direcciones de grupo, monitorización, preguntas sobre el proyecto y secuencias de comandos - y no conversa sobre otros temas ni improvisa cuando no reconoce una solicitud.
No hay ningún modelo de lenguaje de IA ni servicio en la nube detrás del asistente. Un motor determinista de tu teléfono u ordenador interpreta la solicitud comparándola con las tareas que conoce y con los nombres del proyecto ETS cargado. Esto significa que:
- Funciona sin conexión - no necesita Internet, solo tu gateway KNX para las tareas del bus.
- Tu proyecto permanece en tu dispositivo - los datos del proyecto y las instrucciones nunca se envían a ningún sitio.
- Es predecible - la misma solicitud en el mismo proyecto siempre produce el mismo resultado. En un edificio habitado, eso importa más que la elocuencia.
Por ahora, el asistente solo entiende instrucciones en inglés. Sus respuestas se muestran en el idioma de la aplicación.
Cómo se procesa una solicitud
- Escribes una solicitud - en inglés corriente o como un comando exacto
sharknx. - El asistente averigua qué quieres decir - la tarea y los dispositivos, direcciones de grupo, habitaciones o valores que has indicado. Busca los nombres en tu proyecto ETS, así que "kitchen light" se convierte en la dirección de grupo correspondiente.
- Si algo no está claro, pregunta. Si un nombre coincide con varios elementos, o falta un valor o un destino, te ofrece opciones en lugar de adivinar.
- Propone la acción y tú la confirmas. Toda acción que escriba en el bus o cambie un dispositivo aparece primero en una tarjeta con sus destinos y valores. No ocurre nada hasta que la confirmas.
- SharKNX la ejecuta - con el mismo código que el resto de la aplicación, tras comprobar de nuevo que los destinos siguen en el proyecto cargado y que el gateway está conectado.
El asistente responde las preguntas sobre tu proyecto directamente a partir del proyecto ETS cargado: cuenta, enumera y sigue con precisión las relaciones entre dispositivos, direcciones de grupo, espacios y funciones, sin hacer estimaciones.
Niveles de confirmación
La aplicación asigna un nivel de confirmación fijo a cada tarea, independientemente de cómo formules la solicitud:
| Nivel | Tareas | Qué aparece |
|---|---|---|
| Ninguna | Preguntas sobre el proyecto, leer una dirección de grupo, comprobar un dispositivo, escaneos, conectar, monitor | La tarea se ejecuta de inmediato |
| Confirmación | Escribir en una dirección de grupo, reiniciar un dispositivo, cambiar el modo de programación | Confirmar o Cancelar en la tarjeta |
| Confirmación explícita | Escribir en varias direcciones de grupo a la vez, secuencias de escritura, programar una dirección física | Se requiere confirmación explícita - la tarjeta enumera cada paso protegido antes de ejecutarlo |
Una solicitud solo puede afectar a un número limitado de destinos - consulta Límites. Si el proyecto cambia después de preparar una tarjeta, ya no se podrá ejecutar. Vuelve a preguntar para usar el proyecto actual.
Tres formas de preguntar
| Forma | Ejemplo | Ideal para |
|---|---|---|
| Inglés corriente | turn off the corridor lights |
El uso diario: nombres del proyecto y aclaraciones cuando hagan falta |
| Comandos exactos | sharknx write 1/2/3 on |
Cuando sabes exactamente qué quieres. No se interpreta ni se adivina nada - consulta Comandos del asistente. |
| Tus propias palabras | good night |
Crear alias con tus propios nombres y frases, y scripts para secuencias de comandos que repites - consulta Cómo usar alias y scripts del asistente. |
El inglés corriente también permite pedir secuencias sencillas - "connect then start monitor", "turn 1/2/3 on and 1/2/4 off". Con los comandos exactos puedes crear planes completos con condiciones, por ejemplo, escribir en una dirección solo si la lectura de otra supera cierto valor.
Qué necesita
- Un proyecto ETS para todo lo que use nombres, habitaciones o preguntas sobre el proyecto. Sin uno, el asistente sigue funcionando con direcciones literales como
1/2/3y1.1.5. - Una conexión a una pasarela para cualquier tarea en el bus. Puedes conectarte desde el chat: "connect" o "find gateways".
- En Android, iOS y macOS, el plan gratuito incluye un número limitado de instrucciones diarias. Las tareas con dispositivos y los escaneos requieren una suscripción - consulta Planes de Suscripción.
Relacionado
- Página Asistente - la pantalla del chat, las tarjetas y los ajustes
- Cómo usar el asistente - qué puedes pedir, con ejemplos
- Cómo usar alias y scripts del asistente - enséñale tus propias palabras
- Comandos del asistente - el lenguaje exacto de comandos
sharknx
