Oggi ti voglio parlare di un esperimento che ho fatto in questi giorni di conversione di una mia mappa mentale in un documento, fatto e finito attraverso l’IA (lo trovi in fondo all’articolo).

1. Premessa

Il 4 Aprile ho tenuto una OfficeHour su come Scrivere documenti giuridici in modo chiaro. Come tutti i miei webinar parto dalla predisposizione di una mappa mentale e che vedi raffigurata qui sotto.

*La mappa mentale che ho preparato per la mia OfficeHour*

2. Convertire la mappa mentale in Markdown

Da sempre utilizzo MindNode come applicazione per creare le mappe mentali (sia su macOS che su iOS – al riguardo ti segnalo che sono anche loro beta-tester).

Tra le varie funzioni che offre il programma c’è quella di convertire una mappa mentale in un file Markdown.

Per fare ciò occorre andare nelle funzioni di condivisione del programma (punto 1 immagine sottostante) e scegliere il formato voluto (nel mio caso markdown - punto 2).

*Esportazione della mappa mentale in markdown*

Si aprirà quindi finestra di dialogo con alcune opzioni, a me non interessava includere le immagini, quindi ho premuto il tasto Esporta… ed ho salvato il file nella cartelle da me scelta.

3. Prompt di generazione

Il risultato è un file markdown che ho dovuto un minimo massaggiare (più che altro perché oltre ai contenuti nella mappa mentale avevo inserito degli appunti per me su come realizzare le slides).

Fatto ciò, sono passato quindi alla fase generativa.

Di seguito vedi il prompt che ho utilizzato (usando Ollama e Mixtral) ed il tempo che ci ha messo sul mio nuovo MacStudio M1 (maggiori info in un futuro articolo).

*Il prompt che ho usato per la creazione del documento dalla mappa mentale*

Questo il testo del prompt (se ti interessa):

Utilizzando la scaletta che segue, sviluppa una testo dettagliato da poter leggere ad alta voce, deve essere di impatto e fornire esempi utili in base ai consigli individuati nella scaletta, formatta il documento in markdown utilizzando grassetto e corsivo per sottolineare i concetti più importanti:

Qui trovi invece il file MD che gli ho passato se lo vuoi visionare.

La particolarità del prompt, rispetto a quanto ho già spiegato qui è che ho utilizzato la funzione client / server di Ollama; ovvero ho lanciato il prompt dal mio iMac 5k sul MacStudio (la prima parte del prompt OLLAMA_HOST=http://192.168.1.125:11434) e poi gli ho passato il testo in markdown della mappa mentale (con la parte finale del prompt $(cat "nome del file.md")). Ho in programma di scrivere un articolo più dettagliato al riguardo, qui trovi la documentazione di Ollama su come passare un file nel prompt, se sei impaziente, e qui come collegarsi dal client al server.

In circa 2 minuti mi è stato restituito il file che puoi leggere qui sotto.

Piccola nota: Mixtral è un modello più potente di Mistral, ed ho dovuto fare una serie di personalizzazioni per farlo andare “così veloce”, così come il MacStudio M1 con 32 Gb di Ram è molto più potente del mio MacMini M1 con 8Gb.

4. Modello locale vs modello remoto

L’esperimento che ti ho documentato l’ho fatto in locale prevalentemente per vedere le capacità di Mixtral ottimizzato per il mio MacStudio M1 (di fatto è una versione quantizzata a 3 bit – maggiori info in un futuro articolo). Credo che il risultato non sia male, posto che il testo che puoi leggere qui sotto è venuto decisamente bene ed è proprio quello generato dall’LLM senza alcun mio intervento.

Avrei sicuramente potuto fare la stessa cosa (forse addirittura meglio) con chatGPT 4. Ma credo che questo piccolo esperimento dimostri cosa è già possibile fare con strumenti open-source e direttamente in locale.

Avrei scritto un atto con questo sistema? Ne dubito.

Come dicevo altrove i limiti nel mondo legale italiani degli LLM c.d. generalisti sono notevoli. Sicuramente, quando mi si presenterà l’occasione, proverò a testare questo sistema per avere eventualmente una prima bozza di un atto, ma non ho molte speranze.

In conclusione

Spero che questo breve articolo ti abbia mostrato le possibilità e lo stato dell’arte di che cosa sia possibile fare in locale con un LLM di medie dimensioni.

A conclusione dell’articolo trovi il testo completo e, se sei interessato all’argomento, qui puoi vedere la mia OfficeHour.

Come sempre se ti è piaciuto quel che hai letto o visto e non l’hai già fatto ti suggerisco di iscriverti alla mia newsletter. Ti avvertirò dei nuovi articoli che pubblico (oltre ai podcast e video su YouTube) e, mensilmente, ti segnalerò articoli che ho raccolto nel corso del mese ed ho ritenuto interessanti.

Scrivere i documenti giuridici in modo chiaro: Consigli di Brian Garner

Scrivere in maniera chiara e semplice non è solo un'abilità utile nella vita di tutti i giorni, ma è anche fondamentale nello scrivere documenti legali. Un linguaggio chiaro ed efficace può fare la differenza tra una vittoria e una sconfitta in tribunale. Brian Garner, uno dei più grandi esperti di scrittura legale, offre alcuni consigli preziosi su come scrivere documenti giuridici in modo chiaro ed incisivo.

Struttura il tuo pensiero

Prima di iniziare a scrivere, è importante avere qualcosa da dire e averci ragionato su. La fase di studio e ricerca è quindi fondamentale per comprendere a fondo l'argomento e formulare un pensiero chiaro. Una volta che hai acquisito una buona conoscenza dell'argomento, puoi iniziare a pianificare i tuoi scritti. Prova ad utilizzare una outline non lineare, come ad esempio una mappa mentale. Questo ti aiuterà a organizzare il pensiero in modo visivo e a de-costruire il pensiero o ragionamento altrui.

Una volta che hai una bozza della struttura del documento, puoi iniziare a ordinare il materiale in una sequenza logica. Se stai descrivendo una serie di fatti, potrebbe essere utile ordinarli in modo cronologico. Inoltre, tieni vicino il materiale collegato per evitare ripetizioni e assicurarti che il documento sia coerente.

Per rendere il documento più facile da leggere, dividilo in sezioni e sottosezioni. Usa dei titoli informativi e descrittivi per ciascuna sezione, in modo da aiutare il lettore a capire di cosa tratta ogni parte del documento. Infine, crea un indice navigabile dell'atto, in modo che il lettore possa trovare facilmente le informazioni di cui ha bisogno.

Strutturare le tue frasi

Le frasi brevi sono più facili da leggere e comprendere rispetto a quelle lunghe e complesse. Prova a scrivere frasi con non più di 30/40 parole, utilizzando la voce attiva piuttosto che quella passiva. In questo modo, il documento sarà più chiaro e assertivo.

Evita le parole inutili e preferisci l'uso di frasi parallele per esprimere idee simili. Evita anche negazioni multiple e conclusioni deboli. Infine, concludi la frase in modo enfatico, utilizzando parole o frasi che attirino l'attenzione del lettore.

Prevedere obiezioni e contro argomenti

Se vuoi scrivere in modo convincente, devi essere in grado di prevedere le possibili obiezioni e contro argomenti alla tua tesi. Pensa alle migliori obiezioni che il lettore potrebbe avere, e poi rispondi direttamente a quelle obiezioni nel documento. In questo modo, sarai in grado di dimostrare la validità della tua argomentazione e convincere il lettore a tuo favore.

Scrivi per un lettore ordinario

Quando scrivi un documento legale, è importante scrivere per un lettore ordinario, che potrebbe non avere una conoscenza approfondita dell'argomento. Evita l'uso di termini tecnici complessi e preferisci un linguaggio semplice e chiaro. In questo modo, il documento sarà più accessibile e facile da comprendere per il lettore.

Organizza le tue argomentazioni in ordine di importanza

Quando presenti le tue argomentazioni, è importante organizzarle in ordine di importanza. In questo modo, il lettore sarà in grado di capire immediatamente qual è l'argomento più forte e più convincente. Inoltre, se hai poco spazio a disposizione, potrai concentrarti sui punti più importanti e lasciare i dettagli secondari per una lettura successiva.

Scrivere significa anche presentare il testo

Infine, ricorda che scrivere un documento legale non significa solo presentare il testo, ma anche renderlo visivamente accattivante e facile da leggere. Utilizza una tipografia chiara e semplice, con un font di dimensioni adeguate e un'adeguata spaziatura tra le righe. Inoltre, evita l'uso di paragrafi troppo lunghi o blocchi di testo troppo grandi, che possono rendere il documento difficile da leggere.

Conclusione

Scrivere in maniera chiara e semplice è una skill importante nello scrivere documenti legali. Utilizzando i consigli di Brian Garner, sarai in grado di creare documenti efficaci e convincenti, che ti aiuteranno a vincere le tue cause in tribunale. Ricorda di strutturare il tuo pensiero, utilizzare frasi brevi e semplici, prevedere obiezioni e contro argomenti, scrivere per un lettore ordinario, organizzare le tue argomentazioni in ordine di importanza, e presentare il testo in maniera visivamente accattivante. Con un po' di pratica e dedizione, sarai in grado di padroneggiare l'arte della scrittura legale chiara ed efficace.