L'assistant SharKNX vous permet de travailler sur votre installation KNX en décrivant ce que vous voulez faire : "is 1.1.5 alive?", "which devices are in room 101?", "set the kitchen temperature to 21". Il répond aux questions sur votre projet ETS et exécute des tâches liées aux passerelles, aux appareils, aux adresses de groupe et au moniteur - toujours après vous avoir montré ce qu'il s'apprête à faire.
Cette page explique le fonctionnement de l'assistant et les raisons de son comportement. Pour commencer à l'utiliser, consultez Comment utiliser l'assistant.
Un assistant KNX, pas un chatbot
L'assistant a un seul rôle : comprendre les demandes concernant une installation KNX. Il connaît un ensemble fixe de tâches - passerelles, appareils, adresses de groupe, surveillance, questions sur le projet et séquences de commandes - et ne discute pas d'autres sujets. Il n'improvise pas non plus s'il ne reconnaît pas une demande.
Il ne repose sur aucun modèle de langage IA ni service cloud. Un moteur déterministe installé sur votre téléphone ou votre ordinateur interprète votre demande en la rapprochant des tâches qu'il connaît et des noms de votre projet ETS chargé. Ainsi :
- Il fonctionne hors ligne - il n'a pas besoin d'une connexion Internet, seulement de votre passerelle KNX pour les tâches sur le bus.
- Votre projet reste sur votre appareil - les données du projet et les prompts ne sont jamais envoyés ailleurs.
- Son comportement est prévisible - une même demande sur un même projet donne toujours le même résultat. Dans un bâtiment occupé, c'est plus important que l'éloquence.
Pour l'instant, l'assistant comprend uniquement les prompts en anglais. Ses réponses s'affichent dans la langue de votre application.
Traitement d'une demande
- Vous saisissez une demande - en anglais courant ou sous la forme d'une commande
sharknxexacte. - L'assistant détermine votre intention - la tâche ainsi que les appareils, adresses de groupe, pièces ou valeurs que vous avez mentionnés. Il recherche les noms dans votre projet ETS. Ainsi, "kitchen light" devient l'adresse de groupe correspondante.
- Si un élément n'est pas clair, il vous pose une question. Si un nom correspond à plusieurs éléments, ou si une valeur ou une cible manque, il vous propose des choix au lieu de deviner.
- Il propose une action, vous la confirmez. Toute action qui écrit sur le bus ou modifie un appareil est d'abord affichée dans une carte avec ses cibles et ses valeurs. Rien ne se passe avant votre confirmation.
- SharKNX exécute l'action - avec le même code que le reste de l'application, après avoir vérifié une nouvelle fois que les cibles existent toujours dans le projet chargé et que la passerelle est connectée.
Les questions sur votre projet reçoivent une réponse directement à partir du projet ETS chargé - l'assistant compte, énumère et suit précisément les liens entre appareils, adresses de groupe, espaces et fonctions, sans faire d'estimation.
Niveaux de confirmation
Chaque tâche a un niveau de confirmation fixe défini par l'application - pas par la formulation de votre demande :
| Niveau | Tâches | Ce qui s'affiche |
|---|---|---|
| Aucun | Questions sur le projet, lecture d'une adresse de groupe, vérification d'un appareil, scans, connexion, moniteur | La tâche s'exécute immédiatement |
| Confirmation | Écriture sur une adresse de groupe, redémarrage d'un appareil, changement du mode programmation | Confirmer ou Annuler sur la carte |
| Confirmation explicite | Écriture sur plusieurs adresses de groupe à la fois, séquences d'écriture, programmation d'une adresse physique | Confirmation explicite requise - la carte répertorie chaque étape protégée avant son exécution |
Une demande ne peut toucher qu'un nombre limité de cibles - voir Limites. Si le projet change après la préparation d'une carte, celle-ci ne peut plus être exécutée. Faites une nouvelle demande pour utiliser le projet à jour.
Trois façons de poser une question
| Méthode | Exemple | Idéal pour |
|---|---|---|
| Anglais courant | turn off the corridor lights |
L'usage quotidien - noms de votre projet et demandes de précision si nécessaire |
| Commandes exactes | sharknx write 1/2/3 on |
Quand vous savez exactement ce que vous voulez. Rien n'est interprété ou deviné - voir Commandes de l'assistant. |
| Vos propres mots | good night |
Créer des alias avec vos noms et expressions, ainsi que des scripts pour les séquences de commandes que vous répétez - voir Comment utiliser les alias et scripts de l'assistant. |
L'anglais courant permet aussi de demander des séquences simples - "connect then start monitor", "turn 1/2/3 on and 1/2/4 off". Les commandes exactes permettent de créer des scénarios complets avec des conditions, par exemple écrire sur une adresse uniquement si la lecture d'une autre adresse dépasse une certaine valeur.
Ce dont l'assistant a besoin
- Un projet ETS pour les fonctions qui utilisent des noms, des pièces ou des questions sur le projet. Sans projet, l'assistant fonctionne toujours avec des adresses littérales telles que
1/2/3et1.1.5. - Une connexion à une passerelle pour toute opération sur le bus. Vous pouvez vous connecter depuis le chat - "connect" ou "find gateways".
- Sur Android, iOS et macOS, l'offre gratuite comprend un nombre limité de prompts par jour. Les tâches sur les appareils et les scans nécessitent un abonnement - voir Plans d'abonnement.
Pages associées
- Page Assistant - l'écran de chat, les cartes et les réglages
- Comment utiliser l'assistant - les demandes possibles avec des exemples
- Comment utiliser les alias et scripts de l'assistant - lui apprendre vos propres mots
- Commandes de l'assistant - le langage exact des commandes
sharknx
