Ce nœud écoute tous les télégrammes KNX du gateway KNX Ultimate sélectionné, produit des statistiques de trafic, détecte des anomalies et peut interroger un LLM de façon optionnelle.

Sorties

1. Résumé/Stats (msg.payload JSON)
2. Anomalies (msg.payload JSON)
3. Assistant IA (msg.payload texte, avec msg.summary)

Commandes (entrée)

Envoyez msg.topic :

• summary (ou vide) : envoie le résumé immédiatement
• reset : vide l’historique/compteurs internes
• ask : envoie une question au LLM configuré

Pour ask, mettez la question dans msg.prompt (recommandé) ou msg.payload (chaîne).

Champs de configuration

Voici tous les champs tels qu’affichés dans l’éditeur KNX AI.

Général

• Gateway : gateway/config node KNX Ultimate utilisé comme source des télégrammes.
• Name : nom du nœud et titre du dashboard.
• Topic : topic de base utilisé dans les sorties.
• Bouton Open KNX AI Web : ouvre le dashboard web (/knxUltimateAI/sidebar/page).

Capture

• Capture GroupValue_Write : capture les télégrammes Write.
• Capture GroupValue_Response : capture les télégrammes Response.
• Capture GroupValue_Read : capture les télégrammes Read.

Analysis

• Analysis window (seconds) : fenêtre principale pour résumé/débits.
• History window (seconds) : fenêtre de rétention de l’historique interne.
• Max stored events : nombre maximal de télégrammes en mémoire.
• Auto emit summary (seconds, 0=off) : intervalle périodique d’émission du résumé.
• Top list size : nombre de group addresses/sources dans le top.
• Detect simple patterns (A -> B) : active la détection de transitions/patterns.
• Pattern max lag (ms) : écart temporel max pour corrélation des patterns.
• Pattern min occurrences : occurrences minimales avant signalement.

Anomalies

• Rate window (seconds) : fenêtre glissante pour contrôles de débit.
• Max overall telegrams/sec (0=off) : seuil sur le bus global.
• Max telegrams/sec per GA (0=off) : seuil par group address.
• Flap window (seconds) : fenêtre de détection flapping/changements rapides.
• Max changes per GA in window (0=off) : nombre max de changements autorisés.

LLM Assistant

• Enable LLM assistant : active les fonctions Ask/chat.
• Provider : backend LLM (OpenAI-compatible ou Ollama).
• Endpoint URL : URL endpoint chat/completions.
• API key : clé API (non requise avec Ollama local).
• Model : ID/nom du modèle.
• System prompt : instruction système globale pour l’analyse KNX.
• Temperature : température d’échantillonnage.
• Max tokens : nombre maximal de tokens de complétion.
• Timeout (ms) : timeout HTTP des requêtes LLM.
• Recent events included : nombre max d’événements récents dans le prompt.
• Include raw payload hex : inclut le payload hex brut dans le prompt.
• Include Node-RED KNX node inventory : inclut l’inventaire des flows.
• Max flow nodes included : limite de nœuds flow inclus.
• Include documentation snippets (help/README/examples) : inclut le contexte documentation.
• Docs language : langue préférée des snippets documentation.
• Max docs snippets : nombre max de snippets documentation.
• Max docs chars : nombre total max de caractères documentation.
• Bouton Refresh : interroge le provider et charge les modèles disponibles.

Note sécurité

Si le LLM est activé, le contexte trafic KNX peut être envoyé à l’endpoint configuré. Pour un usage strictement on-premise, utilisez un provider local.