Assistente IT Hupac
Chatbot di help desk IT interno per il primo livello di assistenza ai colleghi.
Perché un assistente IT interno
- Il reparto IT è interrotto di continuo da domande ripetitive di primo livello (VPN, stampanti, Office, accessi).
- Le stesse procedure vengono spiegate più volte, sottraendo tempo ad attività a maggior valore.
- I colleghi attendono una risposta anche per problemi semplici e già documentati.
- Risolvere in autonomia il primo livello delle richieste IT.
- Ridurre le interruzioni al reparto.
- Smistare al team solo ciò che richiede un intervento umano.
Self-service
Risposte immediate 24/7 ai dubbi comuni, senza attese.
Meno ticket
Filtra le richieste banali a monte, prima che diventino ticket.
Smistamento
Indirizza al team IT i casi complessi che servono davvero.
Cosa sa fare il bot
Risposte di primo livello
Procedure passo-passo per VPN, stampanti, Windows, Office / Outlook, accessi e rete.
Lettura di screenshot
L'utente allega un'immagine (errore o schermata) — anche dalla finestra pop-out: il bot la interpreta e propone i passi.
Multilingua
Italiano di default; risponde anche in inglese o tedesco seguendo la lingua dell'utente.
Smistamento al team IT
Quando serve un intervento umano, indirizza all'apertura di una richiesta al reparto IT.
Streaming in tempo reale
La risposta scorre token per token mentre il modello elabora: nessuna attesa, esperienza immediata.
Feedback 👍 / 👎
Due tasti sotto ogni risposta del bot. Il voto viene inviato a /api/feedback e loggato nei Workers Logs.
Sessione persistente
La conversazione sopravvive al refresh di pagina grazie al salvataggio automatico in localStorage.
Nuova conversazione
Pulsante ↺ nell'header per resettare la chat in un clic, pulendo anche la sessione salvata.
Come è fatto, dal browser al modello
Widget browser
Chat in pagina, allega/incolla screenshot, finestra pop-out.
Cloudflare Pages
Proxy sicuro: valida l'input, custodisce la API key e ri-streama la risposta via SSE.
Anthropic API
Genera la risposta secondo il system prompt dedicato.
Stack tecnologico e scelte progettuali
Front-end senza build
JavaScript "vanilla": un singolo widget.js si inietta con un tag <script>. Nessun framework né pipeline di build da mantenere.
Cloudflare Pages Functions
Hosting statico + serverless per /api/chat. Nessun server da gestire, scalabilità automatica, deploy via Git.
Claude via API Anthropic
Modelli gestiti: nulla da addestrare o ospitare. Comportamento guidato da un system prompt dedicato a Hupac.
Integrabile ovunque
Il widget si aggancia a qualunque pagina interna (intranet / portale) senza toccare l'infrastruttura esistente.
Selezione del modello in base alla richiesta
Il proxy sceglie automaticamente il modello: il più economico per il testo, uno più capace solo quando serve l'analisi di un'immagine.
Claude Haiku 4.5
Veloce ed economico. Gestisce la grande maggioranza delle domande: procedure, istruzioni, troubleshooting di base.
Claude Sonnet 4.6
Più capace nella lettura di screenshot. Attivato solo quando la richiesta contiene una o più immagini.
Sicurezza e privacy by design
Per costruzione il bot resta sul primo livello: non chiede, non tratta e non conserva dati personali o sensibili.
Nessun dato personale o sensibile
Il bot non chiede né tratta password, PIN, token o dati personali. Risolve solo il primo livello; tutto il resto va al team IT.
Nessuna azione privilegiata
Non resetta password, non sblocca account, non crea utenze né assegna permessi: queste azioni restano al team IT.
API key protetta
La chiave Anthropic vive solo come variabile d'ambiente sul server. Il browser non la vede mai.
Input validato
Sanitizzazione di testo e immagini, tipi e dimensioni controllati, CORS gestito a livello di endpoint.
Risposte affidabili e smistamento al team IT
Il bot dichiara quanto è affidabile ogni risposta e, quando serve l'intervento umano, prepara un riepilogo già pronto per il ticket.
Fonte e confidenza
Ogni risposta operativa mostra un livello di confidenza — alta, media o bassa. In fase pilota il bot è trasparente: usa conoscenza IT generale e non inventa procedure interne.
Riepilogo pronto per il ticket
Quando smista al team IT, genera un riepilogo precompilato — categoria, oggetto, descrizione, già provato, urgenza — da copiare con un clic e incollare nel ticket.
Stato attuale e prossimi passi
- Widget di chat funzionante con interfaccia in stile Hupac.
- Upload screenshot: allega, incolla (Ctrl+V) e drag & drop — anche nella finestra pop-out.
- Risposte multilingua e system prompt dedicato all'help desk.
- Proxy sicuro su Cloudflare con streaming SSE e selezione automatica del modello.
- Finestra pop-out spostabile su un secondo monitor.
- Streaming in tempo reale: la risposta scorre token per token.
- Markdown con liste puntate e numerate nelle risposte del bot.
- Sessione persistente in localStorage (sopravvive al refresh).
- Pulsante "Nuova conversazione" per resettare la chat.
- Feedback 👍 / 👎 su ogni risposta — log via
/api/feedback.
- Caricare le procedure reali dei problemi IT più frequenti.
- Inserire le modalità ufficiali di apertura ticket al team IT.
- Pilota con un gruppo ristretto di colleghi e analisi delle metriche di utilizzo.
- Logging, metriche d'uso e stima dei costi a regime.
- Integrazione nell'intranet / portale interno.
Un prototipo funzionante, pronto da validare con un pilota
Risolve solo il primo livello e riduce le interruzioni al reparto IT: risponde ai colleghi 24/7 in più lingue e legge gli screenshot, senza trattare dati personali o sensibili e lasciando ogni azione critica al team IT.