andrei calapod

ai con supervisione umana

Un helpdesk AI che risponde solo quando può dimostrarlo

Un assistente per studenti fondato sui documenti ufficiali di un corso di laurea — cinque controlli, tre esiti possibili, approvazione umana e ricontrollo automatico quando i documenti cambiano.

Committente
Corso di laurea di un ateneo pubblico italiano · progetto descritto in forma anonima
Periodo
In esercizio
Ruolo
Analisi, UX/UI, sviluppo full-stack, pipeline AI, deployment e manutenzione
Stack
  • Python · FastAPI
  • Retrieval sui documenti ufficiali (RAG)
  • Pipeline di verifica di fonti e numeri
  • Scheduler di ricontrollo documenti
  • Docker · Caddy · Linux
Pannello di controllo dell'helpdesk con lo schema del servizio — la domanda dello studente attraversa cinque controlli e arriva a uno di tre esiti — risolta, dai documenti o rimandata all'ufficio.
fig. 01 La guida del pannello di controllo — cinque controlli, tre esiti, ricontrollo quotidiano dei documenti.

Contesto

Gli studenti di un corso di laurea fanno ogni giorno le stesse domande — iscrizioni, piani di studio, tirocinio, laboratori, esami, riconoscimento crediti, date degli appelli. Le risposte esistono, ma vivono dentro regolamenti e documenti lunghi decine di pagine.

Su questi temi una risposta sbagliata non è un piccolo inconveniente — una data errata o un requisito inventato possono costare un semestre. Un chatbot generico, capace di "allucinare" contenuti plausibili, era fuori discussione. La domanda progettuale è diventata quindi un'altra — come si costruisce un assistente AI di cui un'istituzione possa fidarsi?

Il problema

  • Domande ripetitive che assorbono tempo delle persone che seguono gli studenti.
  • Risposte sparse in documenti lunghi, difficili da consultare per chi ha fretta.
  • I modelli linguistici generici inventano — inaccettabile su date, importi e requisiti.
  • I documenti cambiano durante l'anno — e le risposte date ieri possono diventare sbagliate oggi.
  • Le domande degli studenti possono contenere dati personali che non devono finire in un sistema AI.

Utenti e obiettivi

Studenti

Risposte rapide e affidabili, con la fonte visibile, a qualsiasi ora.

Chi supervisiona il servizio

Approvare, correggere o rifiutare le proposte dell'AI da un'unica coda, e tenere sotto controllo l'andamento.

Uffici del corso

Ricevere solo le pratiche personali e i casi non coperti, non le domande da regolamento.

  • Zero risposte inventate — ogni affermazione deve poggiare su un documento ufficiale citato.
  • Nessun dato personale degli studenti trattato dal modello.
  • Ultima parola sempre a una persona, con un flusso di approvazione sostenibile.
  • Risposte che restano corrette nel tempo, anche quando i documenti cambiano.

Il processo

  1. Analisi

    Mappatura delle domande ricorrenti e dei documenti ufficiali che le coprono, con chi segue gli studenti ogni giorno.

  2. Progettazione della pipeline

    Definizione dei cinque controlli e dei tre esiti — il cuore del sistema è il percorso della domanda, non il modello.

  3. UX/UI

    Due interfacce — la chat per gli studenti e il pannello di controllo con coda di approvazione, domande, risposte, documenti e andamento.

  4. Rilascio e tuning

    Esercizio reale con supervisione, correzione delle casistiche ricorrenti e documentazione visuale integrata.

Architettura e moduli

Il sistema è composto dalla chat studenti, dal pannello di supervisione e da un motore che tratta ogni domanda come una pratica da istruire — con controlli in ordine fisso e un esito tracciato.

Chat studenti

Interfaccia essenziale con suggerimenti, citazioni apribili e istruzioni chiare su cosa non inserire.

Da approvare

La coda delle proposte in attesa — approva, correggi o rifiuta, con la risposta e il documento affiancati.

Domande e Risposte

Archivio consultabile di ciò che è stato chiesto e della libreria di risposte approvate.

Documenti

Le fonti ufficiali monitorate dal sistema, con conferma delle nuove versioni.

Andamento

Domande ricevute, esiti, argomenti più richiesti e giudizi degli studenti.

Attività e Utenti

Tracciamento delle operazioni e gestione degli accessi.

Il flusso chiave

Cinque controlli, tre esiti

Ogni domanda attraversa cinque controlli in quest'ordine. Nessun passaggio è saltabile, e l'esito è sempre uno dei tre — tracciato.

  1. 1 · Dati personali

    Email, matricole e nomi vengono rimossi prima di qualsiasi elaborazione.

  2. 2 · Pratica personale

    Se la domanda riguarda un caso individuale, non passa dall'AI — va all'ufficio giusto.

  3. 3 · Copertura

    Se l'argomento non è nei documenti, il sistema dice che non lo sa. Non improvvisa.

  4. 4 · Documenti ufficiali

    La risposta viene scritta leggendo i regolamenti, con la citazione di ogni fonte.

  5. 5 · Verifica dei numeri

    Date, importi e crediti devono esistere nei documenti — altrimenti la risposta viene scartata.

Tre esiti possibili: Risolta (esisteva già una risposta approvata da una persona — arriva subito, senza passare dall'AI), Dai documenti (nuova proposta con citazioni, che entra nella coda di approvazione) o Rimandata (il sistema non risponde e indirizza all'ufficio competente).

Quando un documento cambia

Il punto più delicato di un sistema fondato su documenti è il tempo. Ogni giorno il sistema ricontrolla le fonti.

  1. Ricontrollo quotidiano

    Le fonti vengono riscaricate e confrontate con le versioni note.

  2. Sospensione

    Se un documento è cambiato, le risposte che ne dipendono vengono sospese automaticamente.

  3. Revalidazione

    Le risposte che superano il ricontrollo tornano attive; le altre rientrano nella coda di approvazione umana.

Funzionalità principali

Citazioni apribili

Ogni risposta mostra i documenti da cui nasce, consultabili con un click.

Approva · Correggi · Rifiuta

La supervisione è un flusso a tre bottoni — correggere una proposta la sistema e la approva in un colpo solo.

Risposte istantanee dal già-approvato

Le domande ricorrenti ricevono la risposta approvata esistente, subito e senza AI.

Andamento del servizio

Volumi, esiti, argomenti più richiesti e giudizi — il servizio si misura, non si presume.

Casistiche documentate

Le situazioni ricorrenti della supervisione sono spiegate direttamente nel pannello.

Voce e suggerimenti in chat

Domande suggerite per iniziare e input vocale per chi scrive poco volentieri.

Ricostruzione dimostrativa dell’interfaccia, con dati di fantasia.

Decisioni UX

La chat dichiara i propri limiti

Sotto l'input, sempre visibili — non inserire dati personali, le risposte non sostituiscono i documenti ufficiali. La fiducia nasce dal perimetro chiaro.

Il pannello spiega il sistema, non solo i dati

La prima sezione della supervisione è una guida visuale del funzionamento — chi supervisiona deve capire il meccanismo per fidarsi degli esiti.

Trasparenza sull'esito

Ogni domanda ha un esito esplicito e consultabile — anche il "non risponde" è un esito progettato, con l'indirizzamento giusto.

Correggere è più veloce che rifare

Il flusso di correzione trasforma la supervisione da collo di bottiglia a passaggio rapido.

Sicurezza e privacy

  • Rimozione di email, matricole e nomi prima di qualsiasi elaborazione AI.
  • Le pratiche personali non vengono mai trattate dal modello — vanno all'ufficio competente.
  • Le domande sono registrate in forma anonima per migliorare il servizio.
  • Ogni risposta pubblicata è passata da un'approvazione umana.
  • Accessi al pannello con utenze dedicate; il servizio gira su infrastruttura controllata.

Difficoltà e soluzioni

Difficoltà. I modelli linguistici tendono a produrre risposte plausibili ma non fondate.

Soluzione. Doppio vincolo — retrieval sui soli documenti ufficiali e verifica separata dei numeri. In mancanza di fondamento, il sistema preferisce non rispondere.

Difficoltà. I documenti cambiano durante l'anno accademico, silenziosamente.

Soluzione. Ricontrollo quotidiano con sospensione e revalidazione automatica delle risposte dipendenti.

Difficoltà. Gli studenti scrivono di fretta, con refusi e formulazioni molto diverse.

Soluzione. Le domande vengono normalizzate e ricondotte alle risposte approvate esistenti quando l'argomento è lo stesso.

Risultati

  • In esercizio per gli studenti del corso, con supervisione umana attiva.
  • Ogni risposta pubblicata è fondata su documenti citati e approvata da una persona.
  • Le pratiche personali e gli argomenti non coperti vengono indirizzati all'ufficio giusto invece di ricevere risposte improvvisate.

Per riservatezza non pubblico metriche di servizio; l'immagine mostra il pannello reale con il marchio dell'ateneo rimosso.

Evoluzioni possibili

  • Estensione ad altri corsi di laurea con basi documentali separate.
  • Suggerimenti proattivi sulle scadenze ricorrenti dell'anno accademico.
  • Canali aggiuntivi (widget nel sito del corso) sulla stessa pipeline.

Hai un processo che assomiglia a questo?

Raccontamelo: la prima chiamata di orientamento è senza impegno.