Passa al contenuto
In collaborazione conSOFiSTiK ItaliaScopri di più →

Comincia da qui

Strumenti personalizzati

Tieni gli script di cui ti fidi in una cartella, e il tuo assistente AI ottiene ciascuno come uno strumento proprio. Invece di scrivere nuovo codice ogni volta, esegue il tuo script controllato per nome.

Come funziona

1

Salva uno script

Metti uno script in Documents\AEC Pilot\Custom Tools. Ogni file è uno strumento.

2

L'assistente lo vede

L'assistente lo vede come custom_ più il nome dello strumento e lo esegue con gli argomenti che descrivi nel file.

3

Tu lo approvi

La finestra di approvazione mostra l'intero file prima che venga eseguito.

4

Viene eseguito nella tua applicazione

Il tuo script controllato viene eseguito in Revit, AutoCAD, Navisworks o nell'applicazione in cui lavori.

  • Funziona con Claude, ChatGPT / Codex, Cursor e altri client MCP, e in Pilot Chat.
  • Le modifiche alla cartella vengono rilevate mentre l'applicazione è aperta.
  • Settings > Security > Custom tools mostra cosa è caricato, indica perché un file non lo è e apre la cartella. La prima volta crea la cartella con un breve file di istruzioni.

Quale lingua

C#

RevitAutoCADCivil 3DAdvance SteelNavisworksInventorRobot

MAXScript

3ds Max

Python

Fusion

Lo script è scritto nello stesso modo del codice che l'assistente esegue in quell'applicazione, con gli argomenti in args.

Un file, uno strumento

Le prime righe del file sono commenti che descrivono lo strumento. Questo esempio di Revit elenca i fogli il cui numero non inizia con un dato prefisso:

// tool: check_sheet_names
// description: Lists the sheets whose number does not start with the given prefix.
// products: revit
// readonly: true
// param: prefix string required - The sheet number prefix, for example A-
string prefix = (string)args["prefix"];
return new FilteredElementCollector(doc).OfClass(typeof(ViewSheet)).Cast()
    .Where(s => !s.SheetNumber.StartsWith(prefix))
    .Select(s => s.SheetNumber + " " + s.Name).ToList();
  • tool: il nome, da 3 a 40 lettere minuscole, cifre o underscore, che inizia con una lettera.
  • description: cosa fa lo strumento, in qualsiasi lingua, fino a 400 caratteri. L'assistente lo legge per scegliere lo strumento.
  • products: dove viene eseguito: revit, autocad, civil3d, advancesteel, navisworks, inventor, robot, 3dsmax, fusion. autocad copre anche Civil 3D e Advance Steel.
  • readonly: true quando lo script legge solo il modello.
  • param: una riga per argomento: nome, tipo (string, number, integer, boolean), obbligatorio o facoltativo, un eventuale valore predefinito e un breve testo.

L'assistente lo vede come custom_check_sheet_names, con un argomento di prefisso.

Lascia che l'assistente lo salvi

Quando uno script funziona, chiedi all'assistente di salvarlo come strumento personalizzato. AEC Pilot controlla il file, te lo mostra per intero e lo salva solo se scegli Save. Lo chiede ogni volta e scrive solo nella tua cartella.

In Fusion

Il file da salvare deve stare nella finestra di domanda di Fusion (40 righe). Uno strumento più lungo puoi metterlo nella cartella a mano.

Sicurezza: uno strumento personalizzato è codice

Settings > Security > Allow custom code deve essere attivo. Quando è disattivato, gli strumenti personalizzati non vengono eseguiti.

Prima che uno strumento personalizzato venga eseguito, la finestra di approvazione mostra i suoi argomenti e l'intero file, a meno che tu non abbia scelto Don't ask again.

Solo il file che ti è stato mostrato viene eseguito. Se cambia mentre la finestra è aperta, la chiamata viene rifiutata e richiesta di nuovo.

Viene sottoposto agli stessi controlli di qualsiasi codice proveniente da un assistente. Nelle applicazioni che hanno un controllo di sicurezza, chiamate rischiose come la cancellazione di file o l'avvio di programmi vengono rifiutate.

In modalità di sola lettura, gli strumenti personalizzati sono disattivati.

Per IT: una cartella condivisa per l'ufficio

Imposta il valore della politica CustomToolsFolder (REG_SZ) sotto HKEY_LOCAL_MACHINE\SOFTWARE\Policies\7Dimensions\AEC Pilot, o sotto HKEY_CURRENT_USER, su una cartella che tutti possono leggere, ad esempio una condivisione di rete. Le variabili di ambiente vengono espanse.

Cartella dell'ufficio

Impostata dall'IT, leggibile da tutti, ad esempio una condivisione di rete.

La tua cartella

Documents\AEC Pilot\Custom Tools

Il tuo assistente

Vede gli strumenti di entrambe le cartelle.

Stesso nome: vince lo strumento dell'ufficio

  • Gli strumenti nella cartella condivisa sono contrassegnati come condivisi per l'assistente.
  • Quando uno strumento condiviso e uno strumento personale hanno lo stesso nome, viene utilizzato quello condiviso.
  • Il salvataggio dall'assistente non sovrascrive mai uno strumento condiviso.

Limiti

40

strumenti personalizzati per applicazione

64 KB

per file

12

argomenti per strumento

400

caratteri di descrizione

  • Ogni strumento viene inviato all'assistente con ogni richiesta, quindi l'elenco resta breve.
  • Solo il livello superiore della cartella viene letto; le sottocartelle vengono ignorate.
  • Un file che non rispetta questi limiti non viene caricato; Settings indica il motivo.

Nuovi strumenti e il tuo assistente

Pilot Chat vede un nuovo strumento o uno strumento modificato dal suo prossimo messaggio. Un assistente esterno mantiene l'elenco degli strumenti che gli è stato fornito: riconnettilo ad AEC Pilot per vedere nuovi strumenti.

Collega il tuo client AI · Come chiedere · Per gli amministratori IT