Profilo del cliente
Il team di questo case study opera nell’ambito dell’ingegneria meccanica presso una società di consulenza per i servizi edilizi di medie dimensioni. La loro produzione quotidiana consiste in documentazione di costruzione per sistemi HVAC commerciali e istituzionali — canalizzazioni di mandata, percorsi di estrazione, layout dei diffusori e schede di dettaglio per fabbricazione e installazione su cui fanno affidamento appaltatori e ispettori durante la realizzazione.
Il personale tecnico copre due ruoli che si sovrappongono. Gli ingegneri HVAC sono responsabili della progettazione del sistema e dell’approvazione delle specifiche; i tecnici CAD traducono quei progetti in pacchetti di disegni. Entrambi i ruoli gestiscono regolarmente file DWG complessi e multi-sezione, provenienti da subconsulenti o prodotti internamente, che devono poi essere confezionati in deliverable pronti per il cliente. Questi deliverable includono in genere programmi strutturati in Excel, documentazione leggibile per il coordinamento di progetto e artefatti di audit di copertura che dimostrano che nessuna sezione del disegno è stata trascurata.
Problema
Il disegno in questione era una tavola completa di dettagli delle canalizzazioni HVAC contenente più di venti sezioni distinte di costruzione e specifica. Le sezioni nominate nel file includevano dettagli di isolamento delle canalizzazioni, dettagli dei supporti delle canalizzazioni, configurazioni dei diffusori a soffitto di mandata, dettagli dei collegamenti flessibili, dettagli tipici dei rami di canalizzazione, dettagli di attraversamento parete delle canalizzazioni, dettagli del plenum box, dettagli dei diffusori, specifiche delle giunzioni per canalizzazioni e raccordi circolari, dimensioni minime dei supporti per canalizzazioni circolari, tabelle di selezione del calibro delle canalizzazioni circolari in acciaio zincato, dettagli delle giunzioni e dei giunti delle canalizzazioni, dettagli di costruzione dei rinforzi intermedi, giunti delle canalizzazioni in pressione, e ulteriori riferimenti etichettati — Detail A, Detail B e dettagli del rivestimento acustico delle canalizzazioni.
Lavorare manualmente su un file di queste dimensioni introduceva una serie di problemi che si sommavano tra loro. Primo, i file DWG non sono direttamente interoperabili con tutti gli strumenti downstream: la conversione in DXF richiede una licenza completa di AutoCAD oppure un'utilità di conversione dedicata, e l'output va verificato. Secondo, la geometria DXF grezza non è autoesplicativa — i confini delle sezioni, il testo delle annotazioni e le linee delle tabelle esistono come tipi di entità separati, senza alcuna relazione intrinseca padre-figlio. Determinare quale testo appartenga a quale sezione richiede un ragionamento spaziale su migliaia di coordinate di entità. Terzo, il programma delle canalizzazioni a bassa velocità — una tabella di riferimento di 7 colonne e 9 righe incorporata nel disegno — doveva essere estratto in un file Excel formattato per l'uso nei computi metrici e nelle comunicazioni con l'appaltatore. Ricostruire una tabella dai dati di posizione del testo DXF e dalla geometria delle linee richiede tempo anche per tecnici esperti, e il rischio di un errore di trasposizione o di una riga mancata è reale.
Infine, prima di condividere i deliverable con soggetti esterni, il team aveva bisogno di un audit di copertura: una conferma esplicita che ogni sezione nominata fosse stata presa in carico e documentata, non solo quelle facili da individuare.
Perché ora
Il fattore scatenante immediato era una consegna di milestone di progetto. Il team si era impegnato a fornire al general contractor un riepilogo completo del pacchetto di disegni e un programma strutturato entro fine settimana. Con più ingegneri impegnati contemporaneamente su diverse fasi del progetto, non c'era capacità residua per assegnare il lavoro di estrazione e documentazione a una sola persona per un'intera giornata. Il compito doveva essere completato più rapidamente di quanto consentisse il processo manuale, senza sacrificare l'accuratezza.
Una pressione secondaria riguardava l'interoperabilità dei formati. Il software di stima dell'appaltatore accettava DXF ma non DWG, quindi la conversione di formato non era opzionale. Eseguire la conversione, poi l'inventario delle sezioni, poi l'estrazione della tabella, poi la documentazione — come quattro operazioni manuali sequenziali — avrebbe consumato gran parte di una giornata lavorativa, ancora prima di eventuali cicli di revisione.
Perché energent.ai
Il team ha valutato diversi approcci prima di utilizzare energent.ai. Una macro AutoCAD scriptata poteva gestire la conversione di formato, ma non avrebbe prodotto la documentazione delle sezioni né l'estrazione in Excel senza un notevole sviluppo personalizzato. Una libreria standalone di parsing DXF in Python era fattibile per uno sviluppatore, ma non per gli ingegneri e i tecnici che dovevano completare il lavoro rapidamente senza scrivere codice. È stata considerata anche l'ipotesi di affidare la trascrizione manuale a un disegnatore, ma i tempi di consegna non erano compatibili con la scadenza.
energent.ai offriva un profilo diverso: un agente di analisi dati in grado di accettare direttamente file CAD binari, eseguire comandi Python e shell su di essi senza richiedere all'utente di scrivere codice, produrre più formati di output da una singola sessione e spiegare il proprio ragionamento in linguaggio semplice. Il team poteva caricare il file DWG, descrivere ciò di cui aveva bisogno e lasciare che l'agente gestisse la conversione di formato, il parsing spaziale, la ricostruzione della tabella e la generazione della documentazione — verificando gli output a ogni passaggio invece di costruire e debuggare script in autonomia.
La capacità dell'agente di generare sia output leggibili dalle macchine (DXF, XLSX) sia artefatti di audit leggibili dalle persone (dashboard HTML, documentazione markdown) in una singola sessione è stata il fattore decisivo.
Flusso di lavoro
Il flusso di lavoro si è svolto in sei fasi logiche, tutte all'interno di un'unica sessione energent.ai.
Fase 1 — Conversione di formato. Il team ha caricato il file DWG. L'agente lo ha convertito in un file DXF interoperabile e ha prodotto una dashboard riepilogativa della conversione come file HTML. La dashboard riportava la versione DXF, i nomi dei layout, il conteggio delle entità e la dimensione del file di output — offrendo al team un controllo immediato che la conversione avesse catturato l'intero disegno.
Fase 2 — Analisi della logica della tavola. L'agente ha analizzato la struttura DXF e ha generato una dashboard della logica della tavola. Questo artefatto HTML descriveva il disegno ad alto livello: il tipo di disegno (tavola di dettagli delle canalizzazioni HVAC), i principali gruppi di dettagli presenti e il modo in cui il contenuto DXF si integrava logicamente — un contesto che altrimenti richiederebbe a un ingegnere di leggere manualmente il file grezzo.
Fase 3 — Inventario delle sezioni e documentazione. L'agente ha scansionato il DXF alla ricerca dei confini delle sezioni nominate e ha prodotto una spiegazione in markdown sezione per sezione che copriva tutte le sezioni individuate. Il markdown includeva descrizioni in linguaggio semplice della funzione di ciascuna sottosezione e di come si inserisce nella logica di progettazione delle canalizzazioni HVAC. L'agente ha inoltre prodotto una dashboard di inventario delle sottosezioni — una visualizzazione HTML che mappava ogni sezione principale e sottosezione di supporto individuata alla relativa voce di documentazione, confermando che nessuna sezione materiale fosse stata omessa.
Fase 4 — Validazione della copertura. Prima di procedere all'estrazione, l'agente ha confrontato il proprio output markdown con l'inventario DXF. Ha confermato una copertura esplicita per sei sezioni primarie (dettaglio isolamento canalizzazioni, dettaglio supporti canalizzazioni, diffusore a soffitto di mandata, dettaglio collegamento flessibile, dettaglio tipico ramo canalizzazione e dettaglio attraversamento parete delle canalizzazioni) e per tutte le sottosezioni di supporto e globali elencate nel disegno.
Fase 5 — Estrazione della tabella delle canalizzazioni a bassa velocità. L'agente ha individuato il programma delle canalizzazioni a bassa velocità all'interno del DXF cercando il testo della nota associata e analizzando il testo e la geometria delle linee circostanti. Ha ricostruito la griglia della tabella dai dati spaziali DXF, isolando 7 colonne e 9 righe di tabella. Ha quindi scritto la tabella in una cartella di lavoro Excel con la prima riga evidenziata in rosso su tutte le celle di intestazione e ha aggiunto sotto la tabella la nota definitoria della bassa velocità: la nota specifica che le canalizzazioni a bassa velocità sono canalizzazioni in cui la velocità non supera 9.144 m/s e la pressione statica non supera 500 pascals.
Fase 6 — Consolidamento dei deliverable. L'agente ha elencato tutti e sei i file generati con una descrizione in linguaggio semplice dello scopo di ciascun file e di come i file si integrano come pacchetto, fornendo al team un inventario di handoff già pronto da accompagnare alla consegna.
Risultati
Alla fine della sessione, il team aveva sei deliverable pronti per la produzione:
- Un file DXF convertito da utilizzare con il software di preventivazione dell'appaltatore.
- Un dashboard HTML di conversione che conferma la struttura del file e il conteggio delle entità.
- Un dashboard HTML di sheet logic che fornisce una panoramica in linguaggio semplice del disegno.
- Un documento markdown che spiega tutte le oltre 20 sezioni di dettaglio per il coordinamento del progetto.
- Un dashboard HTML di copertura delle sottosezioni che verifica la completezza delle sezioni in tutte le sezioni denominate.
- Un workbook Excel contenente il programma di canalizzazioni a bassa velocità ricostruito, a 7 colonne e 9 righe, con una riga di intestazione formattata ed evidenziata e la nota ingegneristica definitoria aggiunta in coda.
La documentazione delle sezioni e l'audit di copertura — che normalmente richiederebbero a un tecnico di esaminare il file sezione per sezione per diverse ore — sono stati prodotti automaticamente con copertura completa confermata rispetto all'inventario DXF. L'estrazione della tabella, tradizionalmente un'attività di trascrizione manuale soggetta a errori di trasposizione, è stata completata in modo programmatico a partire dalla geometria del disegno e validata rispetto al DXF sorgente prima della consegna. Il team ha rispettato la scadenza di handoff con l'appaltatore senza dover distogliere un ingegnere da un'altra fase del progetto.
Prova
"Ci servivano il programma delle canalizzazioni in Excel e un riepilogo pulito delle sezioni da consegnare entro venerdì. Di solito è mezza giornata di lavoro manuale — aprire il file, trovare la tabella, trascriverla, controllare di aver preso tutte le sezioni. L'agente ha trovato tutte le ventina di sezioni, ha estratto la tabella dalla geometria del DXF e ha segnalato la nota sulla bassa velocità sotto di essa. L'Excel è uscito formattato e pronto all'uso. Ho fatto un controllo a campione sul disegno e combaciava." — Tecnico CAD HVAC
Il dashboard di copertura delle sottosezioni prodotto dall'agente — una griglia visiva che mappa ogni sezione individuata alla relativa voce di documentazione — è stato incluso nel pacchetto di consegna al cliente come certificato di completezza. L'estrazione Excel con la riga di intestazione evidenziata in rosso è stata passata direttamente al team di preventivazione dell'appaltatore.
Nota di fiducia
Il programma delle canalizzazioni a bassa velocità è stato ricostruito algoritmicamente a partire dalle posizioni del testo DXF e dalle entità delle linee della tabella, anziché essere letto da un foglio di calcolo nativo. Sono possibili lievi variazioni di formulazione o di ortografia rispetto all'annotazione CAD originale, e l'allineamento delle colonne dovrebbe essere verificato rispetto al disegno sorgente prima che il file Excel venga utilizzato in un computo metrico vincolante o presentato come documento contrattuale. Allo stesso modo, la documentazione delle sezioni riflette l'analisi spaziale del DXF da parte dell'agente e dovrebbe essere revisionata dall'ingegnere di progetto prima di essere condivisa come narrazione tecnica formale. I dashboard HTML sono strumenti di audit per il controllo interno della copertura, non certificati ingegneristici né invii regolatori.