JJ5 - Per chi amministra

JJ5.1 - Accendere la chat

In una frase. L'assistente si accende in due tempi: prima il servizio con i suoi dati e il catalogo, poi, con un interruttore sul Gateway, la chat.

L'assistente è spento finché non lo accendi tu. I due tempi servono a non mostrare a nessuno una chat che risponde su dati vuoti: prima si preparano e si controllano i dati, poi si apre la porta.

Attenzione. Nell'ambiente di prova interno il servizio, i Dati spiegati e il catalogo sono accesi. La chat è ancora da accendere: l'ultimo passo qui sotto.

  1. Prepara i segreti. Nel file dei segreti del server metti il blocco dell'assistente: le password dei suoi archivi e la chiave del servizio di intelligenza artificiale. L'interruttore della chat resta spento.

  2. Accendi il servizio. Con il rilascio del server partono due programmi: l'assistente e il suo archivio. Nessuno dei due è raggiungibile da fuori. Se manca una password, il rilascio si ferma subito e dice quale.

  3. Crea gli archivi vuoti. Una volta sola: le tavole dei Dati spiegati e quelle del catalogo.

  4. Carica i dati. Il primo caricamento si lancia a mano. In fondo scrive un riepilogo: controlla che dica «ok». Da lì in poi parte da solo ogni notte.

  5. Riempi il catalogo e fai un rilascio. Il catalogo rilegge i Dati spiegati e le schede; poi si crea il primo rilascio numerato. Apri il catalogo e controlla che le tessere ci siano.

  6. Accendi la chat. Metti l'interruttore SIGEAGENT_ENABLED a true e rilancia il rilascio del server. Il Gateway riparte e manda la chat all'assistente.

Come controlli. Nel registro del Gateway compare «SigeAgent acceso». I due programmi risultano in salute. Nella chat l'etichetta del servizio di intelligenza artificiale è quella dell'assistente.

Per spegnere. Rimetti l'interruttore a false e rilancia: la chat torna com'era prima. I dati e il catalogo restano.

Nota. Il catalogo contiene il lavoro delle persone: va salvato con una copia di sicurezza. I Dati spiegati no: si ricostruiscono con un nuovo caricamento.

Per chi sviluppa. Profilo sigeagent del compose di deploy, servizi sigeagent (porta interna 8765) e sigeagent-mysql. Con l'interruttore acceso il Gateway instrada /api/sigea-cop/ai/agent/stream, /ai/agent/fornitore e /api/sigeagent/**. Con l'interruttore acceso ma il profilo spento, la chat dice «AI non abilitata». Comandi, uno per uno: devops/deploy/README.md, paragrafo 3.6. Variabili: docs/devops/ENVIRONMENT.md.

Per approfondire.
• Deploy, paragrafo 3.6 «SigeAgent: l'agente dei dati»: devops/deploy/README.md

JJ5.2 - Tetto di spesa e riservatezza

In una frase. L'assistente ha un tetto di spesa al giorno e regole precise su quali dati possono arrivare al servizio di intelligenza artificiale.

Ogni domanda costa qualcosa, perché usa un servizio esterno a pagamento. E ogni domanda manda fuori un po' di testo. Chi amministra deve poter rispondere a due domande: quanto si spende al massimo, e cosa esce.

Il tetto di spesa. L'assistente registra per ogni domanda modello, consumo, costo e durata. Prima di ogni nuova domanda somma la spesa del giorno: se ha raggiunto il tetto, non parte e la chat dice «Per oggi è stato raggiunto il tetto di spesa: riprova domani o chiedi di alzarlo». Il tetto predefinito è 5 dollari al giorno. C'è anche un limite di lavoro per singola domanda e un numero massimo di domande insieme.

Cosa esce verso il modello.

Cosa non esce.

Dove sta il modello. La regola di ADSWnext per i dati dei clienti è: intelligenza artificiale spenta in partenza, e solo fornitori nell'Unione europea. L'assistente dichiara alla chat, prima di ogni invio, quale servizio usa e in quale regione: se non risponde, la chat non invia.

Attenzione. Oggi l'assistente gira solo nell'ambiente di prova interno, con dati fittizi, e lì usa un instradamento non garantito nell'Unione europea: la chat lo dichiara. Prima di usarlo con i dati di un cliente vanno chiuse due cose: passare all'instradamento europeo e decidere come trattare i nomi scritti nelle domande, che oggi partono senza essere sostituiti.

Nota. L'assistente che nel catalogo aiuta a preparare le proposte ha un tetto di spesa suo, separato.

Per chi sviluppa. Tetto: SIGEAGENT_TETTO_SPESA_GIORNALIERO_USD. Instradamento europeo: l'impostazione OPENROUTER_BASE_URL del servizio va portata a https://eu.openrouter.ai/api/v1; il compose di deploy oggi non la passa. La dichiarazione del fornitore è l'endpoint /ai/agent/fornitore in backend/middleware/sigeagent/src/sigeagent/web.py. Regole generali e l'eccezione dell'assistente: docs/ai/AI-CONFORMITA.md.

Per approfondire.
• Informativa sull'intelligenza artificiale per il cliente: docs/ai/INFORMATIVA-AI-CLIENTE.md

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

Per chi amministra

Parole da sapere

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.