DocuInsight Semplifica la Firma

Eventi

15 settembre 2025: DocuInsight è stato ritirato ma ora è completamente open source su github.com/eandf/DocuInsight con documentazione su eandf.github.io/DocuInsight. Il dominio originale reindirizza lì fino al 2027.

27 gennaio 2025: DocuInsight è stato creato da Mehmet Yilmaz e Dylan Eck per il DocuSign Hackathon 2024-2025 DocuSign Hackathon Unlocked. Dai un’occhiata a www.docuinsight.ai o alla nostra demo dal vivo. Questo post si basa sulla nostra submission su Devpost.

Informazioni

DocuInsight è una piattaforma che semplifica i contratti legali evidenziando le clausole chiave, traducendole in un linguaggio semplice e integrandosi con DocuSign per le firme elettroniche, offrendo inoltre accesso a esperti legali.

DocuInsight è stato creato per risolvere la Trappola dell’Accordo, in cui dettagli contrattuali essenziali restano nascosti dietro il gergo legale, facendo sì che le persone firmino senza comprendere appieno i loro diritti o obblighi. La nostra visione è aiutare entrambe le parti di qualsiasi accordo, firmatari e mittenti, a ottenere piena chiarezza prima della firma. Inoltre, volevamo offrire un modo semplice per consentire agli utenti di connettersi con professionisti legali se necessitano di consulenza personalizzata.

Sviluppato da dicembre 2024 a gennaio 2025 per il DocuSign Hackathon, DocuInsight si integra con la tecnologia di DocuSign per importare accordi o modelli, utilizza l’API di OpenAI per l’analisi dei testi e offre un’interfaccia chat che può rispondere a domande sul contratto o fornire fonti per trovare avvocati. Crediamo che colmare questo divario di conoscenza ridurrà confusione, controversie legali e opportunità perse per tutti i soggetti coinvolti.

Dimostrazione

Ispirazione

All’inizio del 2024 ho co-fondato una startup con un caro amico. Fidandomi di lui, ho firmato i contratti iniziali della società senza esaminarli completamente. Dopo aver investito tempo ed esperienza nello sviluppo degli MVP dell’azienda senza remunerazione, il mio amico ha utilizzato la sua quota aggiuntiva per costringermi o a ridurre le mie azioni o a essere rimosso dalla società. Dopo aver trovato un avvocato, ho scoperto di aver firmato involontariamente la rinuncia a diritti importanti e che non potevo difendermi efficacemente né difendere l’azienda. A causa del comportamento egoista e spericolato del mio un tempo caro amico, la disputa mi ha messo sotto stress personale e ha fatto perdere tempo prezioso all’azienda. Questa esperienza mi ha insegnato l’importanza critica di comprendere ogni dettaglio degli accordi legali per proteggere i diritti personali e garantire la stabilità organizzativa.

Cosa fa

Le funzionalità e le caratteristiche principali di DocuInsight sono le seguenti:

Riepiloghi chiari dei contratti: DocuInsight utilizza modelli di IA avanzati per analizzare i documenti legali e generare riepiloghi concisi. Questi riepiloghi evidenziano clausole chiave, termini insoliti, potenziali rischi e impegni principali, fornendo agli utenti una panoramica chiara e comprensibile del contratto.
Interfaccia chat interattiva: La funzionalità di chat alimentata dall’IA permette agli utenti di “parlare” con il proprio contratto. Possono porre domande su clausole specifiche, sullo scopo generale dell’accordo o su concetti legali correlati. Il chatbot può anche navigare sul web per fornire informazioni ben documentate, accurate e aggiornate, assicurando agli utenti risposte affidabili.
Raccomandazioni di avvocati: Per gli utenti che cercano assistenza legale aggiuntiva, DocuInsight genera query di ricerca ottimizzate per raccomandare avvocati in base alla posizione dell’utente e al tipo di contratto che stanno esaminando. I risultati della ricerca includono dettagli di contatto e recensioni dei professionisti legali, offrendo agli utenti un modo concreto per entrare in contatto con esperti.
Processo di firma migliorato: DocuInsight si integra perfettamente con il flusso di firma esistente di DocuSign. Gli utenti effettuano il login con la loro email, collegano il proprio account DocuSign per accedere ai modelli e inviano i documenti per la firma. Una volta inviato, il destinatario può rivedere il documento, interagire con gli approfondimenti generati dall’IA e firmare come farebbe all’interno della piattaforma standard di DocuSign.
Accesso post-firma: Dopo la firma, gli utenti possono rivisitare il loro documento tramite il link originale per esaminare l’accordo firmato, accedere agli approfondimenti dell’IA e continuare a interagire con l’interfaccia chat per domande di follow-up. Questo garantisce ai firmatari una chiarezza continua sui loro accordi.

Queste funzionalità rendono DocuInsight uno strumento potente per semplificare le complessità dei contratti legali. Combinando approfondimenti guidati dall’IA, supporto interattivo e integrazione fluida con DocuSign, DocuInsight permette ai firmatari di prendere decisioni informate, assiste i mittenti nel costruire fiducia negli accordi che distribuiscono e fornisce ai professionisti legali opportunità per connettersi con utenti che cercano assistenza aggiuntiva. Il nostro obiettivo è promuovere trasparenza, fiducia e accessibilità nel processo di stipula degli accordi, rendendo il testo legale più facile da comprendere e più equo per tutti.

Se vuoi vedere un video chiaro di noi che usiamo DocuInsight e dimostriamo le sue funzionalità in modo evidente, dai un’occhiata a questo video aggiuntivo che abbiamo realizzato (questo NON è il nostro video demo, solo una risorsa aggiuntiva se le persone vogliono più dettagli):

Come l’abbiamo costruito

DocuInsight è composto da tre parti principali:

Database: Memorizza tutti i job, i report, i dati degli utenti, ecc. Contiene i dati richiesti dal progetto.
Frontend: L’interfaccia utente del progetto, ciò che gli utenti vedono e con cui interagiscono.
Analizzatore: Un servizio backend responsabile dell’analisi dei contratti legali e dell’invio di email.

Per questo progetto è stato utilizzato un database. Il database era PostgreSQL ed è stato ospitato su Supabase. Sia il Frontend sia l’Analizzatore hanno accesso al database usando l’API di Supabase attraverso i loro SDK. La configurazione del database consisteva in tre tabelle: una per gli utenti, una per i job e una per i report. La tabella utenti è utilizzata per l’autenticazione e per tenere traccia degli account. La tabella job tiene traccia dei contratti che devono essere analizzati. La tabella report memorizza tutti i report sui contratti generati dall’Analizzatore.

Il Frontend è stato costruito usando un framework frontend chiamato Next.js. In questo framework abbiamo utilizzato HTML, Tailwind CSS, JavaScript, TypeScript e React. Queste tecnologie hanno permesso al frontend di funzionare e mostrare contenuti in modo dinamico e reattivo. Inoltre, abbiamo utilizzato diverse API nel frontend:

OpenAI’s API: Per ospitare e far funzionare il chatbot per ogni sessione di firma.
DocuSign’s API: In particolare, l’API eSignature è stata utilizzata per gestire tutti i processi di firma e fornire un facile accesso ai modelli degli utenti dai loro account DocuSign su DocuInsight.
Tavily API: Un motore di ricerca specializzato progettato per LLM, che permette al chatbot di navigare sul web e recuperare le ultime notizie o aggiornamenti.
Resend API: Utilizzata per gestire tutte le attività relative alle email, principalmente per i processi di login sul frontend.
Supabase API: Ha accesso al database del progetto ospitato su Supabase per eseguire operazioni CRUD.

Il frontend è completamente ospitato su Vercel, un servizio di hosting sviluppato dai creatori del framework Next.js.

L’Analizzatore è stato sviluppato utilizzando Python. Usa l’API di OpenAI per analizzare i contratti legali usando uno dei modelli più avanzati di OpenAI, o1-preview. Utilizza anche la Resend API per inviare email, principalmente per inviare una ricevuta o l’email richiesta per la firma di un contratto su DocuInsight. L’Analizzatore supporta webhook di Discord, permettendo agli utenti di ricevere avvisi se qualcosa di critico si interrompe o si verifica mentre l’Analizzatore è in esecuzione. Come il resto del progetto, l’Analizzatore ha utilizzato Supabase per accedere al database del progetto.

Il codice dell’Analizzatore incorpora pacchetti come PyMuPDF, openpyxl, python-docx e il modello o1-preview di OpenAI: per caricare il contenuto di vari tipi di file, inclusi PDF, DOCX, DOC, JPG e PNG.

L’Analizzatore è ospitato su un’istanza Linode con almeno 4 GB di RAM, eseguendo Ubuntu come sistema operativo.

Sfide che abbiamo incontrato

Costruire DocuInsight è stato pieno di sfide tecniche e pratiche. Abbiamo dovuto capire come implementare un’autenticazione sicura che si collegasse senza problemi al nostro database garantendo al contempo la protezione dei dati degli utenti. Capire quali parti dell’API di DocuSign usare per la funzionalità desiderata ha richiesto molti tentativi ed errori. Strutturare il frontend per fornire una buona esperienza utente e integrare funzionalità avanzate come quelle LLM nel processo di firma esistente di DocuSign è stato altrettanto difficile da realizzare correttamente. Trasmettere dati in tempo reale dal server al client per l’interfaccia chat è stata una sfida, così come trovare un modo per raccomandare avvocati, dato che non esiste un dataset facilmente accessibile o economico per i professionisti legali tramite un’API. Abbiamo dovuto costruire una logica di navigazione web per il chatbot per ridurre al minimo le allucinazioni e rendere le sue risposte più affidabili. Infine, rendere il progetto pronto per la produzione è stata la parte più difficile. Una cosa è costruire e far funzionare qualcosa localmente per una demo, ma è una sfida completamente diversa distribuirlo sul web con alta disponibilità e affidabilità affinché chiunque possa accedervi. Un singolo guasto in produzione potrebbe lasciare una cattiva impressione, quindi garantire la stabilità è stato cruciale e estremamente difficile.

Risultati di cui siamo orgogliosi

Siamo orgogliosi di aver distribuito con successo DocuInsight e di averlo reso accessibile a chiunque. Creare un’applicazione pronta per la produzione che si integri perfettamente con DocuSign, gestisca l’uso nel mondo reale e fornisca approfondimenti affidabili alimentati dall’IA è stato un risultato significativo. Una cosa è costruire localmente per una demo, ma garantire che tutto funzioni in un ambiente live con elevata disponibilità è stata una sfida che siamo orgogliosi di aver superato.

Cosa abbiamo imparato

Durante questo progetto, ci siamo resi conto che costruire una soluzione come DocuInsight era molto più complesso di quanto avessimo inizialmente previsto. Analizzare documenti legali, garantire l’accuratezza e bilanciare le capacità dell’IA con l’accessibilità economica ha richiesto una riflessione attenta e una iterazione costante. Abbiamo anche imparato l’importanza di una corretta produzione video. Per assicurarci che la nostra demo comunicasse efficacemente il valore del progetto, abbiamo iniziato a lavorare sul video due settimane prima della scadenza, utilizzando attrezzature cinematografiche professionali per offrire un prodotto finale rifinito. Inoltre, scalare progetti come questo ha presentato sfide uniche. Chiamare modelli di IA avanzati per analizzare contenuti è computazionalmente costoso, quindi abbiamo dovuto bilanciare attentamente l’uso dei modelli più intelligenti con la necessità di rendere la soluzione conveniente. Infine, abbiamo condotto una ricerca di mercato di base navigando sul web, parlando con potenziali utenti e consultando avvocati per assicurarci che DocuInsight potesse offrire un valore reale. Questo processo ci ha insegnato che costruire qualcosa di significativo richiede di convalidarne l’impatto piuttosto che creare semplicemente una soluzione per il gusto di farlo.

Prossimi passi per DocuInsight

Prevediamo di espandere DocuInsight sviluppando agenti di intelligenza artificiale più avanzati per un’analisi più profonda dei contratti, perfezionando set di dati vettorializzati per ottenere migliori approfondimenti e creando un repertorio più completo di avvocati per mettere in contatto firmatari e aziende con professionisti legali della loro zona. Le caratteristiche future includono strumenti come una ricerca di casi della SEC per fare riferimento a precedenti legali. Il nostro obiettivo è offrire ancora più valore a firmatari, mittenti e aziende, promuovendo al contempo fiducia e trasparenza negli accordi.