Laboratorio Digitale · Costruzioni Aeronautiche

Il Prompt
Perfetto

Come costruire richieste precise all'IA per ottenere esattamente quello che vuoi — con esempi pratici di Costruzioni Aeronautiche.

Prof. Ing. Raucci Biagio  ·  ITIS E. Majorana, Cassino  ·  A.S. 2025/2026
Scorri
Fase 00

Perché l'IA "non capisce" quello che vuoi?

Il problema non è l'IA: è il prompt. L'intelligenza artificiale risponde esattamente a ciò che le chiedi, non a ciò che intendi. Se il testo è vago, il risultato sarà generico.

🔧 Analogia tecnica

Un disegno tecnico ambiguo produce un pezzo sbagliato — anche con l'operatore CNC più bravo. Il prompt è il tuo disegno tecnico. L'IA è il tornio. Se il disegno manca di quote e tolleranze, il risultato sarà errato.

❌ Prompt scarso

"Fammi qualcosa
sui profili alari"

✅ Prompt preciso

"Crea un file HTML singolo che disegna un profilo NACA 4 cifre con slider interattivi, equazioni dalla dispensa allegata, senza librerie esterne"

💡 Regola d'oro

L'IA non legge la tua mente: legge il tuo testo. Ogni informazione aggiunta riduce l'incertezza. Un prompt è come una specifica di progetto: più è completo, meno sorprese ci sono.

Fase 01

Le 6 componenti di un prompt efficace

Un prompt completo risponde sempre a queste sei domande, nell'ordine giusto. Ogni componente che manca è un'opportunità persa di precisione.

Componente 01
🎯 Ruolo
Chi sei?
"Sei un ingegnere aerostrutturista con 20 anni di esperienza su velivoli FAR-23"
Componente 02
📋 Contesto
Qual è la situazione?
"Sto analizzando le sollecitazioni su un longherone in alluminio 2024-T3"
Componente 03
🎚️ Parametri
Quali dati hai?
"Apertura alare 8.4 m, carico limite 3.8g, t = 0.12 c"
Componente 04
📐 Formato
Come deve risponderti?
"Codice Python 3, funzioni commentate in italiano, max 80 righe"
Componente 05
⚠️ Vincoli
Cosa NON deve fare?
"Senza librerie esterne. Solo HTML/CSS/JS puro. NON usare jQuery."
Componente 06
📎 Extra
Hai documenti di riferimento?
"Usa l'eq. dalla dispensa: y_t = (t/0.20)·[0.2969√x…]"
Fase 02 — Approfondimento

Parla in numeri,
chiedi in formato

I dati numerici con le unità di misura trasformano una risposta generica in una calcolata. Il formato atteso guida la struttura dell'output.

❌ Vago

"materiale leggero"

"carichi non troppo alti"

"un profilo abbastanza spesso"

✅ Preciso

"alluminio 2024-T3: E=73 GPa, σ_ult=483 MPa"

"fattore di carico n=+3.8/−1.52 (FAR Part 23)"

"NACA 2412: m=0.02, p=0.4, t=0.12"

⚠️ Critico: le unità di misura

Scrivere "la corda è 1.2 e il carico è 3800" è un errore tecnico grave. La differenza tra N e kgf vale il fattore g = 9.81 — rilevante in ogni verifica strutturale. Scrivi sempre: "corda c = 1.2 m", "carico L = 3800 N".

⚡ Vincoli negativi espliciti

Usa NON in maiuscolo: "NON usare jQuery. NON aggiungere commenti ovvi. NON scrivere in inglese." La parola NON in maiuscolo rafforzata è tra le tecniche più efficaci nel prompt engineering.

Fase 03 — Template

Il template
universale

Usa questa struttura per ogni prompt. Sostituisci i segnaposto con i tuoi dati tecnici. Doppio clic per copiarlo.

[RUOLO]Sei un ingegnere aerostrutturista / programmatore Python / professore di costruzioni.
[CONTESTO]Sto lavorando su [descrizione]. Il livello del destinatario è [principiante/esperto].
[COMPITO]Devo ottenere [descrizione precisa del risultato atteso].
[PARAMETRI]I dati tecnici sono: [lista valori numerici con unità di misura].
[EQUAZIONI]Usa le seguenti equazioni: [formule esplicite]. Norma: [FAR/CS/altra].
[FORMATO]Rispondi in italiano. Il formato deve essere [codice/tabella/lista/spiegazione].
[VINCOLI]NON usare [da evitare]. Lunghezza massima: [N righe].
[VERIFICA]Alla fine verifica che [condizione di controllo].
⚡ Template in una riga

"[RUOLO]. Sto [CONTESTO]. Ho bisogno di [COMPITO]. Parametri: [dati+unità]. Formato: [tipo]. NON usare [vincoli]. Equazioni: [extra]."

Fase 04 — Esempio reale

Esempio: dimensionamento
longherone

Un prompt professionale per un problema tipico di Costruzioni Aeronautiche. Tutte e 6 le componenti sono presenti e identificabili. Doppio clic per copiarlo.

[RUOLO]Sei un ingegnere strutturista aeronautico esperto in analisi di travi e strutture alari.
[CONTESTO]Sto dimensionando il longherone principale di un aliante biposto. Destinatario: studente di costruzioni aeronautiche (4° anno ITIS).
[COMPITO]Calcola il momento flettente massimo e verifica la sezione a cassone.
[PARAMETRI]b = 18 m, L = 9810 N, distribuzione ellittica. Alluminio 2024-T3: E=73 GPa, σ_ult=483 MPa.
[FORMATO]Prima i passaggi passo-passo in italiano. Poi il codice Python 3.
[VINCOLI]FAR Part 23, categoria normale. j = 1.5. Solo numpy.
[VERIFICA]Controlla σ_max < σ_snervamento / j con MS > 0.
✅ Perché funziona

Ruolo esperto calibrato · dati numerici con unità SI · norma esplicita (FAR Part 23) · formato doppio (spiegazione + codice) · condizione di verifica finale autonoma.

Fase 05 — Anatomia

Esempio: web app NACA
— scomposto

Il prompt usato nella Lezione 1, scomposto nelle 6 componenti. Riconoscerle in un prompt già usato aiuta a interiorizzare la struttura.

1 · RUOLO (implicito) — avremmo potuto scrivere: "Sei un programmatore HTML/JS specializzato in applicazioni scientifiche"
2 · CONTESTO "web app in un singolo file HTML per disegnare profili alari NACA a 4 cifre"
3 · PARAMETRI "slider m (0÷9), p (1÷9), t (1÷40)" — range precisi con significato fisico esplicitato
4 · FORMATO "singolo file HTML — canvas SVG — tabella 21 punti x, y_sup, y_inf"
5 · VINCOLI "Zero librerie esterne. Tutto in un solo index.html"
6 · EXTRA Equazioni NACA trascritte nel prompt: y_t = (t/0.20)·[0.2969√x − 0.1260x − 0.3516x² + …]
💡 La chiave del risultato preciso

Le equazioni esatte dalla dispensa nella componente 6 sono il motivo per cui l'IA ha implementato il polinomio NACA corretto al quarto decimale. Senza di esse, avrebbe usato approssimazioni diverse.

Fase 06 — Iterazione

Il prompt è un processo,
non un evento

Raramente il primo prompt è perfetto. Il ciclo di raffinamento — scrivi, osserva, correggi — è la vera competenza da sviluppare.

📝
Passo 01
Primo prompt
Usa il template. Sii preciso su parametri e formato.
🔍
Passo 02
Analizza
Il risultato è corretto? Manca qualcosa?
🔧
Passo 03
Raffina
Aggiungi il vincolo mancante o correggi il parametro.
✅
Passo 04
Risultato
Output tecnico corretto, pronto per il deploy.
Regola d'oro del raffinamento

Non accettate mai il primo output senza verificarlo. Le formule e i ragionamenti vanno sempre controllati con il materiale originale del docente. La responsabilità della correttezza è vostra.

Fase 07 — Errori

I 6 errori più comuni

Riconoscerli è il primo passo per evitarli. Ogni errore ha una soluzione immediata.

⚠️ Errore 01
Il prompt telescopico
❌ "Fammi un programma che calcola le coordinate e poi le visualizza e aggiunge il grafico e la tabella…"
✅ Dividi in prompt separati: prima il calcolo, poi la visualizzazione.
⚠️ Errore 02
Senza unità di misura
❌ "La corda è 1.2 e il carico è 3800"
✅ "corda c = 1.2 m", "carico L = 3800 N". L'IA non distingue N da kgf.
⚠️ Errore 03
Senza contesto tecnologico
❌ "Scrivi il codice per il profilo NACA"
✅ "In Python 3, senza librerie esterne" oppure "In HTML vanilla, un solo file".
⚠️ Errore 04
Accettare il primo risultato
❌ Il codice ha un errore ma non lo segnali.
✅ Incolla l'errore esatto. Cita la riga e chiedi la correzione mirata.
⚠️ Errore 05
Linguaggio naturale vago
❌ "Fai qualcosa di bello per visualizzare le forze sull'ala"
✅ "Diagramma di taglio e momento, distribuzione ellittica, SVG, assi in N e N·m."
⚠️ Errore 06
Non dare la fonte
❌ Chiedi il calcolo del pannello senza fornire le equazioni di riferimento.
✅ Allega o trascrivi le formule dalla dispensa. Altrimenti l'IA usa formule generiche.
Appendice

Quick Reference

Tienila aperta mentre scrivi i tuoi prompt.

Le 6 componenti
01 · RUOLO 02 · CONTESTO 03 · PARAMETRI (con unità!) 04 · FORMATO OUTPUT 05 · VINCOLI (usa NON) 06 · CONTESTO EXTRA
I 6 errori da non fare
⚠️ Prompt telescopico ⚠️ Senza unità di misura ⚠️ Senza contesto SW ⚠️ No feedback errori ⚠️ Linguaggio vago ⚠️ Senza fonte/formule
Template in una riga
"[RUOLO]. Sto [CONTESTO]. Ho bisogno di [COMPITO]. Parametri: [dati+unità]. Formato: [tipo]. NON usare [vincoli]. Equazioni: [extra]."
Livello 2 — Intermedio
Atto IX

Mostra un esempio.
Non descriverlo.

Un solo esempio concreto vale dieci paragrafi di istruzioni astratte. L'IA effettua pattern-matching sull'esempio con precisione maggiore rispetto all'interpretazione di descrizioni verbali.

T1
Dai un esempio di output SHOW DON'T TELL
Invece di descrivere il formato in modo astratto, mostra a Claude un output già fatto. Chiedi di replicare esattamente quella struttura per i casi successivi.
❌ "Organizza i dati in un formato strutturato con sezioni e sottosezioni"✅ "Ecco un esempio del formato atteso: Grandezza: Portanza L Formula: L = ½ · ρ · V² · S · C_L Unità: Newton [N] Nota: dipende dal quadrato della velocità Ora scrivi tre voci analoghe per: Resistenza, Momento, Spinta."
T2
Concatena i prompt CHAIN PROMPTING
I compiti complessi producono risultati migliori se spezzati in passi sequenziali. Ogni passo lavora sull'output raffinato del precedente — la qualità si accumula.
Prompt 1 → Ricerca: "Identifica i 5 principali modi di guasto strutturale nelle ali in composito. Sintesi in 2 frasi per ciascuno." Prompt 2 → Analisi: "Tra questi, individua i 3 più critici per un aliante ultraleggero. Motiva in base al rapporto rischio/frequenza." Prompt 3 → Schema: "Crea l'indice di un report tecnico su questi 3 modi di guasto." Prompt 4 → Stesura: "Scrivi il report completo seguendo quell'indice. 1.800 parole, italiano tecnico."
T3
Impila i vincoli negativi CONSTRAINT STACK
Sei-dieci vincoli negativi in serie sono il modo più rapido per eliminare il tono da intelligenza artificiale generica. Il risultato suona come una persona con opinioni vere.
NON usare frasi di riempimento. NON iniziare frasi con "È importante notare" o "In conclusione". NON usare le parole "sinergia", "paradigma", "ecosistema", "leverage". NON aggiungere avvertimenti o clausole di esclusione superflue. NON usare la forma passiva dove si può usare l'attiva. NON ripetere concetti già espressi in precedenza.
Livello 2 — Intermedio
Atto X

Chiedi all'IA di
valutarsi da sola

Il ciclo di auto-valutazione è significativamente più efficace sui modelli recenti. Claude intercetta le proprie lacune e le corregge prima che l'output ti raggiunga.

⚡ La tecnica

Dopo aver scritto la risposta, chiedi a Claude di valutarla su tre criteri con un punteggio da 1 a 10. Se un punteggio è inferiore a 8, deve migliorare quella dimensione e mostrare solo la versione migliorata.

9.2
Accuratezza
Le formule rispecchiano la norma FAR Part 23 § 337?
7.4
Chiarezza
← sotto 8: Claude riscrive questa sezione
8.8
Utilità
L'output serve allo studente di 4° anno ITIS?
[SELF-EVAL]Dopo aver scritto la risposta, valutala da 1 a 10 su: accuratezza tecnica, chiarezza espositiva, utilità per il mio contesto specifico. Se uno dei punteggi è inferiore a 8, migliora quella dimensione. Mostra solo la versione finale migliorata, non i punteggi.
💡 Ordine del contesto — Context-First

Inserisci il materiale di riferimento sopra le istruzioni, non sotto. Claude elabora il contesto prima di ricevere il compito — la comprensione è più profonda. Metti i dati in cima, poi le istruzioni in fondo.

Livello 3 — Esperto
Atto XI

XML: la lingua
nativa di Claude

Claude è stato addestrato su prompt strutturati. I tag XML eliminano ogni ambiguità su dove finisce un'istruzione e ne inizia un'altra. Il risultato è più coerente, più strutturato, meno soggetto a interpretazioni errate.

<ruolo>Sei un analista strutturista aeronautico specializzato in meccanismi di guasto</ruolo>

<contesto>Sto preparando una relazione tecnica per il docente di Costruzioni Aeronautiche.
Il destinatario è uno studente di 4° anno ITIS con buone basi di statica.</contesto>

<compito>Analizza i dati allegati e crea un sommario tecnico da presentazione</compito>

<formato_output>
  - Sommario esecutivo (3 frasi)
  - Tabella metriche (Portanza, Resistenza, L/D ratio, V_stall)
  - 3 punti di forza con dato di supporto
  - 2 criticità con azione raccomandata
</formato_output>

<vincoli>
  - Solo dati certi, nessuna speculazione senza indicarla esplicitamente
  - Usa numeri precisi, non approssimazioni
  - Lunghezza totale sotto le 1.200 parole
</vincoli>

<verifica>Controlla che ogni metrica nella tabella abbia unità di misura esplicita</verifica>
🎭 Tecnica Multi-Persona

Chiedi a Claude di analizzare una decisione da tre prospettive: il progettista strutturista (massimizza sicurezza), il responsabile dei costi (minimizza peso e materiale), il pilota collaudatore (massimizza affidabilità in volo). Ciascuno espone la sua tesi in 3-4 frasi. Poi Claude sintetizza la raccomandazione identificando i trade-off. Il risultato è un'analisi drammaticamente più ricca di qualsiasi "analizza questo" generico.

Livello 3 — Esperto
Atto XII

I 5 prompt
universali

Cinque template pronti all'uso per i cinque compiti più comuni. Salva, personalizza le variabili tra parentesi, riusa. Ogni doppio clic copia il template.

🔍 Prompt di Analisi
Sei un analista di [dominio] con 15 anni di esperienza. Analizza [oggetto] e identifica le 3 criticità più significative. Per ciascuna: (1) descrizione precisa, (2) evidenza numerica a supporto, (3) impatto su [pubblico], (4) azione raccomandata. Usa dati specifici dove possibile. NON aggiungere avvertimenti superflui o clausole generiche.
✍️ Prompt di Scrittura
Sei un autore tecnico specializzato in [campo]. Scrivi un [formato] su [argomento] per [pubblico]. Apri con un dato sorprendente o un'affermazione che sfida un'assunzione comune. Paragrafi brevi. Ogni frase deve insegnare qualcosa, provare qualcosa o portare avanti il ragionamento. NON usare frasi di riempimento, gergo aziendale o forma passiva. Target: [N] parole.
⚖️ Prompt Decisionale
Devo scegliere tra [Opzione A] e [Opzione B]. Contesto: [situazione]. Analizza ciascuna opzione su questi criteri: [criterio 1], [criterio 2], [criterio 3]. Per ogni criterio assegna un punteggio 1-10 e motiva in una frase. Poi dammi la tua raccomandazione con livello di confidenza (alto/medio/basso) e indica quale informazione aggiuntiva cambierebbe maggiormente la tua risposta.
🔧 Prompt Problem-Solving
Sto riscontrando [problema]. Tentativi già effettuati: [tentativi]. Ipotesi sulla causa: [ipotesi]. Individua la causa più probabile. Proponi 3 soluzioni in ordine di probabilità di successo. Per ciascuna: stima dello sforzo necessario e probabilità di riuscita. Raccomanda il percorso migliore.
📋 Prompt di Feedback
Revisiona [mio lavoro] rispetto a questi criteri: [criteri]. Per ciascuno: punteggio 1-10 con spiegazione specifica di cosa funziona e cosa no. Identifica il singolo miglioramento ad impatto più alto. Riscrivi la sezione più debole mostrando come appare a livello "eccellente". Sii diretto: preferisco una verità scomoda a un'incoraggiamento generico.
Atto XIII — Sintesi

Il prompt è un
artefatto del pensiero

Il prompt engineering non riguarda la memorizzazione di trucchi. Riguarda la chiarezza del pensiero. Scrivere un prompt eccellente richiede di sapere esattamente cosa si vuole, chi è il pubblico, come appare un risultato "eccellente" e quali problemi evitare.

🎯 La verità scomoda

La maggior parte delle persone non scrive prompt mediocri perché è poco intelligente. Li scrive perché non ha ancora chiarito il proprio pensiero. L'IA è uno specchio: restituisce esattamente il livello di chiarezza che hai messo nel prompt. Un prompt vago è il sintomo di un'idea ancora nebulosa.

01
I tag XML forzano la separazione delle istruzioni
Non sono un formato tecnico opzionale: ti costringono a separare ruolo, contesto, compito, formato. Questo è un esercizio di pensiero prima ancora che di prompt.
02
I vincoli negativi forzano l'articolazione di ciò che non vuoi
La maggior parte delle persone sa cosa vuole solo in modo vago, ma sa con precisione cosa non vuole. I vincoli negativi sfruttano questa asimmetria cognitiva.
03
Gli esempi forzano la definizione di "buono"
Non puoi mostrare un esempio di output desiderato senza prima avere in testa come appare. Trovare o costruire quell'esempio è già metà del lavoro.
04
Il raffinamento iterativo è il metodo — non l'eccezione
I migliori prompt engineer non si aspettano la perfezione al primo tentativo. Si aspettano un buon punto di partenza e lo affinano con feedback specifici e numerati.
🧭 Il percorso di studio

Inizia con il framework a 6 componenti — usalo per i prossimi cinque prompt. Poi aggiungi una tecnica nuova per settimana: prima gli esempi, poi il chain prompting, poi i vincoli negativi impilati, poi l'XML, poi il ciclo di auto-valutazione. In sei settimane il prompting esperto diventa riflesso automatico.