Glossario

Riferimento alfabetico dei termini tecnici utilizzati nella piattaforma Rela AI.

---

Ably — Servizio di messaggistica in tempo reale utilizzato da Rela AI per consegnare aggiornamenti istantanei alla dashboard (eventi, allarmi, stati delle attivita) tramite WebSocket.

Agente — Assistente di intelligenza artificiale configurato per operare su un canale specifico (WhatsApp, Email o HTTP). Ogni agente ha il proprio prompt di sistema, strumenti assegnati e regole di comportamento.

AHI (Asset Health Index) — Punteggio da 0 a 100 che misura la condizione generale di un asset. Combina dati di vibrazioni, temperatura, ore di funzionamento e altri indicatori per stimare lo stato di salute dell'apparecchiatura.

Baseline — Parametri operativi normali appresi dai dati storici. Serve come riferimento per rilevare deviazioni e anomalie nel comportamento di un asset.

Canale — Mezzo di comunicazione attraverso il quale un agente interagisce con gli utenti. I canali supportati sono WhatsApp, Email e HTTP (API REST).

CBM (Condition-Based Maintenance) — Strategia di manutenzione attivata dalla condizione reale dell'apparecchiatura (vibrazioni, temperatura, usura), anziche seguire un calendario fisso.

Collezione — Insieme di dati strutturati archiviati nella piattaforma che un agente puo interrogare per rispondere a domande o eseguire azioni basate su informazioni specifiche.

config_version — Contatore monotono per tenant del motore predittivo. Si incrementa atomicamente a ogni update_config. Ogni snapshot persistito memorizza la versione attiva al momento del calcolo, abilitando la tracciabilità di audit.

CSAT (Customer Satisfaction) — Sondaggio breve che l'agente WhatsApp o email invia automaticamente al termine di una conversazione (timeout di inattività). Supporta 4 tipi di domanda: scale_1_5, scale_1_10, yes_no, open_text. Vedi features/csat per il flusso completo e gli aggregati.

Digital Twin — Rappresentazione virtuale di un asset fisico che aggrega tutti i dati diagnostici, la cronologia della manutenzione, gli eventi e le metriche in un unico punto di consultazione.

Drift — Cambiamento graduale di una metrica nel tempo che si discosta dal baseline stabilito. Indica un possibile deterioramento progressivo dell'apparecchiatura.

Embedding — Rappresentazione vettoriale di un frammento di testo che consente la ricerca semantica. Utilizzato internamente per trovare informazioni rilevanti all'interno di collezioni e documenti.

Escalation — Catena di notifiche configurata per allarmi industriali che non sono stati riconosciuti entro un periodo di tempo specificato. Segue i principi dello standard ISA 18.2.

Estrazione — Processo automatizzato in cui l'IA analizza documenti (PDF, immagini, ecc.) ed estrae dati strutturati secondo un template predefinito.

Evento — Segnale generato da una macchina o sistema industriale ricevuto dalla piattaforma attraverso una fonte di eventi. Puo rappresentare allarmi, misurazioni o cambiamenti di stato.

Evolution API — Connettore API di WhatsApp Business utilizzato da Rela AI per collegare numeri WhatsApp, inviare e ricevere messaggi tramite agenti conversazionali.

Fonte di eventi — Punto di ingresso dei dati industriali nella piattaforma. Puo essere un webhook HTTP, un broker MQTT o un server OPC UA.

ISA 18.2 — Standard internazionale per la gestione degli allarmi industriali. Rela AI implementa i suoi principi per la prioritizzazione, l'escalation e il ciclo di vita degli allarmi.

ISO 13374 — Standard internazionale per il monitoraggio delle condizioni e la diagnostica delle macchine. Definisce 6 livelli (L1-L6): acquisizione dati, manipolazione dati, rilevamento stato, valutazione della salute, prognostica e consulenza.

LOTO (Lock Out / Tag Out) — Procedura di sicurezza che consiste nel bloccare e contrassegnare le fonti di energia di un'apparecchiatura prima di eseguire interventi di manutenzione, per prevenire avviamenti accidentali.

MQTT — Protocollo di messaggistica leggero progettato per dispositivi IoT e reti con larghezza di banda limitata. Utilizzato come fonte di eventi per ricevere dati da sensori e PLC.

NPS (Net Promoter Score) — Metrica derivata da una domanda CSAT scale_1_10: NPS = %promotori (9-10) − %detrattori (0-6). Calcolato on-the-fly dagli aggregati di una singola domanda sulla raccomandazione. Vedi features/csat.

OEE (Overall Equipment Effectiveness) — Metrica di produzione che combina tre fattori: disponibilita (uptime), prestazioni (velocita reale vs. ideale) e qualita (pezzi buoni vs. totali). Espressa come percentuale.

OPC UA — Protocollo industriale di comunicazione macchina-a-macchina. Consente la lettura di variabili e la sottoscrizione a eventi da server OPC UA direttamente nella piattaforma.

OTP — Codice di verifica monouso (One-Time Password) inviato tramite WhatsApp o Email per autenticare un utente prima di concedere l'accesso a informazioni sensibili.

Page-Hinkley — Test statistico di cambio di media applicato a stream di residuali. Rileva drift silenzioso nei residuali RUL (drift_detection_service) e nei residuali di consumo energetico (energy_drift_service). Default: δ=0,005, λ=50, min_samples=20.

PLC — Controllore logico programmabile (Programmable Logic Controller). Dispositivo industriale che controlla processi automatizzati e puo inviare eventi alla piattaforma.

Postmark — Servizio di consegna email transazionale utilizzato da Rela AI per inviare notifiche via email (avvisi di allarmi, attivita assegnate, report).

Prognostica — Disciplina che prevede la vita utile residua di un'apparecchiatura e anticipa guasti futuri basandosi su dati storici, tendenze e modelli di degrado.

QoS (Quality of Service) — Livello di garanzia di consegna nel protocollo MQTT. Livello 0: consegna al massimo una volta. Livello 1: almeno una volta. Livello 2: esattamente una volta.

Rate of Change — Velocita con cui il valore di una metrica cambia per unita di tempo. Un rate of change elevato puo indicare un degrado accelerato che richiede attenzione immediata.

Record — Dato individuale archiviato all'interno di una collezione. Ogni record contiene campi definiti dallo schema della collezione.

Report — Documento PDF generato dinamicamente a partire da blocchi di contenuto (testo, tabelle, grafici). Gli agenti possono creare report come parte dei loro strumenti disponibili.

RUL (Remaining Useful Life) — Stima delle ore o dei cicli rimanenti prima che un'apparecchiatura si guasti o richieda manutenzione. Viene calcolata a partire dai dati di condizione e dai modelli di degrado.

Severità canonica — Scala condivisa dai 3 rilevatori del pipeline predittivo (anomaly, energy, prognostics): info < warning < high < critical. Implementata in app/services/shared/utils/severity.py con adapter da anomaly score, z-score e RUL hours. È la severità mostrata nella inbox unificata e applicata dalle regole dell'aggregator.

Severità di Machine Events — Scala usata dal gateway degli eventi industriali (webhook HTTP + listener MQTT/OPC UA/Modbus/S7/EtherNet-IP): info < warning < critical < emergency. Enum MachineEventSeverity in app/models/machine_events/machine_events.py. Scala legacy mantenuta per compatibilità con integrazioni esistenti — l'aggregator traduce il suo critical/emergency in high/critical canonici prima di consolidare.

Sessione — Stato di autenticazione associato a una conversazione tra un utente e un agente. Determina il livello di accesso e i dati visibili durante l'interazione.

SLA (Service Level Agreement) — Tempi obiettivo di risposta e risoluzione per attivita e allarmi. Consente di misurare se i team di manutenzione rispettano gli impegni di servizio stabiliti.

SPC (Statistical Process Control) — Metodi statistici per monitorare e controllare i processi. Utilizza grafici di controllo con limiti calcolati per rilevare variazioni anomale nelle metriche di produzione o nelle condizioni delle apparecchiature.

Strumento (Tool) — Capacita specifica assegnata a un agente per eseguire azioni concrete, come interrogare una collezione, creare un'attivita o generare un report.

Task — Unita di lavoro assegnabile a uno o piu membri del team. Le attivita hanno stati (backlog, todo, in corso, completata, annullata) e vengono gestite in una bacheca Kanban.

Template — Modello che definisce i campi e la struttura dei dati da estrarre dai documenti attraverso il processo di estrazione con IA.

Tempo reale — Aggiornamenti istantanei consegnati tramite WebSocket che consentono di visualizzare le modifiche nella dashboard senza dover aggiornare la pagina.

Tenant — Organizzazione o azienda con uno spazio isolato all'interno della piattaforma. Tutti i dati, gli agenti e le configurazioni appartengono a un tenant specifico.

Threshold — Limite configurabile che attiva un'azione quando una metrica lo supera. Utilizzato nelle regole di allarme per definire quando la lettura di un sensore e anomala (es: vibrazione > 5 mm/s).

Webhook — Endpoint HTTP configurato per ricevere eventi automaticamente da sistemi esterni. Utilizzato come fonte di eventi e per integrazioni con terze parti.

Z-score — Numero di deviazioni standard che un valore si trova al di sopra o al di sotto della media. Uno Z-score maggiore di 3 o inferiore a -3 indica generalmente un valore anomalo che merita un'indagine.