Vai al contenuto

Istruzioni per l’uso in dialogo: tre ruoli IA scrivono, comprovano e verificano le Sue istruzioni

Tutti gli screenshot provengono dall’applicazione in esecuzione (interfaccia in inglese), progetto dimostrativo pressa imballatrice BP-200

Le istruzioni per l’uso secondo l’allegato I, punto 1.7.4, della direttiva macchine non sono prosa che si fa scrivere «al volo» a un chatbot. Fanno parte delle evidenze di conformità; ogni numero che contengono ha delle conseguenze. Le istruzioni per l’uso in dialogo risolvono il problema con tre ruoli: un curatore tiene aggiornata la scheda informativa a partire dai dati del Suo progetto, un autore scrive in modo visibile nel documento, un revisore segnala tutto ciò che non è comprovato. Questo articolo mostra, con una sessione reale, che aspetto ha tutto questo, dove sta il grande vantaggio e dove stanno i limiti.

Perché un chatbot non dovrebbe scrivere le istruzioni per l’uso

La tentazione è ovvia: incollare la descrizione della macchina in un modello linguistico, «Scrivimi il capitolo 3, dati tecnici», e in pochi secondi si ha un testo scorrevole. Il problema non è lo stile ma la provenienza. Un modello generico non conosce la Sua macchina. Conosce migliaia di istruzioni per l’uso e aggiunge ciò che di solito vi compare: 400 V, 50 Hz, un livello di pressione sonora inferiore a 70 dB(A), manutenzione ogni 500 ore di funzionamento. Plausibile, pronto per la stampa e magari sbagliato per la Sua macchina.

L’allegato I, punto 1.7.4.2, prescrive il contenuto delle istruzioni per l’uso, dall’uso previsto ai rischi residui fino alle informazioni sull’emissione di rumore. Questo contenuto deve coincidere con la valutazione del rischio e con la dichiarazione di conformità, altrimenti il fascicolo tecnico si contraddice. Nei testi IA scritti liberamente ricorrono tre schemi di errore:

  • Numeri inventati. Valori che non compaiono in nessun punto del progetto ma suonano così ovvi da superare la revisione.
  • Capitoli sulla sicurezza generici. Avvertenze da manuale invece dei rischi residui che la Sua valutazione del rischio individua davvero.
  • Nessuna tracciabilità. Nessuno può dire in seguito da dove provenga una frase, se corrisponda ancora allo stato attuale della valutazione del rischio e chi l’abbia verificata.

Tre ruoli invece di un solo chatbot

Le istruzioni per l’uso in dialogo separano il sapere, lo scrivere e il verificare. Tutti e tre i ruoli lavorano sulla stessa scheda informativa e nessuno può scavalcare un altro: l’autore può scrivere solo ciò che il curatore ha comprovato, e il revisore lo segnala se lo fa comunque. I ruoli girano su modelli Claude di Anthropic, l’autore sul più potente, curatore e revisore di sezione su modelli veloci.

RuoloCompitoChe cosa ne vede
CuratoreCostruisce la scheda informativa a partire da progetto, valutazione del rischio, lista di controllo delle norme, dichiarazione di conformità, valori di prova e funzioni di sicurezza. Ogni fatto riporta la propria fonte e la data. 14 regole sulle lacune individuano ciò che manca ancora; le contraddizioni tra i Suoi dati e la banca dati vengono segnalate.Tab «Scheda informativa» con contatore, categorie, origine di ogni fatto, lacune aperte.
AutoreScrive nel documento esclusivamente tramite strumenti: scrivere una sezione, inserire una tabella, impostare un’avvertenza, redigere un capitolo. Prima legge ciò che c’è già. Se manca un dato, lo chiede oppure inserisce un segnaposto con nome. Non ipotizza.Chip degli strumenti per ogni ciclo, la sezione prende forma in tempo reale nel documento, domande con campi di risposta.
Revisore21 regole di verifica fisse con il relativo riferimento nell’allegato I, più una verifica IA di ogni nuova sezione rispetto alla scheda informativa: numeri non comprovati, norme inventate, affermazioni di conformità, avvertenze prive della struttura in tre parti.Tab «Revisore» con rilievi rossi, gialli e informativi, ciascun rilievo anche direttamente sotto la sezione interessata.

Come si svolge una sessione

La vista è volutamente costruita come una conversazione: a sinistra la cronologia con il campo di immissione in basso, a destra il documento con i tab Documento, Scheda informativa e Revisore. Il pannello può essere ridotto, come la barra laterale dell’applicazione. Gli screenshot seguenti provengono da una sessione reale con il progetto dimostrativo, una pressa imballatrice idraulica.

1. Impartire un’istruzione

Basta una frase, oppure una delle schede suggerimento. In alto a destra nel documento si vede già che cosa la scheda informativa sa del progetto; il contatore nel campo di immissione indica quanti dati sono ancora aperti.

Vista iniziale delle istruzioni per l’uso in dialogo: a sinistra la domanda «Che cosa devono contenere le istruzioni per l’uso?» con campo di immissione e quattro schede suggerimento, a destra il documento con i capitoli 1 e 2 della pressa imballatrice BP-200
Vista iniziale: a sinistra l’istruzione all’autore con le schede suggerimento, a destra il documento. Il contatore «10 dati mancanti» mostra ciò che la scheda informativa non conosce ancora.

2. L’autore legge e scrive in modo visibile

Prima di ogni modifica l’autore legge la sezione esistente. Poi il nuovo testo prende forma in tempo reale nel documento a destra, parola per parola, con l’avviso «L’autore sta scrivendo». Ogni ciclo può essere annullato con «Interrompi».

L’autore al lavoro: a sinistra l’istruzione «Riscrivi la sezione Uso previsto nel capitolo 2», in basso a sinistra il pulsante Interrompi, a destra il documento
Dopo l’istruzione l’autore lavora in modo visibile. La sezione scritta compare nel documento a destra mentre viene scritta; ogni ciclo può essere interrotto.

3. Strumenti, risposta, verifica

Dopo il ciclo, dei chip mostrano quali strumenti ha usato l’autore. La sua risposta nella chat resta breve: che cosa ha fatto, che cosa è ancora aperto, quale decisione Lei deve prendere. Il testo del capitolo non viene mai ripetuto nella chat; sta nel documento. In background il revisore passa in rassegna la nuova sezione.

Ciclo concluso: i chip degli strumenti «legge la sezione: Sicurezza / 2.1» e «scrive la sezione: Sicurezza / 2.1», sotto la breve risposta dell’autore, a destra la nuova sezione 2.1 nel documento
Ogni ciclo mostra che cosa ha fatto l’autore: prima leggere, poi scrivere. La risposta nella chat resta breve; il testo sta nel documento.

Provi in prima persona: una sessione in 90 secondi

La demo riproduce una sessione con testi di esempio fissi, senza richiesta all’IA e senza registrazione. Risponda alla domanda, poi selezioni una frase nel documento per richiedere una modifica in un punto preciso. Nell’applicazione l’autore scrive a partire dai dati del Suo progetto.

Pressa imballatrice idraulica BP-200 · direttiva macchine 2006/42/CE · sessione simulata, nessuna richiesta all’IA
2 Sicurezza
2.1 Uso previsto
La macchina è destinata alla compattazione di cartone e pellicole. Non devono essere lavorati altri materiali.
2.2 Uso scorretto ragionevolmente prevedibile

Intervento nella camera di pressatura con corsa in atto, aggiramento della porta di carico interbloccata …

Domande invece di congetture

La differenza più importante rispetto a un chatbot emerge quando manca qualcosa. Per la tabella «Dati tecnici», la scheda informativa della pressa imballatrice conosce dalla valutazione del rischio pressione di esercizio, forza di pressatura e peso della balla, ma non la massa totale, né le dimensioni, né i valori di collegamento elettrico. L’autore crea la tabella con i valori comprovati e per il resto pone fino a tre domande concrete con campi di risposta.

Domande dell’autore con tre campi di risposta: massa totale, dimensioni e valori di collegamento elettrico, sotto i pulsanti «Invia risposte» e «Più tardi»
Se mancano dati, l’autore chiede invece di ipotizzare. Le domande arrivano con campi di risposta; ogni risposta diventa un fatto comprovato.

Le Sue risposte non finiscono nella cronologia come testo sciolto; diventano fatti contrassegnati come «Informazione fornita». Nel ciclo successivo l’autore le usa direttamente, qui per la tabella del capitolo 3.

Domande con risposta nella cronologia e risposta dell’autore: i tre valori sono stati aggiunti al capitolo 3 sotto forma di tabella
Le risposte finiscono nella scheda informativa e subito nella tabella «Dati tecnici» del capitolo 3. L’autore chiede se debba unire le due tabelle.

La scheda informativa può essere consultata in qualsiasi momento. È la base su cui lavora l’autore e rispetto alla quale verifica il revisore: i fatti per categoria, ciascuno con origine e data, più le lacune aperte. Se un dato della conversazione contraddice la banca dati, il fatto viene segnalato come contraddizione e l’autore chiede anziché decidere.

Tab Scheda informativa: versione e numero di fatti, lacune aperte, categorie come Dati tecnici con valori e origine; i dati provenienti dal dialogo sono contrassegnati come «Informazione fornita»
La scheda informativa del curatore: in alto le lacune aperte, sotto i fatti per categoria, ciascuno con origine e data. I dati forniti nella conversazione sono contrassegnati come «Informazione fornita»; le contraddizioni con la banca dati vengono segnalate.

Se preferisce colmare le lacune in un colpo solo, il contatore nel campo di immissione apre il modulo «Rispondere alle voci aperte». Ciò che inserisce viene recepito come fatto comprovato senza passare per un modello. Ciò che non sa resta vuoto; in quei punti il testo riceve un segnaposto con nome che il revisore segnala fino all’approvazione.

Modulo «Rispondere alle voci aperte» sopra il campo di immissione con domande su condizioni ambientali, punti di sollevamento, fondazione e dispositivi di comando, contatore «0 di 7 risposte»
Tutti i dati aperti a colpo d’occhio: ciò che inserisce qui confluisce nella scheda informativa come fatto comprovato. Ciò che non sa resta vuoto.

Il revisore: l’allegato I come regola di verifica

Il revisore lavora su due livelli. 21 regole di verifica fisse vengono eseguite a ogni modifica, senza modello, con il relativo riferimento nell’allegato I. Inoltre una IA verifica ogni sezione appena scritta rispetto alla scheda informativa: numeri senza evidenza, norme che non figurano nella lista di controllo delle norme, affermazioni di conformità che non provengono dalla dichiarazione. Esempi delle regole fisse:

  • capitolo obbligatorio secondo l’allegato I, punto 1.7.4.2, vuoto o nascosto
  • segnaposto aperti nel testo («[inserire la massa totale indicata dal fabbricante]»)
  • avvertenza priva delle tre parti: tipo e fonte del pericolo, conseguenze e rimedio
  • nessuna sezione sulla ricerca guasti (allegato I, punto 1.7.4.2, lettere r) e s))
  • figura senza didascalia, tabella senza titolo o riga d’intestazione, rimando senza destinazione
  • Markdown o titoli duplicati che comprometterebbero l’esportazione
  • capitoli i cui dati di progetto sono cambiati dopo la loro stesura
  • pericoli con un rischio residuo elevato e non accettato non trattati nel capitolo sulla sicurezza

Ogni rilievo compare nel tab Revisore e direttamente sotto la sezione interessata. «Fai correggere» lo trasforma in un’istruzione per l’autore. «Ignora» richiede una motivazione che viene registrata nel progetto, in modo che resti rintracciabile in seguito perché un’osservazione non sia stata deliberatamente recepita.

Tab Revisore con tre rilievi: due regole di verifica rosse L01 per i capitoli obbligatori vuoti Montaggio e Manutenzione, una regola di verifica gialla L14 per la sezione mancante sulla ricerca guasti
Per ogni rilievo il revisore indica il riferimento nell’allegato I. I rilievi rossi riguardano contenuti obbligatori, quelli gialli la forma. Ogni rilievo può essere fatto correggere o ignorato con una motivazione.

Evidenziare, far modificare, proseguire

La maggior parte delle modifiche alle istruzioni per l’uso è piccola: una frase troppo lunga, un elenco al posto di un paragrafo, un’avvertenza mancante. Per queste si evidenzia il passaggio nel documento. Alla posizione del mouse compare «Modifica nel dialogo», il passaggio si sposta nel campo di immissione come citazione e si scrive che cosa deve essere diverso. L’autore legge la sezione, modifica solo il passaggio evidenziato e lascia il resto parola per parola.

Frase evidenziata nella sezione 2.1 del documento; alla posizione del mouse compare il pulsante «Modifica nel dialogo»
Evidenziare il testo nel documento, fare clic su «Modifica nel dialogo»: il passaggio si sposta nel campo di immissione come citazione.
Campo di immissione con la scheda di citazione «Passaggio evidenziato · 2 Sicurezza / Uso previsto» e l’istruzione «Riformula questo passaggio come elenco puntato con una frase per voce»
L’istruzione si riferisce esattamente al passaggio evidenziato. L’autore legge la sezione, modifica solo questo passaggio e lascia il resto parola per parola.

Per tutto ciò che nessun modello linguistico dovrebbe fare, ogni capitolo ha il pulsante «Modifica»: testo proprio, immagini con didascalia, tabelle (anche incollate da un foglio di calcolo), i dati di intestazione del frontespizio con immagine di copertina e la scelta se figure e tabelle vengano numerate in sequenza continua o per capitolo. La struttura vera e propria, cioè i capitoli propri e il loro ordine, si trova nell’editor avanzato.

Che cosa si ottiene alla fine

L’esportazione in PDF o Word contiene i dodici capitoli secondo l’allegato I, punto 1.7.4, con indice, indice delle figure e indice delle tabelle. Tutte le tabelle sono numerate, comprese quelle che il documento genera dal progetto: il quadro dei rischi residui dalla valutazione del rischio, le norme armonizzate applicate e le evidenze della valutazione del rischio. I rimandi come «vedi tabella 3» vengono risolti all’esportazione; le avvertenze compaiono con parola di segnalazione, fonte del pericolo, conseguenze e rimedio.

Menu di esportazione aperto con «Stampa come PDF», «Come file Word» e «Editor avanzato (struttura)»
Esportazione in qualsiasi momento in PDF o Word, con indice, indice delle figure e indice delle tabelle. L’editor avanzato resta disponibile per la struttura e per la compilazione in blocco.

Che aspetto abbia un’esportazione completa della stessa macchina lo mostrano le istruzioni per l’uso di esempio di 123 pagine in PDF, senza registrazione. Il PDF di esempio è in inglese; la piattaforma redige le istruzioni in tedesco o in inglese.

Il vero vantaggio

Molti strumenti sanno scrivere più in fretta. La differenza sta in ciò che bisogna verificare dopo. Con un testo IA scritto liberamente si controlla ogni frase per capirne la provenienza. Con le istruzioni per l’uso in dialogo si controllano una scheda informativa e un elenco di rilievi.

Ogni affermazione ha una fonte

L’autore può usare solo ciò che si trova nella scheda informativa o ciò che Lei gli comunica. La scheda informativa indica la fonte di ogni fatto, ad esempio «valutazione del rischio, limiti della macchina» oppure «Informazione fornita». Lei verifica le fonti, non la prosa.

Le lacune diventano domande, non testo

Un modello linguistico generico colma una potenza allacciata mancante con un valore plausibile. L’autore invece pone la domanda, e la Sua risposta compare poi comprovata nella scheda informativa e nel capitolo.

Il documento resta legato alla valutazione del rischio

I rischi residui e le norme applicate arrivano come tabelle numerate direttamente dal progetto. Se la valutazione del rischio cambia, il revisore segnala come superati i capitoli interessati, e basta un’istruzione per aggiornarli.

Vede ogni passaggio e ha sempre il documento in mano

Nulla entra nelle istruzioni senza una Sua istruzione. Ogni chiamata a uno strumento è visibile, ogni ciclo può essere interrotto, ogni capitolo resta modificabile a mano, con figure e tabelle proprie.

Che cosa il dialogo non fa

Un documento che sembra completo alimenta presto l’aspettativa «è tutto fatto». Per questo il limite ne fa parte:

  • La verifica da parte di un esperto e l’approvazione. Ogni testo è una bozza ricavata dai dati del Suo progetto, di cui Lei, in quanto fabbricante, è responsabile.
  • I valori della progettazione che non sono nel progetto. Al posto di numeri ipotizzati, l’autore inserisce segnaposto con nome oppure pone una domanda.
  • Le figure della macchina. Le immagini le carica Lei; didascalie e numerazione sono gestite dal documento.
  • Le traduzioni in altre lingue ufficiali e l’indicazione come traduzione.
  • Le affermazioni di conformità che non siano riprese testualmente dalla dichiarazione di conformità del progetto.

Disponibilità e prezzo

Le istruzioni per l’uso in dialogo sono un modulo aggiuntivo dei piani Professional e Business e si sbloccano una volta per progetto a 12,99 €, senza canone ricorrente. La quota di uso corretto è di 100 cicli di dialogo al mese nel piano Professional e di 200 nel piano Business, condivisi nel team. Un ciclo è un’istruzione con tutte le chiamate agli strumenti che le appartengono. La modifica manuale e l’esportazione sono illimitate. I progetti che hanno già sbloccato le istruzioni per l’uso usano il dialogo senza costi aggiuntivi. La cronologia della conversazione viene salvata con il progetto; i dettagli sono nell’informativa sulla privacy.

FAQ

Domande frequenti sulle istruzioni per l’uso in dialogo

L’autore IA inventa valori quando qualcosa manca?
No, ed è questo il cuore della modalità. Le uniche fonti ammesse per le affermazioni specifiche della macchina sono la scheda informativa e il Suo messaggio attuale. Se manca un dato, l’autore pone una domanda con un campo di risposta oppure inserisce un segnaposto con nome. Inoltre il revisore segnala ogni numero e ogni norma che non sia comprovata nella scheda informativa.
Come faccio a sapere da dove proviene un’affermazione del testo?
Nel tab «Scheda informativa» ogni fatto mostra la propria origine con la data, ad esempio «valutazione del rischio, pericolo n. 3» o «dichiarazione di conformità». I dati forniti nella conversazione sono contrassegnati come «Informazione fornita» o «dal dialogo». Le contraddizioni tra un dato della conversazione e la banca dati vengono segnalate, e l’autore chiede anziché decidere.
Posso scrivere io stesso i testi e inserire immagini?
Sì. Ogni capitolo del documento ha un pulsante «Modifica» che apre l’editor del capitolo direttamente nel pannello: testo, immagini con didascalia, tabelle (anche incollate da Excel) ed etichette. I numeri di figure e tabelle vengono assegnati automaticamente, in sequenza continua o per capitolo. Per la struttura vera e propria resta disponibile l’editor avanzato.
Che cosa succede se la valutazione del rischio cambia in seguito?
Il curatore aggiorna i fatti dalla banca dati a ogni ciclo. I capitoli scritti con uno stato precedente ricevono l’avviso del revisore «I dati di progetto sono cambiati dopo la stesura». Un’istruzione come «Aggiorna il capitolo 2 alla valutazione del rischio attuale» riporta il testo allo stato corrente; la tabella dei rischi residui, all’esportazione, proviene comunque dallo stato attuale.
Di quanti cicli ho bisogno per un manuale di istruzioni?
Una bozza di capitolo è un ciclo, una sezione riformulata è un ciclo, e lo è anche una domanda con risposta. Per dodici capitoli con domande, tabelle e correzione dei rilievi di solito bastano alcune decine di cicli. La quota mensile di 100 cicli nel piano Professional (200 nel piano Business, condivisi nel team) è pensata per uno o due manuali di istruzioni al mese. La modifica manuale e l’esportazione non contano come cicli.
Vale anche con il regolamento macchine dal 2027?
Sì. Le regole provengono dal progetto: oggi l’allegato I, punto 1.7.4, della direttiva macchine 2006/42/CE, dal 20 gennaio 2027 l’allegato III del regolamento (UE) 2023/1230. L’autore conosce entrambi i riferimenti e la struttura dei capitoli è concepita per entrambi.
Quanto costano le istruzioni per l’uso in dialogo?
12,99 € una tantum per progetto nei piani Professional e Business, senza canone ricorrente. I progetti che hanno già sbloccato le istruzioni per l’uso usano il dialogo senza costi aggiuntivi. La cronologia della conversazione viene salvata con il progetto; i dettagli sono nell’informativa sulla privacy.
Il dialogo sostituisce un redattore tecnico?
No. Si fa carico della prima bozza e la mantiene legata ai dati di progetto. Stile, completezza rispetto al prodotto specifico, adeguatezza al gruppo di destinatari secondo la EN IEC/IEEE 82079-1 e l’approvazione restano compito del fabbricante e del suo team redazionale.

Fonti

Una nota nel nostro interesse: le istruzioni per l’uso in dialogo fanno parte di CE-Copilot e richiedono un progetto con una valutazione del rischio, perché la scheda informativa viene costruita a partire da essa. Che aspetto abbia un’esportazione finita lo mostrano le istruzioni per l’uso di esempio gratuite, la strada per arrivarci la prova gratuita.

Altri articoli