# JJ5.3 - Se qualcosa non va

**In una frase.** I problemi più comuni con l'assistente e con il catalogo, come «vedo questo, faccio questo», e le parole da sapere.

Quasi sempre l'assistente dice già cosa non va, in italiano. Qui trovi cosa fare dopo averlo letto.

## Nella chat

- **La chat non invia, o dice «AI non abilitata».** L'assistente è spento o acceso a metà. Avvisa chi amministra: vedi [Accendere la chat](https://gsdoc.genesyssoftware.eu/link/37905).
- **«Per oggi è stato raggiunto il tetto di spesa».** Riprova domani, o chiedi a chi amministra di alzarlo: vedi [Tetto di spesa e riservatezza](https://gsdoc.genesyssoftware.eu/link/37906).
- **«Ci sono già troppe domande in corso».** Aspetta qualche secondo e riprova.
- **«Ho raggiunto il limite di lavoro per una domanda».** Quello che vedi è parziale. Fai una domanda più stretta: un periodo, un fornitore, un gruppo di articoli.
- **Dice che i dati non bastano.** Il dato non è nei Dati spiegati. Chiedilo: vedi [Chiedere un dato nuovo](https://gsdoc.genesyssoftware.eu/link/37901).
- **Il numero non mi torna.** Leggi nel testo la definizione, il periodo e il deposito usati. Se la definizione è sbagliata, si corregge la regola nel catalogo.
- **I dati sono vecchi.** La risposta dice a che data sono aggiornati. Se è indietro di più giorni, la copia notturna non è riuscita: avvisa chi amministra.

## Nel catalogo

- **Ho corretto una scheda ma l'assistente risponde come prima.** Manca il rilascio. La riga in alto dice quante correzioni aspettano: premi **Rilascia** e crea il rilascio.
- **«Chiedi a un collega» non parte.** Scrivi il perché, in una riga.
- **La mia proposta è ferma «in assestamento».** È un dato nuovo: aspetta il lavoro di chi sviluppa.
- **La pagina «Assistente» dice «non configurato».** Manca la sua chiave: avvisa chi amministra.

## Per chi amministra

- **Il servizio non parte.** Di solito manca una password del suo archivio: il registro dell'archivio dice quale.
- **Il riepilogo della copia notturna segna un gruppo «saltato».** Nel gestionale mancano quelle tabelle. Gli altri dati sono caricati.

## Parole da sapere

- **Assistente dei dati.** Il servizio che risponde alle domande. A schermo, nel catalogo, è «l'agente».
- **Dati spiegati.** La copia ordinata dei dati aziendali, con nomi in italiano. L'assistente legge solo questa.
- **Copia notturna.** Il lavoro che ogni notte riempie i Dati spiegati.
- **Catalogo.** Le schede che dicono cosa significa ogni tavola e ogni colonna.
- **Tavola.** Un argomento dei Dati spiegati: articolo, fornitore, giacenza.
- **Regola.** La definizione scritta di una parola del lavoro, come «acquisto» o «copertura».
- **Stato.** Quanto è sicuro un significato: ignoto, ipotesi, verificato, smentito.
- **Proposta.** La richiesta di cambiare qualcosa nel catalogo. La decide una persona.
- **Rilascio.** Una versione numerata del catalogo. L'assistente usa l'ultima.
- **Tetto di spesa.** Il massimo che l'assistente può spendere in un giorno.

<p class="callout info">**Per chi sviluppa.** Esito dei caricamenti notturni: cartella dei log del servizio e tavola `caricamento_etl`. Messaggi della chat: `backend/middleware/sigeagent/src/sigeagent/flusso.py` e `backend/middleware/sigeagent/src/sigeagent/agente.py`. Stati a metà dell'accensione: `devops/deploy/README.md`, paragrafo 3.6.</p>