Laboratorio Digitale

Il Prompt Perfetto

Guida operativa passo-passo: 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 — Costruzioni Aeronautiche

Fase 0Perché 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. È un sistema che massimizza la coerenza con il tuo testo: 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, tolleranze e specifiche del materiale, il risultato sarà errato. Con un disegno preciso, la macchina produce esattamente il pezzo richiesto.

❌ Prompt scarso

"Fammi qualcosa sui profili alari"

Nessun formato · nessun contesto · nessun vincolo · nessun output definito

✅ Prompt preciso

"Crea un file HTML singolo che disegna un profilo NACA 4 cifre con slider interattivi, usando le 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 e migliora il risultato. Un prompt è come una specifica di progetto: più è completo, meno sorprese ci sono in fase di esecuzione.

Fase 1Le 6 componenti di un prompt efficace

Un prompt completo risponde sempre a queste sei domande — nell'ordine giusto. Non è necessario che siano tutte presenti ogni volta, ma ognuna che manca è un'opportunità persa di precisione.

Componente 01

🎯 Ruolo

Chi sei?

Definisci l'identità esperta dell'IA. Attiva il «modo esperto» giusto per il tuo dominio tecnico.

"Sei un ingegnere aerostrutturista con 20 anni di esperienza su velivoli FAR-23"

Componente 02

📋 Contesto

Qual è la situazione?

Descrivi il quadro tecnico: cosa stai facendo, a quale livello, per quale scopo.

"Sto analizzando le sollecitazioni su un longherone in alluminio 2024-T3"

Componente 03

🎚️ Parametri

Quali dati hai?

Fornisci valori numerici precisi con le unità di misura. Vago = generico. Numerico = calcolato.

"Apertura alare 8.4 m, carico limite 3.8g, t = 0.12 c"

Componente 04

📐 Formato output

Come deve risponderti?

Specifica lingua, lunghezza, struttura. Codice, tabella, lista, formula, spiegazione.

"Rispondi in italiano con codice Python commentato. Max 80 righe."

Componente 05

⚠️ Vincoli

Cosa NON deve fare?

Escludi librerie, metodi, approcci indesiderati. I vincoli negativi espliciti sono potentissimi.

"Senza librerie esterne. Solo HTML/CSS/JS puro. NON usare jQuery."

Componente 06

📎 Contesto extra

Hai documenti di riferimento?

Allega o trascrivi formule, tabelle, norme, codice esistente. È la componente che fa la differenza.

"Usa l'eq. dalla dispensa: y_t = (t/0.20)·[0.2969√x…]"

Fase 2Componente 1 — Il Ruolo

La prima parola del prompt stabilisce chi risponde. Un ruolo preciso attiva le conoscenze disciplinari giuste e calibra il tono e il livello di dettaglio della risposta. Scrivere "Sei un assistente" è inutile: l'IA lo è già. Serve un ruolo specifico e contestualizzato.

2.1 — Confronti pratici

❌ Vago

"Sei un assistente"

✅ Preciso

"Sei un ingegnere aerostrutturista con 20 anni di esperienza su velivoli certificati FAR-23"

❌ Vago

"Aiutami con il codice"

✅ Preciso

"Sei un programmatore Python specializzato in calcolo scientifico per applicazioni aeronautiche"

❌ Vago

"Spiega questo concetto"

✅ Preciso

"Sei un professore di costruzioni aeronautiche che spiega a studenti di 4° anno ITIS, usando esempi su velivoli reali"

💡 Trucco

Più il ruolo rispecchia il tipo di risposta che vuoi, più l'output sarà calibrato. Per un calcolo strutturale usa il ruolo da ingegnere. Per spiegare la fisica a un novizio, usa il ruolo da professore che semplifica con analogie.

Fase 3Componente 2 — Il Contesto

Il contesto risponde a dove, quando, per chi. Senza contesto, l'IA produce una risposta valida per tutti — ma utile per nessuno in particolare.

3.1 — Le 4 dimensioni del contesto

  1. Disciplina — "Nel contesto delle costruzioni aeronautiche…"
  2. Livello del destinatario — "…per studenti di 4° anno ITIS che non conoscono Python"
  3. Scopo — "…per calcolare il fattore di sicurezza ultimo su un longherone"
  4. Vincoli HW/SW — "…su Windows 11, senza installare nulla, solo il browser"
⚠️ Errore frequente

Saltare il contesto porta l'IA a indovinare. Se stai chiedendo un calcolo FAR Part 23 senza dirlo, l'IA potrebbe rispondere secondo FAR Part 25 (velivoli di linea) — tecnicamente corretta, ma inapplicabile al tuo caso.

3.2 — Esempio combinato Ruolo + Contesto

[RUOLO] Sei un ingegnere strutturista aeronautico.
[CONTESTO] Sto dimensionando il longherone principale di un aliante biposto in fibra di carbonio. Il destinatario è uno studente di costruzioni aeronautiche (4° anno ITIS).
[COMPITO] Spiega il criterio di resistenza di Tsai-Wu per laminati in composito.

Fase 4Componente 3 — I Parametri

Questa è la componente che distingue una risposta generica da una calcolata. I dati numerici con le unità di misura permettono all'IA di fare la matematica vera, non stime vaghe.

⚠️ Critico: le unità di misura

Scrivere "la corda è 1.2 e il carico è 3800" è un errore tecnico grave. L'IA non sa se 3800 è in Newton, kg-forza o libbre. Scrivi sempre: "corda c = 1.2 m", "carico L = 3800 N". La differenza tra N e kgf vale il fattore g = 9.81 — rilevante in ogni verifica strutturale.

4.1 — Confronti pratici

❌ Vago

"un profilo abbastanza spesso"

✅ Preciso

"NACA 2412: m=0.02, p=0.4, t=0.12
corda c = 1.2 m, apertura b = 9.6 m"

❌ Vago

"carichi non troppo alti"

✅ Preciso

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

❌ Vago

"materiale leggero"

✅ Preciso

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

Fase 5Componente 4 — Il Formato output

Senza formato specificato, l'IA sceglie da sola — e raramente indovina esattamente quello che ti serve. Sii esplicito su come vuoi che risponda, non solo cosa vuoi.

5.1 — Formati tipici per costruzioni aeronautiche

Codice Python

"Scrivi in Python 3.11, funzioni commentate in italiano, nessuna libreria esterna. Max 80 righe."

File HTML singolo

"Un unico file index.html con CSS e JavaScript integrati, tema scuro, zero dipendenze esterne."

Tabella di risultati

"Presenta i risultati in una tabella con colonne: x, y_superiore, y_inferiore, y_c — 21 righe da x=0 a x=1."

Spiegazione didattica

"Spiega in italiano semplice, max 10 righe, livello liceo tecnico, con almeno un esempio pratico su un velivolo reale."

Formati doppi

"Prima spiega il concetto in 5 righe, poi scrivi il codice Python che lo implementa." — L'IA seguirà la sequenza.

Fase 6Componente 5 — I Vincoli

I vincoli sono istruzioni in forma negativa: cosa NON fare. Sono fondamentali perché l'IA, senza vincoli, tende a dare la risposta più completa possibile — che spesso è più di quello che ti serve, o usa strumenti che non puoi usare.

6.1 — Tipi di vincoli con esempi

⚡ Trucco avanzato — vincoli negativi espliciti

Usa la parola NON in maiuscolo per rafforzare un vincolo. Esempio efficace:

NON aggiungere commenti ovvi al codice.
NON usare jQuery o Bootstrap.
NON scrivere commenti in inglese.
NON superare le 80 righe di codice totale.

Fase 7Componente 6 — Il Contesto extra

Questa è spesso la componente che fa la differenza tra un output buono e uno preciso come ti serve. Allega o trascrivi i riferimenti tecnici che l'IA deve usare come fonte autorevole.

7.1 — Cosa puoi allegare o citare

  1. Dispensa / PDF — "Usa le formule nella pagina 3 della dispensa allegata." (allega il PDF nella chat di Claude)
  2. Equazioni esplicite — Trascrivi direttamente la formula nel prompt, es. y_t = (t/0.20)·[0.2969√x − 0.1260x − 0.3516x² + 0.2843x³ − 0.1015x⁴]
  3. Tabella dati sperimentali — "I dati sono: x=0.0, Cp=−0.42; x=0.1, Cp=−0.31; …"
  4. Codice esistente — "Partendo da questo codice, aggiungi la funzione che calcola…" (incolla il codice)
  5. Norma tecnica — "Applica la norma CS-VLA, Art. 337: fattori di carico in manovra."
✅ Perché funziona

Quando fornisci le equazioni direttamente nel prompt, l'IA le implementa esattamente come scritte, senza inventare coefficienti o approssimare. È il motivo per cui il prompt della Lezione 1 ha prodotto il calcolo NACA corretto al quarto decimale.

Fase 8Il template universale

Usa questa struttura per ogni prompt che scrivi. Sostituisci i segnaposto tra parentesi quadre con i tuoi dati tecnici. Doppio clic sul riquadro verde per copiarlo negli appunti.

[RUOLO] Sei un ingegnere aerostrutturista / programmatore Python / professore di costruzioni aeronautiche.

[CONTESTO] Sto lavorando su [descrizione progetto]. 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 / NORME] Usa le seguenti equazioni: [formule esplicite]. Norma: [FAR/CS/altra].

[FORMATO OUTPUT] Rispondi in [italiano]. Il formato deve essere [codice / tabella / lista / spiegazione].

[VINCOLI] NON usare [librerie/metodi da evitare]. Lunghezza massima: [N righe/parole].

[VERIFICA] Alla fine verifica che [condizione di controllo, es: il codice giri senza errori].

⚡ Template in una riga

"[RUOLO]. Sto [CONTESTO]. Ho bisogno di [COMPITO]. I parametri sono [PARAMETRI con unità]. Rispondi in [FORMATO]. NON usare [VINCOLI]. Usa le formule: [EXTRA]."

Fase 9Esempio reale n.1 — 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. Il destinatario è uno studente di costruzioni aeronautiche (4° anno ITIS).

[COMPITO] Calcola il momento flettente massimo e verifica la sezione a cassone rispetto alla resistenza del materiale.

[PARAMETRI] Apertura alare b = 18 m, portanza totale L = 9810 N, distribuzione ellittica.
[MATERIALE] Alluminio 2024-T3: E = 73 GPa, σ_ult = 483 MPa, σ_snervamento = 345 MPa.

[FORMATO] Prima mostra i passaggi passo-passo in italiano. Poi scrivi il codice Python 3 che esegue il calcolo.

[VINCOLI] Applica FAR Part 23, categoria normale. Coefficiente di sicurezza ultimo j = 1.5. Solo numpy.

[VERIFICA] Controlla che σ_max < σ_snervamento / j con margine di sicurezza MS > 0.

✅ Perché questo prompt funziona

Ruolo esperto calibrato al problema strutturale · dati numerici con unità SI · norma di riferimento esplicita (FAR Part 23) · formato doppio (spiegazione + codice) · condizione di verifica finale che l'IA deve controllare autonomamente.

Fase 10Esempio reale n.2 — Web App NACA (Lezione 1)

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" — vincolo tecnologico esplicito
6 · EXTRAEquazioni NACA trascritte nel prompt: y_t = (t/0.20)·[0.2969√x − 0.1260x − 0.3516x² + 0.2843x³ − 0.1015x⁴]
💡 La chiave del risultato preciso

Il fatto che la componente 6 contenesse le equazioni esatte dalla dispensa è il motivo per cui l'IA ha implementato correttamente il polinomio NACA al quarto decimale. Senza quelle equazioni, avrebbe potuto usare approssimazioni diverse da quelle del corso.

Fase 11Iterazione e raffinamento

Raramente il primo prompt è perfetto. Il ciclo di raffinamento — scrivi, osserva, correggi — è la vera competenza da sviluppare. L'IA conserva il contesto dell'intera conversazione: ogni messaggio successivo si aggiunge al contesto dei precedenti.

📝

Passo 01

Primo prompt

Usa il template. Sii preciso su parametri e formato atteso.

🔍

Passo 02

Analizza

Il risultato è corretto? Manca qualcosa? C'è un errore tecnico?

🔧

Passo 03

Raffina

Aggiungi il vincolo mancante o correggi il parametro errato.

Passo 04

Risultato

Output tecnico corretto, pronto per il deploy o la consegna.

11.1 — Frasi di raffinamento utili

Regola d'oro del raffinamento

Non accettate mai il primo output senza verificarlo. L'IA è potente ma non infallibile: le formule, le definizioni e i ragionamenti vanno sempre controllati con il materiale originale del docente. La responsabilità della correttezza è vostra.

Fase 12I 6 errori più comuni nei prompt

Riconoscerli è il primo passo per evitarli. Ogni errore ha una soluzione immediata, applicabile dal prossimo prompt.

⚠️ Errore 01

Il prompt telescopico

❌ "Fammi un programma che calcola le coordinate e poi le visualizza e magari aggiunge il grafico della portanza e se puoi anche la tabella…"

✅ Dividi in prompt separati: prima il calcolo, poi la visualizzazione, poi il grafico.

⚠️ Errore 02

Senza unità di misura

❌ "La corda è 1.2 e il carico è 3800"

✅ Sempre: "corda c = 1.2 m", "carico L = 3800 N". L'IA non distingue Newton da kg-forza.

⚠️ Errore 03

Senza contesto tecnologico

❌ "Scrivi il codice per il profilo NACA"

✅ Specifica: "In Python 3, senza librerie esterne" oppure "In HTML vanilla, un solo file index.html".

⚠️ Errore 04

Accettare il primo risultato

❌ Il codice ha un errore ma non lo segnali → l'IA non sa che c'è qualcosa da correggere.

✅ Incolla sempre l'errore esatto. Cita la riga del problema e chiedi la correzione mirata.

⚠️ Errore 05

Linguaggio naturale vago

❌ "Fai qualcosa di bello per visualizzare le forze sull'ala"

✅ "Disegna il diagramma di taglio e momento sul semiala: distribuzione ellittica, SVG inline, assi etichettati in N e N·m."

⚠️ Errore 06

Non dare la fonte

❌ Chiedi il calcolo del momento critico di un pannello senza fornire le equazioni di riferimento.

✅ Allega o trascrivi le formule dalla dispensa. Altrimenti l'IA usa formule generiche, non quelle del corso.

AppendiceQuick Reference — Scheda di studio

Tienila aperta mentre scrivi i tuoi prompt. Le 6 componenti, i 6 errori, il template in una riga.

Le 6 componenti

01 · RUOLO 02 · CONTESTO 03 · PARAMETRI (con unità!) 04 · FORMATO OUTPUT 05 · VINCOLI (usa NON) 06 · CONTESTO EXTRA (allega formule)

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]. I parametri sono [PARAMETRI con unità]. Rispondi in [FORMATO]. NON usare [VINCOLI]. Usa le formule: [EXTRA]."