Comincia da qui
Per prodotto
Quando qualcosa va storto
Cerchi cosa fa un singolo strumento? La Toolbox li elenca tutti.
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
Salva uno script
Metti uno script in Documents\AEC Pilot\Custom Tools. Ogni file è uno strumento.
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.
Tu lo approvi
La finestra di approvazione mostra l'intero file prima che venga eseguito.
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#
MAXScript
Python
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.
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.
Collega il tuo client AI · Come chiedere · Per gli amministratori IT
