← Tutti gli articoli
SanadAssistenti IANote dal campo

Nessuno trova cosa c’è scritto nei contratti. Ecco come dovrebbe funzionare un assistente IA sui tuoi documenti.

Il tuo team risponde alle stesse domande tutto il giorno e le risposte sono sepolte in contratti, manuali e fatture. Perché ChatGPT non basta, e come ho costruito un assistente che cita la frase esatta o dice che non lo sa.

Reda BellasseryReda Bellassery· ·8 min di lettura
localhost:8080/ask
Il pannello delle citazioni di Sanad: la pagina del contratto si apre con la frase citata evidenziata

Punti chiave

  • Un assistente IA sui documenti risponde alle domande partendo dai contratti, manuali e fatture della tua azienda, non da internet, e mostra da dove viene ogni risposta.
  • ChatGPT da solo non basta per i documenti aziendali: non vede i tuoi file, non indica la pagina e preferisce inventare una clausola convincente piuttosto che ammettere di non sapere.
  • Un buon assistente controlla ogni citazione sul testo vero prima di mostrartela, dice “non lo trovo” quando i file non danno una risposta e passa la domanda a una persona quando non è sicuro.
  • La privacy è una scelta di progetto: i dati di ogni azienda isolati nel database, IBAN, email, telefoni e codici fiscali mascherati prima di ogni chiamata a un modello esterno, e un modello ospitato in UE come opzione.
  • Prima di costruirne uno, verifica quattro cose: i documenti sono digitali, qualcuno è responsabile delle risposte, conosci le domande che fanno le persone e lo proverai su domande vere prima del lancio.

In ufficio c’è sempre qualcuno che risponde alla stessa domanda tre volte prima di pranzo. “Con quanto preavviso possiamo disdire il contratto delle pulizie?” “Che termini di pagamento abbiamo con quel fornitore?” “Dov’è la procedura per i resi?”

Le risposte ci sono. Stanno in un contratto, in un manuale o in una fattura, da qualche parte nella cartella condivisa. Trovarle vuol dire aprire i file uno per uno, quindi si chiede al collega che si ricorda tutto.

E a volte non si ricorda nessuno. Una clausola di rinnovo automatico con 60 giorni di preavviso passa inosservata, e l’azienda paga un altro anno di un servizio che voleva disdire.

Questo articolo è per titolari e responsabili di PMI con tanti documenti e nessun ufficio legale interno. Ti spiego cos’è un assistente IA sui tuoi documenti, come dovrebbe comportarsi e cosa costa farlo bene.

Cos’è un assistente IA sui tuoi documenti?

Un assistente IA sui documenti aziendali è una chat che risponde usando solo i file della tua azienda e ti mostra la pagina da cui viene ogni risposta. Fai la domanda con parole normali. Lui trova il passaggio giusto nei contratti, nei manuali o nelle fatture e risponde da lì.

La tecnica si chiama RAG, retrieval-augmented generation. In una frase: il sistema prima cerca nei tuoi file i passaggi che corrispondono alla domanda, poi chiede al modello di IA di rispondere usando solo quei passaggi.

Tutto qui. Il modello mette la lingua. I tuoi documenti mettono i fatti.

Perché ChatGPT da solo non basta?

Perché non conosce la tua azienda e non ti avvisa quando sta tirando a indovinare. Uso ChatGPT e Claude ogni giorno e sono ottimi. Sui documenti aziendali però sbattono contro tre muri:

  1. Non hanno accesso. Non vedono i tuoi file finché qualcuno non li incolla. La maggior parte delle aziende non vuole incollare contratti e fatture in un chatbot pubblico, e fa bene.
  2. Niente citazioni. Anche quando hanno il testo, ti danno una risposta senza la pagina e la frase da cui viene. Su un contratto, una risposta che non puoi verificare vale poco.
  3. Risposte inventate. I modelli linguistici producono citazioni convincenti. Chiedi di una clausola che non esiste e potresti riceverne una che sembra proprio presa dal tuo contratto.
In un prodotto che lavora sui contratti, una sola clausola inventata distrugge la fiducia.

Perché nessuno trova cosa c’è nei documenti?

Perché i documenti aziendali sono scritti per essere firmati, non per essere cercati. La risposta a “quanto preavviso serve” di solito è una frase a pagina uno di un PDF, scritta in linguaggio legale che nessuno digita in una barra di ricerca.

La ricerca normale ha due punti ciechi. La ricerca per parole chiave perde la risposta quando le parole cambiano: tu scrivi “disdetta”, il contratto dice “comunicazione di mancato rinnovo”. La ricerca con l’IA, che cerca per significato, ha il problema opposto: gestisce male numeri di fattura, IBAN, nomi dei fornitori e numeri di clausola.

Per questo in Sanad le faccio girare entrambe in un’unica query al database e unisco i risultati. Si chiama ricerca ibrida. Sul mio set di test, la ricerca ibrida ha messo il passaggio giusto tra i primi tre risultati per tutte le domande che avevano una risposta.

Come dovrebbe comportarsi un buon assistente sui documenti?

Utile quando sa, onesto quando non sa, pronto a chiamare una persona. Sono le tre regole su cui costruisco ogni assistente:

01Ogni citazione viene controllata.

Il modello cita fonti numerate. Prima che la risposta arrivi sullo schermo, ogni citazione viene confrontata con il testo vero. Se non corrisponde viene scartata, e l’affidabilità mostrata all’utente scende.

02Sa dire “non lo so”.

Se nei tuoi file non c’è niente che sostenga una risposta, l’assistente lo dice. Una risposta vuota ti costa un minuto. Una sbagliata su una scadenza di disdetta può costarti un anno di canoni.

03Passa la palla a una persona.

Quando l’assistente non è sicuro, la domanda va a qualcuno che può rispondere. In un assistente per dipendenti o clienti, questo passaggio fa parte del progetto, non si aggiunge alla fine.

C’è un’altra regola che si dimentica spesso: anche i documenti possono attaccarti. Un’istruzione malevola può nascondersi dentro un file caricato, non solo nella domanda. Sanad controlla la domanda e ogni passaggio recuperato contro la prompt injection, cioè il testo che prova a dare nuovi ordini all’IA, prima che entri nel prompt.

Come l’ho costruito in Sanad

Sanad è un assistente IA che ho costruito per le PMI. Legge contratti e fatture di un’azienda, cita la frase esatta e non agisce mai senza approvazione. L’azienda demo è un calzaturificio immaginario di Civitanova Marche, con contratti, fatture e regolamenti in inglese, italiano e arabo.

localhost:8080/ask
Risposte con file e pagina di origine, un livello di affidabilità e una prompt injection bloccata prima di qualsiasi chiamata al modello.
Risposte con file e pagina di origine, un livello di affidabilità e una prompt injection bloccata prima di qualsiasi chiamata al modello.

Carichi i documenti una volta sola: PDF, Word o testo semplice. Un processo in background legge ogni file, lo divide in passaggi, riconosce se è un contratto, una fattura o un regolamento ed estrae i termini che contano. Poi puoi fare domande in italiano, inglese o arabo, e ogni citazione apre la pagina con la frase evidenziata.

Non volevo giudicarlo “a sensazione”. Sanad viene misurato su 44 domande di test a ogni modifica del codice, e la build fallisce se i punteggi scendono sotto le soglie:

1.00passaggio giusto tra i primi 3 (ricerca ibrida)
0.94accuratezza delle citazioni
0.80“non lo so” sulle domande senza risposta
100%tentativi di injection bloccati

Leggili con onestà. I punteggi vengono dall’ambiente di test offline, su documenti di esempio, non da un’azienda vera. Uno 0.80 sul “non lo so” è buono, non perfetto. Sanad non ha ancora clienti paganti. Il prossimo passo è un progetto pilota con una PMI vera e gli stessi test su contratti reali.

Lo stesso assistente sul telefono: fai una domanda o controlla il registro dei contratti con le scadenze di disdetta.
Lo stesso assistente sul telefono: fai una domanda o controlla il registro dei contratti con le scadenze di disdetta.
Lo stesso assistente sul telefono: fai una domanda o controlla il registro dei contratti con le scadenze di disdetta.

E la privacy?

La privacy non è una casella da spuntare alla fine. È il modo in cui il sistema è costruito fin dalla prima tabella. In Sanad vuol dire quattro cose:

  • Ogni azienda è isolata dal database. La row-level security, cioè il database che controlla chi può leggere ogni riga, è attiva su ogni tabella aziendale. Se una richiesta non indica l’azienda, le query non restituiscono niente.
  • I dati sensibili vengono mascherati. IBAN, email, numeri di telefono e codici fiscali vengono mascherati prima di ogni chiamata a un modello esterno e ripristinati nella risposta.
  • Scegli tu dove gira il modello. Lo stesso codice funziona offline, con OpenAI, con un endpoint compatibile OpenAI ospitato in UE o con Claude, e si cambia con un’impostazione.
  • Tutto viene registrato. Ogni chiamata al modello viene misurata e ogni decisione umana finisce in un registro di audit con chi ha deciso e quando.

Ora si applica anche l’AI Act europeo. Per la maggior parte degli assistenti interni sui documenti, il lato pratico è la trasparenza e tenere una persona al comando. Sono uno sviluppatore, non un avvocato: verifica il tuo caso con il tuo consulente.

Quanto costa, e cosa può andare storto?

I costi sono di due tipi: costruirlo bene una volta e pagare le chiamate al modello ogni giorno. Il primo è soprattutto controlli e test, non la finestra della chat. Il secondo si può misurare. Ecco la lista onesta:

Costo o rischioCosa significaCosa faccio
Sviluppo e testGran parte del lavoro sono controlli, isolamento e set di test, non la chatPerimetro, tempi e prezzo concordati per iscritto prima di iniziare
Uso del modelloOgni domanda, caricamento ed estrazione chiama un modelloCosto misurato per azienda e per operazione, così si vede cosa pesa
PDF scansionatiLa foto di una pagina non ha testo da cercareSanad non legge ancora le scansioni; l’OCR è nella roadmap
Citazioni perseUna risposta corretta ma parafrasata può perdere la citazioneL’affidabilità più bassa viene mostrata, non nascosta
Domande tra lingue diverseUna domanda in italiano su un contratto in inglese è più difficileIl report dei test elenca apertamente questi errori
Nuovi tipi di attaccoIl rilevamento delle injection basato su schemi va aggiornatoI tentativi bloccati mostrano gli schemi riconosciuti, così le lacune si vedono
localhost:8080/usage
Chiamate, token e costi per operazione, più il registro delle decisioni umane. La demo gira offline, quindi qui il costo è zero.
Chiamate, token e costi per operazione, più il registro delle decisioni umane. La demo gira offline, quindi qui il costo è zero.

Se la tua preoccupazione principale è il costo, ho scritto un articolo apposta su come tenere sostenibili le funzioni di IA.

La tua azienda è pronta? Una checklist

Non serve essere un’azienda tecnologica. Servono alcune basi. Controlla questa lista oggi stesso:

  1. I documenti sono digitali. PDF con testo, file Word o testo semplice. Se sono quasi tutti scansioni di carta, quello è il passo zero.
  2. Conosci le domande principali. Scrivi le venti domande che le persone fanno più spesso. Diventano il set di test.
  3. Qualcuno è responsabile delle risposte. Una persona che decide cosa è corretto e prende le domande a cui l’assistente non sa rispondere.
  4. Sai chi vede cosa. Quali documenti sono per tutti e quali solo per la direzione o l’amministrazione.
  5. Hai deciso dove possono andare i dati. Qualsiasi fornitore, solo in UE, oppure niente che esca dai tuoi server.
  6. Lo testerai prima del lancio. Sulle tue domande vere, comprese quelle a cui i documenti non rispondono.

Se ne spunti quattro su sei, sei pronto per una prima versione. Altrimenti la lista ti dice cosa sistemare prima.

Cosa fare adesso

Parti dalle domande, non dalla tecnologia. Scegli una cartella, per esempio i contratti con i fornitori, e le dieci domande che le persone fanno più spesso su quei documenti.

Se vuoi vedere come si incastrano i pezzi, il caso studio di Sanad mostra ogni schermata, i risultati dei test e i compromessi. Nella pagina dei servizi spiego come costruisco assistenti IA per le aziende. Se il passo successivo è far fare le cose all’IA, non solo rispondere, leggi come affido il lavoro a un team di IA senza perdere il controllo.

Sono a Macerata e lavoro con aziende in tutte le Marche, in Italia e in Europa. Raccontami dei tuoi documenti e delle domande a cui il tuo team risponde ogni giorno: ti rispondo con qualche domanda o una proposta per una prima chiamata. Puoi scrivermi in italiano o in inglese.

Sulle schermate: tutte le immagini vengono da Sanad in funzione sulla sua azienda demo, un calzaturificio immaginario delle Marche, catturate dallo script end-to-end del progetto.

Domande frequenti

Cos’è un assistente IA sui documenti aziendali?

È una chat che risponde usando solo i file della tua azienda, come contratti, manuali, regolamenti e fatture. Prima trova i passaggi che corrispondono alla domanda, poi scrive la risposta da quei passaggi e mostra la fonte. Questo approccio si chiama RAG, retrieval-augmented generation.

Perché non possiamo usare semplicemente ChatGPT?

ChatGPT non ha accesso ai tuoi file, a meno che qualcuno non li incolli nella chat, cosa che molte aziende non vogliono fare con contratti e fatture. Inoltre non indica la pagina esatta e, quando non sa, può dare una risposta che sembra giusta e non lo è.

Come si evita che l’assistente inventi le risposte?

In Sanad ogni citazione viene confrontata con il testo recuperato prima di arrivare sullo schermo. Le citazioni che non corrispondono vengono scartate e l’affidabilità mostrata scende. Se nessun passaggio sostiene una risposta, l’assistente lo dice invece di tirare a indovinare.

I nostri dati sono al sicuro con un assistente IA sui documenti?

Dipende da come è costruito. In Sanad i dati di ogni azienda sono isolati dal database stesso, i valori sensibili come IBAN e codici fiscali vengono mascherati prima di ogni chiamata a un modello esterno e il modello può girare su un endpoint ospitato in UE. Chiedi a qualsiasi fornitore di mostrarti come gestisce ciascuno di questi punti.

Puoi costruire un assistente sui documenti per la mia azienda?

Sì. Costruisco assistenti IA che rispondono dai tuoi documenti, dal sito o dal database, mostrano la fonte di ogni risposta e vengono testati prima del lancio. Sono a Macerata e lavoro con aziende in tutta Italia e in Europa. Scrivi a contact@stackreda.com o usa la pagina contatti.
Reda Bellassery
Reda BellasseryFondatore di VYNORO · Sviluppatore full-stack e IA a Macerata

Sviluppo agenti IA, applicazioni web e app mobile per le aziende e gestisco la mia agenzia, Barmjli. Qui scrivo di quello che costruisco e di cosa mi ha insegnato.

Continua a leggere