JJ4 - Usarlo

JJ4.1 - Fare una buona domanda

In una frase. Una domanda precisa su cosa, quando e dove riceve un numero giusto al primo colpo.

L'assistente capisce l'italiano di tutti i giorni. Ma più la domanda è chiara, meno deve scegliere lui al posto tuo. Bastano cinque abitudini.

Attenzione. La chat è ancora da accendere: questa pagina descrive come si comporta l'assistente, non una schermata che puoi già aprire. Manca per questo la schermata della chat.

  1. Scrivi tutto in una domanda. Ogni domanda vale per sé: l'assistente non ricorda quella di prima. Non scrivere «e l'anno scorso?», ma la domanda intera.

  2. Di' il periodo. «Nel 2026», «a marzo», «negli ultimi 30 giorni». Senza periodo ne sceglie uno lui, e lo dichiara: controlla che sia quello che volevi.

  3. Usa i codici. Articoli, fornitori e clienti si riconoscono dal loro codice del gestionale. «Il fornitore 33000123» è sicuro, un nome scritto a memoria no.

  4. Usa le parole del lavoro. «Rottura di stock», «copertura», «ordini aperti», «giacenza»: per queste parole il catalogo ha una regola scritta, e l'assistente la applica. La trovi nella linguetta Regole del catalogo.

  5. Chiedi una cosa per volta. Una domanda stretta ha una risposta completa. Una domanda larghissima («tutto sui fornitori») può fermarsi a metà.

Qualche esempio sul riordino, il primo argomento coperto:

Nota. Per le giacenze, se non indichi un deposito, l'assistente usa quello principale della ditta e lo scrive nella risposta.

Nota. Non scrivere nella domanda nomi di persone o dati riservati che non servono: il testo parte verso il modello così com'è.

Per chi sviluppa. Le istruzioni che l'assistente segue sono in backend/middleware/sigeagent/src/sigeagent/agente.py. Una domanda può essere lunga al massimo 4000 caratteri. Il deposito principale è la regola R-13 in backend/middleware/sigeagent/semantica/regole.md.

JJ4.2 - Leggere la risposta

In una frase. La risposta ha tre parti: i passi che l'assistente ha fatto, la tabella o il grafico, e un testo che dice come è stato calcolato il numero.

Un numero da solo non basta per decidere. Serve sapere cosa conta, per quale periodo e a che data. La risposta dell'assistente porta sempre queste informazioni: leggerle richiede dieci secondi.

Attenzione. La chat è ancora da accendere: manca per questo la schermata di una risposta. Quello che segue è ciò che il servizio produce.

I passi. Mentre lavora, la chat mostra cosa sta facendo, per esempio «Sto interrogando i dati». Di solito bastano da una a quattro ricerche.

Il risultato. Può essere un valore solo, una tabella o un grafico a linee o a barre. La tabella porta tutte le righe trovate, fino a mille. Sotto può esserci una nota con le definizioni usate, il periodo e il deposito.

Il testo. Poche righe con cinque cose:

Cosa controllare. Che periodo e definizione siano quelli che intendevi. Che la data dei dati sia recente: se è vecchia di giorni, la copia notturna non sta girando. Che i codici in tabella siano quelli che ti aspetti.

Se la risposta è parziale. Quando la domanda è troppo larga l'assistente si ferma e lo dice: quello che ha mostrato è parziale. Riprova con una domanda più circoscritta.

Se i dati non bastano. L'assistente lo dice e spiega cosa manca. È il momento di chiedere un dato nuovo.

Nota. Prima della prima domanda la chat mostra un avviso: quale servizio di intelligenza artificiale viene usato, in quale regione, e che i risultati sono suggerimenti da verificare prima di usarli.

Per chi sviluppa. Tabella, valore e grafico sono i widget della chat, prodotti da backend/middleware/sigeagent/src/sigeagent/widget.py. Un grafico disegna una serie sola: con più serie la chat mostra un grafico per serie.