# JJ3.1 - Cosa sa l'assistente, tavola per tavola

**In una frase.** Il catalogo è la pagina dove leggi, tessera per tessera, quello che l'assistente conosce e quello che gli manca.

Un assistente che risponde sui dati vale quanto ciò che sa dei dati. Qui quel sapere non è nascosto in un programma: è scritto in schede che chiunque può leggere, e che le persone correggono.

1. **Apri il catalogo.** Si chiama **Catalogo semantico**. La prima linguetta è **Cosa sa l'agente**: a schermo l'assistente è chiamato «agente».
2. **Leggi le tessere.** Ogni tessera è una tavola dei Dati spiegati. Sono divise in tre gruppi: **Dimensioni** (chi, dove, cosa: articolo, fornitore, cliente), **Fatti** (quanto e quando: consegne, ordini, giacenze) e **Viste** (risposte già pronte per una regola). La tessera dice in due righe cos'è la tavola e cosa le manca, per esempio «2 colonne senza significato».
    
    ![La pagina «Cosa sa l'agente»: una tessera per ogni tavola, con quello che manca](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-pagina-cosa-sa-lagente-una-tessera-per-ogni-tavola-con-quello-che-manca.png)
    
    *La pagina «Cosa sa l'agente»: una tessera per ogni tavola, con quello che manca*
3. **Guarda la riga in alto.** Dice quale rilascio l'assistente sta usando, quante correzioni approvate aspettano il prossimo rilascio e quante proposte aspettano una decisione.
4. **Apri una scheda.** Un clic sulla tessera apre la scheda della tavola. In alto, «Come la legge l'agente»: a cosa serve, cosa rappresenta una riga, i sinonimi che capisce, le note d'uso, a quali tavole si collega e quali regole la citano. A destra, «Da dove viene»: da quali tabelle del gestionale nasce e quando è stata caricata l'ultima volta. Sotto, le colonne, ognuna con il suo significato e il suo stato.
    
    ![La scheda della tavola «articolo»: come la legge l'assistente e da dove viene. Dati di prova](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-scheda-della-tavola-articolo-come-la-legge-lassistente-e-da-dove-viene-dati-di-prova.png)
    
    *La scheda della tavola «articolo»: come la legge l'assistente e da dove viene. Dati di prova*

<p class="callout info">**Nota.** Le altre linguette: **Da dove viene (ERP)** mostra le tabelle del gestionale e quanto se ne è capito; **Regole** le definizioni delle parole del lavoro; **Proposte** e **Rilasci** come cambia il catalogo.</p>

<p class="callout info">**Per chi sviluppa.** Lo Studio del catalogo è in `frontend/ade-next/src/studio/catalogo-semantico`; i dati arrivano da `/api/sigeagent/catalogo`, servito da `backend/middleware/sigeagent/src/sigeagent/catalogo_api.py`.</p>

<p class="callout info">**Per approfondire.**  
• Il disegno del catalogo: `backend/middleware/sigeagent/docs/DISEGNO_CATALOGO.md`</p>