Zum Inhalt springen

Dokumentation

Hier anfangen

Nach Produkt

Wenn etwas schiefgeht

Sie suchen, was ein bestimmtes Werkzeug tut? Die Toolbox listet jedes davon auf.

Hier anfangen

Benutzerdefinierte Tools

Bewahren Sie die Skripte, denen Sie vertrauen, in einem Ordner auf, und Ihr AI-Assistent erhält jedes als eigenes Tool. Anstatt jedes Mal neuen Code zu schreiben, führt er Ihr überprüftes Skript nach Namen aus.

Wie es funktioniert

1

Skript speichern

Legen Sie ein Skript in Documents\AEC Pilot\Custom Tools. Jede Datei ist ein Tool.

2

Der Assistent sieht es

Der Assistent sieht es als custom_ plus den Namen des Tools und führt es mit den Argumenten aus, die Sie in der Datei beschreiben.

3

Sie geben es frei

Das Genehmigungsfenster zeigt die ganze Datei, bevor sie ausgeführt wird.

4

Es läuft in Ihrer Anwendung

Ihr geprüftes Skript läuft in Revit, AutoCAD, Navisworks oder der Anwendung, in der Sie gerade arbeiten.

  • Es funktioniert mit Claude, ChatGPT / Codex, Cursor und anderen MCP-Clients sowie in Pilot Chat.
  • Änderungen im Ordner werden erfasst, während die Anwendung geöffnet ist.
  • Settings > Security > Custom tools zeigt, was geladen ist, nennt den Grund, wenn eine Datei nicht geladen wurde, und öffnet den Ordner. Beim ersten Mal legt es den Ordner mit einer kurzen Anleitung an.

Welche Sprache

C#

RevitAutoCADCivil 3DAdvance SteelNavisworksInventorRobot

MAXScript

3ds Max

Python

Fusion

Das Skript wird auf die gleiche Weise geschrieben wie der Code, den der Assistent in dieser Anwendung ausführt, mit den Argumenten in args.

Eine Datei, ein Tool

Die ersten Zeilen der Datei sind Kommentare, die das Tool beschreiben. Dieses Revit-Beispiel listet die Blätter auf, deren Nummer nicht mit einem bestimmten Präfix beginnt:

// 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: der Name, 3 bis 40 Kleinbuchstaben, Ziffern oder Unterstriche, beginnend mit einem Buchstaben.
  • description: was das Tool tut, in jeder Sprache, bis zu 400 Zeichen. Der Assistent liest es, um das Tool auszuwählen.
  • products: wo es läuft: revit, autocad, civil3d, advancesteel, navisworks, inventor, robot, 3dsmax, fusion. autocad umfasst auch Civil 3D und Advance Steel.
  • readonly: true wenn das Skript nur das Modell liest.
  • param: eine Zeile pro Argument: Name, Typ (string, number, integer, boolean), erforderlich oder optional, ein optionaler Standardwert und ein kurzer Text.

Der Assistent sieht es als custom_check_sheet_names, mit einem Präfix-Argument.

Lassen Sie den Assistenten es speichern

Wenn ein Skript funktioniert, bitten Sie den Assistenten, es als benutzerdefiniertes Tool zu speichern. AEC Pilot prüft die Datei, zeigt sie Ihnen vollständig und speichert sie nur, wenn Sie Save wählen. Es fragt jedes Mal und schreibt nur in Ihren eigenen Ordner.

In Fusion

Die zu speichernde Datei muss in das Fragefenster von Fusion passen (40 Zeilen). Ein längeres Tool können Sie von Hand in den Ordner legen.

Sicherheit: ein benutzerdefiniertes Tool ist Code

Settings > Security > Allow custom code muss eingeschaltet sein. Ist es ausgeschaltet, laufen benutzerdefinierte Tools nicht.

Bevor ein benutzerdefiniertes Tool ausgeführt wird, zeigt das Genehmigungsfenster seine Argumente und die gesamte Datei, es sei denn, Sie haben Don't ask again gewählt.

Nur die Datei, die Ihnen angezeigt wurde, wird ausgeführt. Wenn sie sich ändert, während das Fenster geöffnet ist, wird der Aufruf abgelehnt und erneut gefragt.

Es durchläuft die gleichen Prüfungen wie jeder Code von einem Assistenten. In den Anwendungen, die eine Sicherheitsprüfung haben, werden riskante Aufrufe wie das Löschen von Dateien oder das Starten von Programmen abgelehnt.

Im Nur-Lesen-Modus sind benutzerdefinierte Tools deaktiviert.

Für IT: ein gemeinsamer Ordner für das Büro

Setzen Sie den Richtlinienwert CustomToolsFolder (REG_SZ) unter HKEY_LOCAL_MACHINE\SOFTWARE\Policies\7Dimensions\AEC Pilot oder unter HKEY_CURRENT_USER auf einen Ordner, den alle lesen können, zum Beispiel eine Netzwerkfreigabe. Umgebungsvariablen werden aufgelöst.

Büroordner

Von der IT festgelegt, von allen lesbar, zum Beispiel eine Netzwerkfreigabe.

Ihr Ordner

Documents\AEC Pilot\Custom Tools

Ihr Assistent

Sieht die Tools beider Ordner.

Gleicher Name: das Büro-Tool hat Vorrang

  • Tools im gemeinsamen Ordner sind für den Assistenten als gemeinsam markiert.
  • Wenn ein gemeinsames Tool und ein eigenes Tool des Benutzers denselben Namen haben, wird das gemeinsame verwendet.
  • Das Speichern vom Assistenten überschreibt niemals ein gemeinsames Tool.

Grenzen

40

benutzerdefinierte Tools pro Anwendung

64 KB

pro Datei

12

Argumente pro Tool

400

Zeichen Beschreibung

  • Jedes Tool wird mit jeder Anfrage an den Assistenten gesendet, deshalb bleibt die Liste kurz.
  • Nur die oberste Ebene des Ordners wird gelesen; Unterordner werden ignoriert.
  • Eine Datei, die diese Grenzen nicht einhält, wird nicht geladen; Settings zeigt den Grund.

Neue Tools und Ihr Assistent

Pilot Chat sieht ein neues oder geändertes Tool ab der nächsten Nachricht. Ein externer Assistent behält die Tool-Liste, die er beim Verbinden erhalten hat: Verbinden Sie ihn erneut mit AEC Pilot, damit er neue Tools sieht.

AI-Client verbinden · Richtig fragen · Für IT-Administratoren