# JJ1.1 - Fare una domanda e avere un numero

**In una frase.** L'Assistente dei dati risponde in italiano alle domande sui dati dell'azienda, con un testo, una tabella e un grafico.

«Quanto abbiamo ordinato a quel fornitore quest'anno?» Per saperlo, prima serviva qualcuno che conoscesse le tabelle del gestionale e sapesse interrogarle. Con l'Assistente dei dati scrivi la domanda come la faresti a un collega. Lui la trasforma in una ricerca, la esegue e ti mostra il risultato.

L'assistente non indovina. Lavora su una copia dei dati fatta apposta per lui, i **Dati spiegati**, dove ogni tavola ha un nome chiaro e un significato scritto e controllato da persone. Ogni numero della risposta viene da una ricerca fatta davvero su quei dati.

![Alcuni degli argomenti che l'assistente conosce: consegne, ordini, acquisti, vendite. A schermo l'assistente è chiamato «agente»](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/alcuni-degli-argomenti-che-lassistente-conosce-consegne-ordini-acquisti-vendite-a-schermo-lassistente-e-chiamato-agente.png)

*Alcuni degli argomenti che l'assistente conosce: consegne, ordini, acquisti, vendite. A schermo l'assistente è chiamato «agente»*

<p class="callout success">**Cosa ci guadagni.**  
• **Numeri senza saper usare un database.** Scrivi in italiano. Ricevi il numero, la tabella con le righe e, se serve, un grafico a linee o a barre.  
• **Numeri affidabili.** L'assistente dice quale definizione ha usato, per quale periodo e a che data sono aggiornati i dati. Se i dati non bastano, lo dice.  
• **Significati scritti dalle persone.** Cosa vuol dire «acquisto» o «giacenza» sta in un catalogo che si legge e si corregge. Una correzione approvata vale per tutte le domande che seguono. </p>

Il primo argomento coperto è il **riordino**: acquisti, ordini a fornitori e di clienti, consegne, giacenze, volantini. Altri argomenti si aggiungono chiedendo un dato nuovo dal catalogo.

<div drawio-diagram="2794"><img src="https://gsdoc.genesyssoftware.eu/uploads/images/drawio/2026-11/da-una-domanda-a-una-risposta-chi-lavora-in-ordine.png" alt="Da una domanda a una risposta: chi lavora, in ordine"/></div>

*Da una domanda a una risposta: chi lavora, in ordine*

<p class="callout warning">**Attenzione.** La chat dell'assistente è ancora da accendere nell'ambiente di prova interno. I Dati spiegati e il catalogo ci sono già e si usano. Come si accende: [Accendere la chat](https://gsdoc.genesyssoftware.eu/link/37905).</p>

<p class="callout info">**Nota.** L'assistente legge soltanto. Non può cambiare nessun dato, né nei Dati spiegati né nel gestionale.</p>

<p class="callout info">**Per chi sviluppa.** L'assistente è SigeAgent, un servizio Python in `backend/middleware/sigeagent`. Un solo agente con tre strumenti: eseguire una ricerca, mostrare il risultato, proporre di salvare una domanda riuscita. Il codice è in `backend/middleware/sigeagent/src/sigeagent/agente.py`.</p>

<p class="callout info">**Per approfondire.**  
• SigeAgent, cos'è e dove guardare: `backend/middleware/sigeagent/README.md`</p>