# JJ1 - A cosa serve

# 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>

# JJ1.2 - Dove sta nella mappa

**In una frase.** Lo Strato agentico è fatto di tre tessere: l'Assistente dei dati, l'intelligenza artificiale che capisce la domanda e i Dati spiegati.

Sapere dove sta spiega due cose: perché l'assistente non può rovinare niente, e da dove vengono i suoi numeri.

<div drawio-diagram="2795"><img src="https://gsdoc.genesyssoftware.eu/uploads/images/drawio/2026-11/la-mappa-di-adswnext-con-lo-strato-agentico-e-i-dati-spiegati-accesi.png" alt="La mappa di ADSWnext con lo Strato agentico e i Dati spiegati accesi"/></div>

*La mappa di ADSWnext con lo Strato agentico e i Dati spiegati accesi*

**Chi lo chiama.** Lo chiami tu, dalla chat delle pagine nuove (SIGEAnext). La domanda passa dal Gateway, che controlla chi sei e la consegna all'assistente. Dallo stesso ingresso passano le pagine del catalogo, dove si legge e si corregge quello che l'assistente sa.

**Chi chiama lui.** Due soli: l'**intelligenza artificiale**, a cui manda la domanda e i significati del catalogo per farsi preparare la ricerca, e i **Dati spiegati**, dove esegue la ricerca in sola lettura.

**Cosa non fa.** Non legge i Dati aziendali e non li modifica mai. I Dati spiegati li riempie una copia notturna, che dai Dati aziendali legge soltanto: vedi [I dati spiegati: la copia notturna](https://gsdoc.genesyssoftware.eu/link/37896).

<p class="callout info">**Nota.** Se l'assistente è spento, il resto di ADSWnext lavora come sempre: nessun altro servizio dipende da lui.</p>

<p class="callout info">**Per chi sviluppa.** Il Gateway manda a SigeAgent la chat (`/api/sigea-cop/ai/agent/stream`) e `/api/sigeagent/**` solo con `SIGEAGENT_ENABLED=true`(classe `GatewayConfig` in `backend/middleware/it_gsba_api_gateway`). I Dati spiegati sono un MySQL 8.4 proprio del servizio, senza porte pubblicate.</p>