Mit dem SharKNX-Assistenten können Sie mit Ihrer KNX-Installation arbeiten, indem Sie Ihr Anliegen eingeben: "is 1.1.5 alive?", "which devices are in room 101?", "set the kitchen temperature to 21". Er beantwortet Fragen zu Ihrem ETS-Projekt und führt Aufgaben zu Gateways, Geräten, Gruppenadressen und dem Monitor aus - immer erst, nachdem er Ihnen gezeigt hat, was er tun wird.
Diese Seite erklärt, wie der Assistent funktioniert und warum er sich so verhält. Wie Sie ihn verwenden, erfahren Sie unter Den Assistenten verwenden.
Ein KNX-Assistent, kein Chatbot
Der Assistent hat eine einzige Aufgabe: Anfragen zu einer KNX-Installation verstehen. Er kennt eine feste Auswahl an Aufgaben - Gateways, Geräte, Gruppenadressen, Überwachung, Projektfragen und Befehlsfolgen - und unterhält sich nicht über andere Themen. Erkennt er eine Anfrage nicht, improvisiert er nicht.
Im Hintergrund gibt es kein KI-Sprachmodell und keinen Cloud-Dienst. Eine deterministische Engine auf Ihrem Smartphone oder Computer ordnet Ihre Anfrage den bekannten Aufgaben und den Namen in Ihrem geladenen ETS-Projekt zu. Das bedeutet:
- Er funktioniert offline - er benötigt keine Internetverbindung, sondern nur für Busaufgaben Ihr KNX-Gateway.
- Ihr Projekt bleibt auf Ihrem Gerät - Projektdaten und Prompts werden niemals irgendwohin gesendet.
- Er ist vorhersehbar - dieselbe Anfrage im selben Projekt führt immer zum selben Ergebnis. In einem bewohnten Gebäude ist das wichtiger als eine geschliffene Formulierung.
Der Assistent versteht derzeit nur Prompts auf Englisch. Seine Antworten werden in der Sprache Ihrer App angezeigt.
So wird eine Anfrage verarbeitet
- Sie geben eine Anfrage ein - in einfachem Englisch oder als exakten
sharknx-Befehl. - Der Assistent ermittelt Ihre Absicht - die Aufgabe sowie die Geräte, Gruppenadressen, Räume oder Werte, die Sie genannt haben. Namen werden in Ihrem ETS-Projekt nachgeschlagen. So wird "kitchen light" zur zugehörigen Gruppenadresse.
- Wenn etwas unklar ist, fragt er nach. Wenn ein Name zu mehreren Einträgen passt oder ein Wert beziehungsweise Ziel fehlt, bietet er Auswahlmöglichkeiten an, statt zu raten.
- Er schlägt eine Aktion vor, Sie bestätigen sie. Alles, was auf den Bus schreibt oder ein Gerät ändert, wird zuerst als Karte mit Zielen und Werten angezeigt. Erst nach Ihrer Bestätigung geschieht etwas.
- SharKNX führt die Aktion aus - mit demselben Code wie der Rest der App. Zuvor wird noch einmal geprüft, ob die Ziele im geladenen Projekt vorhanden und das Gateway verbunden sind.
Fragen zu Ihrem Projekt beantwortet der Assistent direkt anhand des geladenen ETS-Projekts - er zählt auf, listet auf und verfolgt Verknüpfungen zwischen Geräten, Gruppenadressen, Bereichen und Funktionen exakt, statt etwas zu schätzen.
Bestätigungsstufen
Jede Aufgabe hat eine feste Bestätigungsstufe, die von der App festgelegt wird - nicht durch die Formulierung Ihrer Anfrage:
| Stufe | Aufgaben | Anzeige |
|---|---|---|
| Keine | Fragen zum Projekt, Gruppenadresse lesen, Gerät prüfen, Scans, verbinden, Monitor | Die Aufgabe wird sofort ausgeführt |
| Bestätigung | Eine Gruppenadresse beschreiben, ein Gerät neu starten, den Programmiermodus umschalten | Bestätigen oder Abbrechen auf der Karte |
| Ausdrückliche Bestätigung | Mehrere Gruppenadressen gleichzeitig beschreiben, Schreibfolgen, eine physikalische Adresse programmieren | Ausdrückliche Bestätigung erforderlich - die Karte listet vor der Ausführung jeden geschützten Schritt auf |
Eine Anfrage kann nur eine begrenzte Anzahl an Zielen betreffen - siehe Grenzwerte. Wenn sich das Projekt ändert, nachdem eine Karte vorbereitet wurde, kann sie nicht mehr ausgeführt werden. Fragen Sie erneut, um das aktuelle Projekt zu verwenden.
Drei Möglichkeiten, Anfragen zu stellen
| Möglichkeit | Beispiel | Geeignet für |
|---|---|---|
| Einfaches Englisch | turn off the corridor lights |
Alltagssprache - Namen aus Ihrem Projekt und Rückfragen bei Bedarf |
| Exakte Befehle | sharknx write 1/2/3 on |
Wenn Sie genau wissen, was Sie möchten. Es wird nichts interpretiert oder erraten - siehe Befehle des Assistenten. |
| Ihre eigenen Wörter | good night |
Aliasse für eigene Namen und Formulierungen sowie Skripte für wiederkehrende Befehlsfolgen - siehe Aliase und Skripte des Assistenten verwenden. |
Einfaches Englisch versteht auch einfache Folgen - "connect then start monitor", "turn 1/2/3 on and 1/2/4 off". Mit exakten Befehlen können Sie vollständige Abläufe mit Bedingungen erstellen, zum Beispiel eine Adresse nur dann beschreiben, wenn bei einer anderen Adresse ein Wert über einem bestimmten Wert gelesen wird.
Was der Assistent benötigt
- Ein ETS-Projekt für alle Funktionen, die Namen, Räume oder Projektfragen verwenden. Ohne Projekt funktioniert der Assistent weiterhin mit direkten Adressen wie
1/2/3und1.1.5. - Eine Gateway-Verbindung für alle Aufgaben am Bus. Sie können sich im Chat verbinden - "connect" oder "find gateways".
- Unter Android, iOS und macOS umfasst der kostenlose Tarif eine begrenzte Anzahl an Prompts pro Tag. Geräteaufgaben und Scans erfordern ein Abonnement - siehe Abonnementpläne.
Verwandte Seiten
- Seite Assistent - der Chatbildschirm, die Karten und die Einstellungen
- Den Assistenten verwenden - mögliche Anfragen mit Beispielen
- Aliase und Skripte des Assistenten verwenden - eigene Begriffe beibringen
- Befehle des Assistenten - die genaue
sharknx-Befehlssprache
