Profilo del cliente
Il team opera all’interno di una società di consulenza di architettura navale e ingegneria marittima che serve operatori di petroliere chimiche, cantieri navali e organismi di classificazione in tutto il settore del trasporto marittimo commerciale. Il loro lavoro documentale si concentra su disegni DXF e DWG — trasformando ciò che vive in un file CAD in tabelle strutturate, cartigli aggiornati e set di deliverable formalmente impacchettati che cantieri e ispettori di classificazione richiedono davvero.
Un progetto tipico prevede una tabella serbatoi, un riepilogo Main Particulars, almeno una revisione del cartiglio e un disegno di ritorno in una specifica versione DWG. Per il progetto Hanna — una petroliera chimica — lo scope copriva esattamente questo insieme: due tabelle dati strutturate, una modifica al cartiglio e una conversione round-trip di ritorno a un DWG AC1021 validato. Il team gestisce più navi in parallelo, quindi il collo di bottiglia dell’estrazione manuale si amplifica rapidamente su tutto il portafoglio progetti.
Problema
Estrarre dati strutturati da disegni DXF non è, in senso ordinario, un’attività di parsing del testo. I disegni navali memorizzano etichette, valori, dimensioni e annotazioni dei telai come entità di testo DXF distribuite su più layer, senza una struttura coerente di righe e colonne che gli strumenti di foglio di calcolo possano leggere direttamente. L’unico metodo affidabile è analizzare il formato DXF in modo programmatico — oppure aprire il disegno in una workstation CAD completa e trascrivere i valori a mano.
Per il progetto Hanna, il target di estrazione era composto da due tabelle più sette righe di misurazioni distinte.
Il blocco Main Particulars conteneva queste dimensioni della nave:
- Length for scantlings: 106.254 m
- Length overall: 109.999 m
- Breadth moulded: 13.500 m
- Depth moulded: 5.140 m
- Draft — scantling: 4.200 m
- Draft — maximum: 4.200 m
- Cargo tank capacity: 4,560 m³
Ogni riga riportava anche qualificatori — "abt." per approssimativo, "mld." per moulded — che dovevano essere preservati nell’output insieme ai valori numerici e alle unità. Perdere o assegnare in modo errato un qualificatore cambia l’interpretazione ingegneristica della dimensione.
La tabella serbatoi poneva una sfida diversa. Una tabella completa dei serbatoi per una petroliera chimica di questa classe comprende molti serbatoi numerati, ciascuno con un intervallo di telai e una capacità associata. Il rischio non è solo l’errore di estrazione, ma anche l’omissione silenziosa: una voce di serbatoio mancante potrebbe non essere rilevata fino a quando il documento non arriva a un ispettore di classificazione o al team acquisti del cantiere. Nel workflow precedente del team — aprire il disegno su una workstation CAD, leggere manualmente i valori e inserirli in Excel — un passaggio completo di estrazione per il disegno di una singola nave richiedeva gran parte di una giornata lavorativa e lasciava comunque irrisolto quel rischio.
Il progetto richiedeva inoltre una conversione da DXF a DWG che producesse un file AC1021 valido. Quello standard di versione (formato AutoCAD 2007) è ancora richiesto da molti sistemi CAD più datati in uso presso gli organismi di classificazione e alcuni cantieri. Rinominare semplicemente il file non basta; il team aveva bisogno della conferma del conteggio delle entità e dei layout per certificare l’output prima della consegna.
Perché ora
Gli organismi di classificazione e i sistemi di procurement dei cantieri richiedono sempre più spesso dati leggibili dalle macchine insieme ai disegni. Un DWG o un PDF da soli non sono più sufficienti quando il sistema ricevente deve acquisire in database valori di capacità, intervalli di telai o dati della nave, oppure verificarli in modo programmatico prima della pianificazione di un’ispezione.
Il progetto Hanna rappresentava un punto di svolta comune: una nave che passava dalla fase di revisione del disegno alla presentazione formale per la classificazione, dove sono richieste esportazioni di dati strutturati in parallelo al disegno aggiornato. I ritardi in questa fase si propagano nella pianificazione delle ispezioni e, in ultima analisi, nella prontezza operativa della nave. Il team doveva comprimere la fase di estrazione e confezionamento senza introdurre errori che avrebbero richiesto una nuova presentazione.
Perché energent.ai
Il team ha valutato tre approcci prima di scegliere energent.ai: un operatore dedicato su workstation CAD che gestisse manualmente l’estrazione, uno script Python interno di parsing e un modello linguistico generalista senza capacità diretta di gestione dei file.
L’estrazione manuale restava necessaria per la conferma visiva finale delle anomalie segnalate, ma era troppo lenta e dipendente dall’operatore per la fase routinaria di estrazione e strutturazione. Lo script Python interno richiedeva manutenzione continua, poiché le strutture dei disegni variavano tra tipologie di nave e clienti. Un modello linguistico generalista poteva descrivere le convenzioni del formato DXF, ma non poteva caricare e analizzare il file in prima persona.
energent.ai ha gestito l’intero workflow in una sola sessione. Ha caricato il file DXF, eseguito Python per analizzare le entità di testo, strutturato l’output in colonne etichettate, applicato le modifiche al cartiglio in-place, convertito il DXF aggiornato in DWG con validazione della versione e confezionato sei file deliverable. In modo critico, ha anche eseguito un passaggio di audit indipendente — deliberatamente isolato dal processo di estrazione per evitare il confirmation bias — che ha fatto emergere due anomalie prima della consegna dei file. Quel comportamento di audit era la capacità che il team non riusciva a replicare con nessuna delle alternative.
Workflow
La sessione ha seguito una sequenza riproducibile in sette passaggi:
Step 1 — Drawing ingestion. Il team ha caricato il file DXF Hanna. L’agente ha analizzato la struttura del file e identificato le tre aree target: la tabella serbatoi, il blocco Main Particulars e il cartiglio.
Step 2 — Main Particulars extraction. L’agente ha estratto il blocco di sette righe, associando ogni etichetta di misurazione al relativo valore, unità e qualificatore. Output: un workbook XLSX e un CSV, entrambi con annotazioni di colonna in inglese semplice che spiegavano qualificatori come "abt." (approximate) e "mld." (moulded).
Step 3 — Tank table extraction. L’intera tabella serbatoi è stata estratta in una tabella strutturata che copriva numeri di serbatoio, intervalli di telai e valori di capacità. Output: XLSX e CSV.
Step 4 — Title-block modification. Le sostituzioni di testo richieste nel cartiglio sono state applicate direttamente ai record delle entità DXF. L’agente ha confermato le modifiche ispezionando il contenuto testuale del file aggiornato.
Step 5 — Independent audit. Un passaggio di audit isolato ha confrontato gli output di estrazione con i dati sorgente. Sono state registrate due osservazioni: Tank No. 12 era assente dalla tabella serbatoi estratta — segnalato come questione di completezza anziché accettato silenziosamente — e Tank 5 presentava un intervallo di telai 127–172 che appariva insolitamente ampio rispetto alle voci adiacenti, richiedendo una revisione visiva sul disegno sorgente.
Step 6 — DXF-to-DWG conversion and validation. Il DXF aggiornato è stato convertito in DWG tramite un workflow di conversione strutturato. La validazione ha confermato: versione AC1021, due layout (Model e Layout1) e 3,753 entità del modelspace. È stata registrata una nota secondo cui la fedeltà visiva dipende dalla configurazione dei font della workstation ricevente e dalla disponibilità dei file SHX.
Step 7 — Deliverable packaging. Tutti e sei i file sono stati assemblati e confermati: tank table XLSX, tank table CSV, Main Particulars XLSX, Main Particulars CSV, DXF aggiornato e DWG validato.
Risultati
Sei deliverable strutturati sono stati prodotti da un singolo input DXF in una sola sessione:
- Sette dimensioni della nave estratte in XLSX e CSV etichettati con i qualificatori di unità preservati
- Capacità cargo di 4,560 m³ correttamente acquisita e associata alla relativa riga di tabella
- 3,753 entità del modelspace validate tramite il round-trip DWG (AC1021 confermato)
- 2 segnalazioni di audit emerse prima della consegna — impedendo che errori silenziosi raggiungessero i revisori downstream
- 6 file deliverable confezionati, in linea con il formato standard di consegna di cantiere e classificazione
Il team ha inoltre ricevuto un template di sessione riproducibile. La stessa sequenza in sette passaggi — ingest, extract Main Particulars, extract tank table, modify title block, audit, convert, package — può essere applicata ad altri disegni di nave senza dover ricostruire il workflow da zero per ogni progetto.
Proof
"Prima dedicavamo la maggior parte di una giornata lavorativa a un singolo disegno di nave, e a volte ci sfuggivano ancora voci che emergevano solo durante la revisione di classificazione. Avere l’agente che segnalava un tank mancante e un intervallo di frame sospetto prima che confezionassimo i file era esattamente il controllo che ci serviva, integrato nel processo, non aggiunto manualmente alla fine." — Lead Naval Architect, marine engineering consultancy
The complete deliverable set the agent produced — tank table XLSX and CSV, Main Particulars XLSX and CSV, updated DXF, and validated AC1021 DWG — mirrors the standard handover package the team submits to shipyard procurement and classification surveyors. The two audit flags indicate precisely which items require visual confirmation before sign-off, rather than leaving that determination to the downstream reviewer.
Trust note
The DWG output passed structural validation (AC1021 format, 3,753 modelspace entities confirmed), but exact visual fidelity remains dependent on the receiving workstation's font configuration and SHX file availability — a gap that cannot be resolved without a CAD workstation review. The audit explicitly flagged Tank No. 12 as absent from the extracted table and Tank 5's frame range (127–172) as potentially anomalous compared with adjacent entries. Both items require a human reviewer to open the source drawing and confirm visually before the tank table is submitted for classification review or incorporated into formal vessel documentation. The Main Particulars CSV is structurally complete for the seven core lines but does not constitute a full technical specification sheet.