Concetti chiave
Glossario operativo: agente, strumento, collezione, asset, allarme, attività, piano di manutenzione, pipeline predittivo e livelli di maturità.
Concetti chiave
Questa pagina è il glossario operativo di Rela AI — i termini che vedrai nella dashboard, nelle conversazioni con l'agente e nei report. Padroneggiare questi 10 concetti ti permette di leggere qualsiasi altra pagina della doc senza perderti.
A cosa serve
- Allineare il vocabolario tra operations, manutenzione e IT prima dell'implementazione.
- Evitare confusioni tra termini simili (asset vs apparecchiatura vs macchina; allarme vs evento vs alert).
- Stabilire il modello mentale che il resto della documentazione assume.
Come funziona
La piattaforma collega tutti questi concetti in un unico flusso: un asset con sensori emette eventi; gli eventi possono scatenare allarmi; un allarme crea un'attività; l'attività viene eseguita da un tecnico guidato da un agente IA che usa strumenti. L'informazione fluisce tra collezioni e i piani regolano la cadenza. Capire questa catena è capire Rela AI.
Agente
Un agente e un'IA conversazionale configurata per interagire con gli utenti attraverso un canale specifico. Rela AI supporta due tipi di agenti:
| Canale | Motore di IA | Integrazione |
|---|---|---|
| Motore di IA | Evolution API (WhatsApp Business) | |
| Motore di IA | Postmark (invio email) |
Ogni agente possiede:
- Nome — Identificativo univoco.
- Prompt di sistema — Istruzioni organizzate in sezioni modificabili che definiscono la personalita e il comportamento.
- Strumenti — Funzionalita che l'agente utilizza durante la conversazione (cercare dati, generare report, chiamare API).
- Configurazione — Parametri specifici del canale (modello di IA, lingua, timeout).
Strumento (Tool)
Uno strumento conferisce al tuo agente capacita che vanno oltre la semplice conversazione. Esistono tre tipi:
- Interrogazione dati — Cerca informazioni nelle tue collezioni utilizzando la ricerca semantica (per significato) o esatta (per codice/numero di serie). Configuri la collezione, i campi di ricerca e il numero massimo di risultati.
- Azione interna — Esegue funzioni predefinite del sistema:
generate_report(PDF),assign_task(attivita),send_whatsapp_message,send_email,locate_nearest_personnel,send_file. Ogni azione accetta parametri con valori predefiniti opzionali. - Connessione esterna — Si collega a sistemi esterni alla piattaforma tramite HTTP (API REST), MQTT (protocollo leggero di messaggistica per dispositivi IoT) o OPC UA (protocollo standard per la comunicazione con macchinari industriali) come PLC Siemens, Beckhoff, Allen-Bradley.
L'agente decide automaticamente quando utilizzare ogni strumento in base alla conversazione e alla descrizione dello strumento.
Collezione
Una collezione e un insieme di dati strutturati con campi tipizzati (string, float, int, boolean, date, list, file). Si creano in due modi:
- Per estrazione — L'IA estrae dati dai documenti (PDF, immagini) automaticamente secondo un modello di campi.
- Manuale — Definisci i campi e aggiungi i record direttamente.
Ogni record genera automaticamente un embedding (una rappresentazione numerica che consente ricerche intelligenti) che abilita la ricerca semantica. Ad esempio, cercando "laptop per design" si trovano record come "MacBook Pro per progettazione grafica" anche se le parole non corrispondono esattamente.
Le collezioni supportano anche la ricerca esatta per campi come codici, numeri di serie o DNI, dove e necessaria una corrispondenza precisa.
Prompt di sistema
Il prompt di sistema definisce il comportamento del tuo agente. E organizzato in sezioni indipendenti che puoi modificare, riordinare e ottimizzare individualmente:
| Sezione | Scopo |
|---|---|
| Identita | Chi e l'agente — nome, ruolo, personalita, tono |
| Istruzioni | Cosa deve fare — flusso di conversazione, passaggi, informazioni da raccogliere |
| Regole | Limiti e restrizioni — cosa NON deve fare, politiche di escalation |
| Strumenti | Come utilizzare gli strumenti — quando invocarli, quali parametri richiedere, come presentare i risultati |
Ogni sezione ha un pulsante Migliora con IA che ottimizza il contenuto per il canale specifico (WhatsApp: testo con formattazione, email: testo professionale). Inoltre, puoi aggiungere sezioni personalizzate aggiuntive per FAQ, orari, procedure speciali, ecc.
Estrazione
Processo in cui l'IA analizza documenti ed estrae dati strutturati. Utilizza la visione artificiale per PDF scannerizzati e immagini, e l'elaborazione del testo per documenti con testo selezionabile. Supporta:
- Estrazione individuale — Un record per documento.
- Estrazione in blocco — Molteplici record da un singolo documento (tabelle, cataloghi, inventari).
- Audit — Genera immagini annotate che mostrano dove ogni dato e stato trovato nel documento originale.
Tenant
Rela AI e multi-tenant. Ogni organizzazione (tenant) ha un isolamento completo dei dati: i propri agenti, collezioni, strumenti, dipartimenti, personale, storico delle conversazioni e report. Nessun tenant puo accedere ai dati di un altro.
Benefici chiave
- Vocabolario canonico condiviso tra operations, manutenzione, IT e commerciale.
- Meno fraintendimenti in riunione ("allarme? evento? alert?") — ogni termine ha una definizione stabile.
- Base per leggere qualsiasi altra pagina della doc: ogni termine fa riferimento a queste definizioni.
- Allineato al glossary tecnico per i termini avanzati (AHI, RUL, Page-Hinkley, config_version).