Kurz gesagt
- dll2llm ist ein Kommandozeilen-Tool, das .NET-Assemblies analysieren und daraus einen Agent-Skill-Ordner erstellen kann.
- Dem Tool kann RevitAPI.dll übergeben werden; wenn auch die Benutzeroberflächenebene benötigt wird, lässt sich RevitAPIUI.dll hinzufügen.
- Der erzeugte Ordner enthält SKILL.md, INDEX.md und nach Namespaces geordnete Themendateien.
- Für Änderungen in Revit ist eine Transaction erforderlich; eine SubTransaction kann innerhalb einer offenen Transaction verwendet werden.
Was erfahren Sie in diesem Leitfaden?
Ein KI-Agent, der mit der Revit API arbeitet, kann nicht immer allein auf Grundlage allgemeinen Programmierwissens die richtigen Klassen und Methoden auswählen. Im Leitfaden von Autodesk Platform Services (APS) wird dies mit fehlendem API-Kontext erklärt: Selbst wenn ein Agent einige gängige Typen kennt, kann er weniger häufig verwendete Methoden falsch einschätzen. Da die Revit API zahlreiche Klassen und Namespaces umfasst, ist es zudem möglicherweise keine praktikable Lösung, sämtliche Informationen in einer einzigen Textdatei bereitzustellen.
In diesem Tutorial beschäftigen wir uns mit dem Ansatz, aus Revit-API-Assemblies einen Agent-Skill-Ordner zu erstellen, und damit, wie dieser Ordner bei der Entwicklung von Agenten eingesetzt werden kann. Ziel ist nicht, die Revit-Automatisierung von Anfang bis Ende einzurichten, sondern dem Agenten einen besser strukturierten und durchsuchbaren API-Kontext bereitzustellen. Als Werkzeug dafür führt der Autodesk-Leitfaden das Kommandozeilen-Tool dll2llm an.
Voraussetzungen und Einschränkungen
Für den Workflow ist der Zugriff auf Revit-API-Assemblies erforderlich. Der APS-Leitfaden beschreibt, wie das Tool auf die Datei RevitAPI.dll angesetzt wird und wie sich RevitAPIUI.dll hinzufügen lässt, wenn auch die Benutzeroberflächenebene benötigt wird. Der Leitfaden zeigt außerdem, wie die Quelldateien aus einem Revit-Installationsverzeichnis bezogen und anschließend zur Erstellung des Skill-Ordners verwendet werden.
Das Tool wird als GitHub-Projekt namens dll2llm vorgestellt. Es analysiert eine .NET-Assembly und wandelt sie in Agent-Skill-Dateien um. Im Ausgangstext werden weder ein unterstütztes Betriebssystem noch eine erforderliche .NET-Version, eine Kompatibilitätsmatrix für Revit-Versionen, Installationsbefehle oder ein bestimmtes Agent-Produkt genannt. Daher wäre es nicht richtig, hier Befehle, Menüpfade oder Versionsannahmen anzugeben. Prüfen Sie vor der Umsetzung die aktuelle Dokumentation des dll2llm-Projekts und die DLL-Dateien Ihrer Revit-Installation.
Als grundlegende Dateien des erzeugten Ordners nennt der offizielle Leitfaden SKILL.md, INDEX.md und thematische Markdown-Dateien. Die Themendateien sind nach Namespaces geordnet; umfangreiche Namespaces können alphabetisch aufgeteilt werden, damit das Kontextfenster nicht übermäßig gefüllt wird. Da die Quelle keine Kontoanforderung nennt, geht dieses Tutorial auch nicht von einer solchen aus.
Agent Skill Schritt für Schritt erstellen
Legen Sie das Ziel fest. Definieren Sie zunächst, bei welchen Aufgaben mit der Revit API der Agent unterstützen soll. Für das Lesen von Modelldaten, das Filtern von Elementen oder Änderungen am Modell in einem Plug-in können beispielsweise unterschiedliche API-Kenntnisse erforderlich sein. Autodesk stellt den Agent Skill als Methode vor, dem Agenten API-Kontext bereitzustellen; das Tool selbst bestimmt nicht die Projektanforderungen.
Wählen Sie die benötigten Assemblies aus. RevitAPI.dll ist die grundlegende Eingabe und enthält die Datenbankebene der Revit API. Wenn der Agent auch Informationen zur Benutzeroberflächenebene benötigt, sollten Sie RevitAPIUI.dll hinzufügen. Im APS-Artikel wird angegeben, dass die zweite Datei optional verwendet werden kann. Gehen Sie nicht davon aus, dass beide Assemblies für jede Aufgabe zwingend erforderlich sind; der Projektbedarf bestimmt den Umfang.
Prüfen Sie das dll2llm-Projekt. Das Tool wird als GitHub-Projekt dll2llm vorgestellt. Da der Ausgangstext keine Angaben zur Installation und Ausführung enthält, geben wir hier keinen bestimmten Terminalbefehl an. Folgen Sie den Anweisungen des Projekts und prüfen Sie, welchen Assembly-Pfad das Tool als Eingabe erwartet.
Übergeben Sie dem Tool die Assembly. Im Workflow des APS-Leitfadens wird dll2llm auf die Assemblies im Revit-Installationsverzeichnis angesetzt. Wählen Sie RevitAPI.dll und, falls erforderlich, RevitAPIUI.dll aus und lassen Sie die Ausgabe des Tools in einem separaten Skill-Ordner ablegen. Laut Leitfaden werden die Dateien in der erzeugten Struktur nach Namespaces unterteilt. Die Ausgabe muss daher nicht aus einem einzigen langen API-Dokument bestehen.
Prüfen Sie die erzeugten Dateien. Vergewissern Sie sich, dass neben SKILL.md und INDEX.md auch die thematischen Markdown-Dateien vorhanden sind. Diese enthalten nach Namespaces gegliederte API-Informationen. Die mögliche alphabetische Aufteilung umfangreicher Namespaces hilft dabei, zu vermeiden, dass der Agentenkontext zu einem einzigen großen Inhaltsblock wird. Behandeln Sie die Dateien nicht allein deshalb als geprüfte Codebeispiele, weil sie erzeugt wurden: Das Tool stellt API-Kontext bereit, testet aber nicht Ihre Projektlogik.
Binden Sie den Skill in den Agenten-Workflow ein. Mit dem Ansatz von Autodesk kann der Agent nach der Einrichtung während einer Aufgabe auf die Revit-API-Referenz zurückgreifen. Dadurch soll das wiederholte Kopieren und Einfügen einzelner Codeausschnitte aus dem Chatfenster reduziert und dem Agenten ein breiterer API-Kontext zugänglich gemacht werden. Welche Agenten das Skill-Format unterstützen und wie die Einrichtung erfolgt, wird in dieser Quelle nicht erläutert. Orientieren Sie sich an den Anweisungen Ihrer Umgebung.
Testen Sie Codevorschläge mit kleinen Aufgaben. Vertrauen Sie dem vom Agenten erzeugten Code nicht ungeprüft. Prüfen Sie zunächst, ob Klassen- und Methodennamen mit der erzeugten Referenz übereinstimmen, und anschließend, ob der Vorgang im Zielmodell das erwartete Ergebnis liefert. Achten Sie bei Code, der das Modell ändert, besonders auf die Transaktionsverwaltung: Um Änderungen am Modell vorzunehmen, ist in Revit eine Transaction erforderlich, und es kann immer nur eine Transaction gleichzeitig geöffnet sein. Nach erfolgreichem Abschluss werden Änderungen mit Commit gespeichert; RollBack macht Änderungen rückgängig. Die Revit-API-Dokumentation erläutert zudem, dass sich die Zustände dieser Vorgänge überprüfen lassen.
Häufige Fehler
API-Kontext mit Projektvalidierung verwechseln: Der Skill stellt dem Agenten Informationen zu API-Typen und Namespaces bereit; er beweist nicht, dass der erzeugte Code in einem Projekt korrekt funktioniert. Testen Sie gesondert, was der Code im Modell tatsächlich bewirkt.
Die Transaktionsstruktur außer Acht lassen: Vorgänge, die das Modell ändern, müssen im Kontext einer Transaction ausgeführt werden. Eine SubTransaction kann dazu dienen, einen größeren Vorgang in logische Teile zu untergliedern. Sie muss jedoch innerhalb einer offenen Transaction erstellt und geschlossen werden, bevor die übergeordnete Transaktion beendet wird. Eine TransactionGroup kann mehrere unabhängige Vorgänge gemeinsam behandeln; sie kann nicht gestartet werden, solange eine Transaction geöffnet ist.
Unnötige Dateien hinzufügen: Der Leitfaden beschreibt RevitAPIUI.dll als zusätzliche Eingabe, die verwendet werden kann, wenn auch die Benutzeroberflächenebene benötigt wird. Richten Sie den Umfang des Skills an der jeweiligen Aufgabe aus, statt Inhalte hinzuzufügen, die nicht benötigt werden.
Versions- und Installationsdetails voraussetzen: Der APS-Artikel enthält weder eine detaillierte Kompatibilitätstabelle noch einen Installationsbefehl. Notieren Sie daher die Quelle der verwendeten Revit-Assembly, folgen Sie den Anweisungen von dll2llm und gehen Sie nicht davon aus, dass andere Versionen dieselbe Ausgabe erzeugen.
Nächste Schritte: Workflows für Architektur und Visualisierung
BIM-Teams, Plug-in-Entwickler und API-Lernende, die in Revit wiederkehrende Aufgaben zur Datenextraktion oder Modellbearbeitung ausführen, können von dieser Methode profitieren. Wenn der Agent API-Klassen besser findet, kann das dabei helfen, falsche Methodenschätzungen beim Schreiben von Prototypen zu reduzieren. Modellprüfungen, Code-Reviews oder Tests des Workflows unter realen Projektbedingungen werden dadurch jedoch nicht überflüssig. In Architektur- und Innenarchitekturbüros kann der Nutzen besonders bei der Entwicklung interner Automatisierungen und bei der Suche nach Referenzen durch Teammitglieder entstehen, die gerade erst mit der API beginnen.
Der Revit API Agent Skill ist keine Funktion, die unmittelbar die Renderqualität verbessert; er richtet sich an Software- und Automatisierungsprozesse, die mit Modelldaten arbeiten. Für Visualisierungsteams kann er bei der Entwicklung von Werkzeugen zum Abruf von Informationen aus Revit oder zur Automatisierung von Modelländerungen relevant sein. Angaben zu Hardware-, Lizenz- oder Agentenabonnementkosten sind in den Quellen nicht enthalten. Prüfen Sie vor der Umsetzung gesondert die bestehenden Softwarebedingungen und die Skill-Unterstützung Ihrer Agentenumgebung.
Quelle und Lizenz
Dieses Tutorial basiert auf den Erläuterungen zu dll2llm und Agent Skills im Leitfaden „Let AI Write Your Revit Code“ von Autodesk Platform Services sowie auf den Definitionen von Transaction, SubTransaction und TransactionGroup in der Revit-API-Dokumentation von Autodesk. Die Quellen sind mit Lizenz=frei angegeben; Text und Schritte wurden eigenständig neu formuliert. Die Kursbeschreibung von Autodesk University für Revit-API-Einsteiger wurde herangezogen, um den Lernumfang zu API, Filterung und Transaction einzuordnen.
Quellen
3 QuellenQuelltexte werden nicht neu veröffentlicht; kurze Zitate sind gekennzeichnet, der Rest ist eigene Zusammenfassung und Einordnung.
Für Büros und Studierende in der Türkei, die mit Revit arbeiten, liegt der praktische Wert des Agent-Skill-Ansatzes darin, eine systematischere API-Referenz in den Agenten-Workflow einzubinden. Besonders Teams, die an wiederkehrenden Aufgaben mit Modelldaten oder Plug-in-Prototypen arbeiten, können Codevorschläge schneller prüfen.
Der Skill-Ordner ist jedoch weder eine eigenständig lauffähige Automatisierung noch ein validiertes Plug-in. Der Zugriff auf DLLs, die Skill-Unterstützung der Agentenumgebung und die verwendeten Softwarebedingungen sollten vorab geprüft werden. Da die Quellen keine Angaben zu Hardware- oder Lizenzkosten enthalten, müssen diese Posten bei der Investitionsplanung gesondert geklärt werden.
Häufige Fragen
Welche Dateien werden für einen Revit API Agent Skill benötigt?
Der Leitfaden von Autodesk beschreibt, wie dll2llm die Datei RevitAPI.dll übergeben wird. Wenn auch die Benutzeroberflächenebene benötigt wird, kann RevitAPIUI.dll hinzugefügt werden.
Welche Dateien erzeugt dll2llm?
Laut APS-Leitfaden erstellt das Tool einen Skill-Ordner mit SKILL.md, INDEX.md und thematischen Markdown-Dateien, die nach Namespaces geordnet sind.
Ist eine Transaction für Code erforderlich, der das Revit-Modell ändert?
Ja. Laut Revit-API-Dokumentation ist für Änderungen am Modell eine Transaction erforderlich, und es kann immer nur eine Transaction gleichzeitig geöffnet sein.



