node-red-contrib-knx-ultimate/nodes/locales/it/knxUltimateAI.html

Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control, ETS group address importer, and KNX routing between interfaces. Easy to use and highly configurable.

<script type="text/markdown" data-help-name="knxUltimateAI">
Questo nodo ascolta **tutti i telegrammi KNX** dal gateway KNX Ultimate selezionato e produce statistiche, rileva alcune anomalie e (opzionalmente) può interrogare un LLM per un’analisi in linguaggio naturale.

## Cosa fa
- Mantiene uno storico a finestra dei telegrammi KNX (già decodificati da KNX Ultimate).
- Invia **summary del traffico** (Top GA, tipi evento, rate) a intervallo o su richiesta.
- Emette **eventi di anomalia** (rate BUS elevato, spam su GA, flapping).
- Se abiliti l’LLM, puoi inviare un comando `ask` per ottenere suggerimenti/diagnosi.

## Output
1. **Summary/Statistiche** (`msg.payload` JSON)
2. **Anomalie** (`msg.payload` JSON)
3. **Assistente AI** (`msg.payload` testo; include `msg.summary`)

## Comandi (pin di input)
Invia un messaggio con `msg.topic`:
- `summary` (o topic vuoto): emette subito una summary
- `reset`: svuota storico e contatori
- `ask`: domanda all’LLM usando summary + traffico recente

Per `ask`, inserisci la domanda in `msg.prompt` (consigliato) oppure in `msg.payload` (stringa).

## Contesto LLM (risposte migliori)
Quando usi `ask`, il nodo può opzionalmente inviare altro contesto all’LLM:
- **Inventario flow**: elenco dei nodi KNX Ultimate presenti nei flow di Node-RED (aiuta a collegare i telegrammi alla logica).
- **Estratti documentazione**: frammenti rilevanti da help/README/esempi (e `docs/wiki` quando disponibile).

## Nota privacy
Se abiliti l’LLM, il traffico verrà inviato all’endpoint configurato. Se vuoi tenere tutto in locale usa un provider on-premise (es. Ollama).

## Nota API key OpenAI
Incolla **solo** la chiave API (inizia con `sk-`). Non incollare `Bearer ...` o l’intera riga `Authorization: ...`.
</script>