Personalizzazione AI: Glossario, KPI, Relazioni

L'AI parla la lingua della tua azienda

Il modulo Impostazioni di ReportIA permette di "addestrare" l'AI sul vocabolario specifico, sulle convenzioni e sulle regole di business della tua azienda. Più dati metti qui, più precise saranno le risposte. Senza questo, l'AI farà un buon lavoro generico; con questo, farà un lavoro perfetto specifico per la tua azienda.

Istruzioni di Business

Regole sempre rispettate dall'AI in ogni query. Esempi:

• "Il campo stato_ordine può essere: aperto, evaso, annullato".
• "Considera solo righe con anno >= 2020 (i dati pre-2020 sono migrati e poco affidabili)".
• "Il fatturato si calcola sempre sul totale al netto dell'IVA".
• "Quando dico 'cliente attivo' intendi che ha ordini negli ultimi 12 mesi".

Queste istruzioni vengono inserite automaticamente nel prompt di ogni query AI. L'AI le rispetta sempre.

Glossario aziendale

Termini specifici del tuo settore o della tua azienda:

L'AI usa il glossario per disambiguare le domande. "Top 10 clienti strategici" → l'AI sa cosa significa "strategico" per la tua azienda.

Relazioni tra tabelle

Definizione esplicita delle foreign key:

Formato visuale:

• ordini.id_cliente → clienti.id
• ordini_dettaglio.id_ordine → ordini.id
• articoli.id_categoria → categorie.id

Editor visuale con:

• Selezione tabella1 e colonna1.
• Selezione tabella2 e colonna2.
• Salvataggio.
• Lista relazioni esistenti con eliminazione.

Aiuta l'AI a generare JOIN corretti automaticamente. Senza questo, l'AI deve "indovinare" le relazioni dai nomi colonne.

Descrizioni tabelle e colonne

Per documentare il database:

Descrizione tabella

• "movimenti_magazzino: contiene tutti i movimenti di carico e scarico del magazzino".
• "contatti_legacy: tabella vecchia, NON usare. Sostituita da contatti_new".

Descrizione colonna

• "cli_dt_crz: data creazione cliente (formato YYYY-MM-DD)".
• "ord_imp_tot: importo totale ordine, IVA inclusa".
• "flg_attivo: 1=attivo, 0=disattivato (NON usare 'cancellato' che è una colonna diversa)".

Utile per database con nomi tecnici criptici (legacy, ERP datati). L'AI capisce cosa contengono.

KPI Pre-configurati built-in

Dizionario di KPI aziendali con formule corrette:

Quando l'utente chiede "qual è il nostro DSO?", l'AI applica automaticamente la formula corretta, identificando crediti e fatturato dalle tabelle giuste.

Toggle comportamento AI

Risposta discorsiva

• ON: l'AI commenta i risultati ("Il fatturato di marzo è 245k, +12% vs febbraio").
• OFF: solo dati grezzi, senza commento.

Memoria conversazionale

• ON: l'AI ricorda il contesto delle domande precedenti.
• OFF: ogni domanda è isolata.

Operazioni di scrittura

• ON: l'AI può fare INSERT/UPDATE/DELETE su richiesta.
• OFF: solo lettura (SELECT).

Vedi modulo Operazioni di Scrittura.

Personalizzazione per azienda

In ambiente multi-tenant:

• Ogni azienda ha le proprie impostazioni.
• Glossario, relazioni, KPI specifici.
• L'AI risponde in modo aziendale corretto.

Best practice di configurazione

Inizia gradualmente

• Mese 1: glossario e relazioni base.
• Mese 2: aggiungi descrizioni tabelle critiche.
• Mese 3: configura istruzioni di business basate su domande reali.

Itera basandoti sugli errori

Quando l'AI sbaglia una risposta:

• Capisci perché (mancanza contesto, formula sbagliata, ecc.).
• Aggiungi istruzione/glossario/KPI per correggere.

Coinvolgi data team

Le impostazioni sono il "cervello" della tua AI. Coinvolgi chi conosce meglio i dati per configurarle.

I moduli ReportIA correlati

• Chat AI.
• Database.
• Query Certificate.

Scopri ReportIA e personalizza l'AI sulla tua azienda.