Come l'AI genera script Revit che funzionano davvero
L'AI scrive codice Revit da anni. Il problema è che spesso non funziona. Non perché il modello sia scarso — ma perché la Revit API ha comportamenti non documentati che si imparano solo sul campo.
Il problema con l'AI e la Revit API
Chiunque abbia provato a usare un AI coding assistant per scrivere script Revit conosce il risultato tipico: codice che sembra corretto, compila, ma al primo reload si inceppa. Errori di Transaction, parametri sbagliati, struttura pyRevit da rifare da zero.
Non è un problema di capacità del modello. È un problema di contesto. La Revit API ha comportamenti non documentati che si imparano solo sul campo — e i modelli AI, addestrati su documentazione pubblica spesso incompleta o datata, non li conoscono.
Il risultato è un ciclo frustrante
scrivi centinaia di righe, testi, aggiusti, ricarichi, aggiusti ancora. Ore di debug per automazioni che dovrebbero richiedere minuti.
Cosa sono le skills per AI coding assistant
Gli AI coding assistant moderni — come Claude, Cursor o GitHub Copilot — supportano un meccanismo chiamato skill (o custom instruction, o rule set, a seconda della piattaforma): un insieme di istruzioni, pattern e file di riferimento che il modello consulta prima di generare codice.
Una skill ben costruita non dice semplicemente "scrivi in Python". Definisce la struttura attesa, i pattern da seguire, i casi limite da gestire, e può includere file di reference con soluzioni già testate su casi reali.
La differenza tra un AI senza skill e uno con skill specializzata è la stessa che passa tra un junior che ha letto la documentazione e un senior che ha risolto quel problema tre volte in produzione.
bim-automator: la skill che abbiamo costruito per pyRevit
In VisionXt abbiamo sviluppato bim-automator, una skill per la generazione automatica di script pyRevit orientata all'uso professionale in ambito AEC.
Il funzionamento è semplice nella forma, solido nella sostanza:
Prima di scrivere codice, la skill interroga la documentazione Revit API aggiornata
Poi applica pattern da file di reference costruiti internamente nel tempo
Quei file non sono esempi scritti per l'occasione. Vengono da anni di ricerca e test su progetti reali — cantieri, coordinamenti, migrazioni di modelli — dove la documentazione ufficiale non bastava. Workaround trovati dopo debug lunghi. Soluzioni che funzionano perché qualcuno le ha già fatte girare su Revit.
Descrivi l'automazione in linguaggio naturale, e lo script esce già con boilerplate corretto, Transaction, error handling, struttura pyRevit input/output e icona. Dal prompt al primo reload funzionante in pochi minuti.
Cosa significa per chi gestisce progetti e team
Per un BIM Manager, un PM o il titolare di uno studio, il vantaggio non è solo tecnico.
Il tempo risparmiato non riguarda solo la scrittura del codice — riguarda tutto il ciclo che normalmente viene prima: capire quale BuiltInParameter usare, come strutturare la query sul modello, dove la Revit API si comporta in modo controintuitivo. Ricerca che in passato richiedeva ore, spesso affidata alle persone più esperte del team.
Con bim-automator, quella conoscenza è già integrata. Non è necessario che ogni sviluppatore parta da zero o che il senior debba supervisionare ogni script.
Il beneficio reale è la scalabilità della competenza
Automazioni di qualità accessibili più in fretta, con meno dipendenza dalle figure più specializzate.
Il nostro approccio in VisionXt
Quello che abbiamo costruito con bim-automator riflette la filosofia con cui lavoriamo: l'AI è utile quando è addestrata su conoscenza reale, non generica.
In VisionXt affianchiamo studi professionali, imprese di costruzioni e team BIM che vogliono portare l'automazione Revit a un livello successivo — con soluzioni basate su anni di esperienza applicata nel settore AEC italiano.
I servizi che offriamo in questo ambito includono:
Sviluppo di script e tool pyRevit personalizzati
Implementazione di workflow AI per automazione BIM
Formazione e consulenza strategica per team BIM
Se stai valutando come rendere più efficiente il tuo flusso di lavoro su Revit, o vuoi capire cosa è realisticamente automatizzabile nel tuo contesto, siamo disponibili per una prima conversazione.
