Se rendre au contenu

Pour commencer

Outils personnalisés

Gardez les scripts en lesquels vous avez confiance dans un dossier : votre assistant IA voit chacun d'eux comme un outil à part entière. Au lieu d'écrire du nouveau code à chaque fois, il exécute par son nom le script que vous avez vérifié.

Comment ça fonctionne

1

Enregistrez un script

Mettez un script dans Documents\AEC Pilot\Custom Tools. Chaque fichier est un outil.

2

L'assistant le voit

L'assistant le voit comme custom_ plus le nom de l'outil et l'exécute avec les arguments que vous décrivez dans le fichier.

3

Vous l'approuvez

La fenêtre d'approbation affiche le fichier entier avant son exécution.

4

Il s'exécute dans votre application

Votre script vérifié s'exécute dans Revit, AutoCAD, Navisworks ou l'application dans laquelle vous travaillez.

  • Il fonctionne avec Claude, ChatGPT / Codex, Cursor et d'autres clients MCP, et dans Pilot Chat.
  • Les modifications apportées au dossier sont prises en compte pendant que l'application est ouverte.
  • Settings > Security > Custom tools affiche ce qui est chargé, indique pourquoi un fichier ne l'est pas et ouvre le dossier. La première fois, il crée le dossier avec un court fichier d'explications.

Quelle langue

C#

RevitAutoCADCivil 3DAdvance SteelNavisworksInventorRobot

MAXScript

3ds Max

Python

Fusion

Le script est écrit de la même manière que le code que l'assistant exécute dans cette application, avec les arguments dans args.

Un fichier, un outil

Les premières lignes du fichier sont des commentaires qui décrivent l'outil. Cet exemple Revit liste les feuilles dont le numéro ne commence pas par un préfixe donné :

// 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: le nom, de 3 à 40 lettres minuscules, chiffres ou underscores, commençant par une lettre.
  • description: ce que fait l'outil, dans n'importe quelle langue, jusqu'à 400 caractères. L'assistant le lit pour choisir l'outil.
  • products: où il s'exécute : revit, autocad, civil3d, advancesteel, navisworks, inventor, robot, 3dsmax, fusion. autocad couvre également Civil 3D et Advance Steel.
  • readonly: true lorsque le script ne fait que lire le modèle.
  • param: une ligne par argument : nom, type (string, number, integer, boolean), obligatoire ou facultatif, une valeur par défaut éventuelle et un court texte.

L'assistant le voit comme custom_check_sheet_names, avec un argument de préfixe.

Laissez l'assistant l'enregistrer

Lorsqu'un script fonctionne, demandez à l'assistant de l'enregistrer comme outil personnalisé. AEC Pilot vérifie le fichier, vous le montre en entier et ne l'enregistre que si vous choisissez Save. Il demande à chaque fois et n'écrit que dans votre propre dossier.

Dans Fusion

Le fichier à enregistrer doit tenir dans la boîte de dialogue de Fusion (40 lignes). Un outil plus long peut être placé dans le dossier à la main.

Sécurité : un outil personnalisé est du code

Settings > Security > Allow custom code doit être activé. Lorsqu'il est désactivé, les outils personnalisés ne s'exécutent pas.

Avant qu'un outil personnalisé ne s'exécute, la fenêtre d'approbation affiche ses arguments et le fichier entier, sauf si vous avez choisi Don't ask again.

Seul le fichier qui vous a été montré s'exécute. S'il change pendant que la fenêtre est ouverte, l'appel est refusé et demandé à nouveau.

Il passe par les mêmes vérifications que tout code d'un assistant. Dans les applications qui ont un contrôle de sécurité, les appels risqués tels que la suppression de fichiers ou le démarrage de programmes sont refusés.

En mode lecture seule, les outils personnalisés sont désactivés.

Pour l'informatique : un dossier partagé pour le bureau

Définissez la valeur de la politique CustomToolsFolder (REG_SZ) sous HKEY_LOCAL_MACHINE\SOFTWARE\Policies\7Dimensions\AEC Pilot, ou sous HKEY_CURRENT_USER, vers un dossier que tout le monde peut lire, par exemple un partage réseau. Les variables d'environnement sont développées.

Dossier du bureau

Défini par l'informatique, lisible par tous, par exemple un partage réseau.

Votre dossier

Documents\AEC Pilot\Custom Tools

Votre assistant

Voit les outils des deux dossiers.

Même nom : l'outil du bureau l'emporte

  • Les outils dans le dossier partagé sont marqués comme partagés pour l'assistant.
  • Lorsqu'un outil partagé et un outil propre à l'utilisateur ont le même nom, l'outil partagé est utilisé.
  • L'enregistrement depuis l'assistant ne remplace jamais un outil partagé.

Limites

40

outils personnalisés par application

64 KB

par fichier

12

arguments par outil

400

caractères de description

  • Chaque outil est envoyé à l'assistant à chaque demande ; la liste reste donc courte.
  • Seul le niveau supérieur du dossier est lu ; les sous-dossiers sont ignorés.
  • Un fichier qui ne respecte pas ces limites n'est pas chargé ; Settings indique pourquoi.

Nouveaux outils et votre assistant

Pilot Chat voit un nouvel outil ou un outil modifié à partir de son prochain message. Un assistant externe conserve la liste des outils qui lui a été donnée : reconnectez-le à AEC Pilot pour voir de nouveaux outils.

Connecter votre client IA · Comment demander · Pour les administrateurs informatiques