Dernières actualités
Blender Geometry Nodes : obtenir des données de surface et de collision avec Raycast NodeAfter Night There Is Nothing : une installation à trois dômes à SharjahGraphic Override Rules dans Archicad 29 : guide de créationAnalyser des images d’architecture avec Gemma 4 : installation et pratique en PythonCréer des chanfreins contrôlés et non destructifs avec le Bevel Modifier de BlenderAméliorer les performances de SketchUp : modélisation légère et transfert CAOGuide : exécuter un plug-in Revit dans le cloud avec APS Design AutomationComment créer un Agent Skill pour l’API Revit ? Guide dll2llmParamètres globaux et Parameters Service dans Revit : guide pratiqueGuide pour apprendre MAXScript dans 3ds Max : ouvrir et exécuter un script
TutorielsRevitdll2llm

Comment créer un Agent Skill pour l’API Revit ? Guide dll2llm

Le guide d’Autodesk APS présente un flux de travail utilisant dll2llm pour transmettre les connaissances de l’API Revit aux agents IA. Ce guide explique les fichiers nécessaires et les étapes à suivre.

Un concepteur travaille sur un modèle BIM dans un studio d’architectureImage IA
Image d’illustration générée par IA.Image : 3dsınıfı / FCA AI

En bref

  1. dll2llm est un outil en ligne de commande capable d’analyser des assemblies .NET pour créer un dossier Agent Skill.
  2. RevitAPI.dll peut être fourni à l’outil ; RevitAPIUI.dll peut aussi être ajouté si la couche d’interface utilisateur est nécessaire.
  3. Le dossier généré contient SKILL.md, INDEX.md et des fichiers thématiques organisés par espaces de noms.
  4. Les modifications apportées dans Revit nécessitent une Transaction ; une SubTransaction peut être utilisée à l’intérieur d’une Transaction ouverte.

Ce que vous apprendrez dans ce guide

Un agent IA qui utilise l’API Revit ne choisit pas toujours les bonnes classes et méthodes en s’appuyant uniquement sur des connaissances générales en programmation. Le guide d’Autodesk Platform Services (APS) explique ce problème par un manque de contexte sur l’API : même si l’agent connaît certains types courants, il peut deviner à tort des méthodes moins fréquemment utilisées. L’API Revit comprenant de nombreuses classes et espaces de noms, rassembler toutes ces informations dans un seul fichier texte n’est pas forcément une solution pratique.

Dans ce tutoriel, nous abordons une méthode pour créer un dossier Agent Skill à partir des assemblies de l’API Revit, ainsi que la façon d’utiliser ce dossier dans le développement d’agents. L’objectif n’est pas de mettre en place une automatisation Revit complète, mais de fournir à l’agent un contexte sur l’API mieux organisé et plus facile à consulter. Le guide d’Autodesk prend pour exemple l’outil en ligne de commande dll2llm.

Prérequis et limites

Ce flux de travail nécessite d’accéder à l’assembly de l’API Revit. Le guide APS explique qu’il faut fournir le fichier RevitAPI.dll à l’outil et ajouter RevitAPIUI.dll si la couche d’interface utilisateur est également nécessaire. Le guide présente aussi une démonstration où les fichiers sources sont récupérés dans un répertoire d’installation de Revit avant la génération du dossier de compétences.

L’outil est présenté comme le projet GitHub dll2llm. Il analyse un assembly .NET et le convertit en fichiers Agent Skill. La source ne précise pas les systèmes d’exploitation pris en charge, la version .NET requise, la matrice de compatibilité des versions de Revit, les commandes d’installation ni un produit d’agent en particulier. Il serait donc inapproprié de supposer un chemin de menu, une commande ou une version. Avant de commencer, consultez la description actuelle du projet dll2llm et vérifiez les fichiers DLL de l’installation de Revit utilisée.

Le guide officiel cite SKILL.md, INDEX.md et des fichiers Markdown thématiques parmi les fichiers principaux du dossier généré. Les fichiers thématiques sont organisés par espaces de noms ; les espaces de noms volumineux peuvent être divisés en sections alphabétiques afin d’éviter de surcharger la fenêtre de contexte. Comme la source ne mentionne aucune exigence de compte, ce tutoriel ne suppose pas qu’un compte soit nécessaire.

Créer un Agent Skill étape par étape

  1. Définissez l’objectif. Commencez par déterminer les tâches liées à l’API Revit pour lesquelles l’agent devra apporter son aide. Par exemple, lire les données d’un modèle, filtrer des éléments ou modifier le modèle dans un plug-in peut nécessiter des connaissances différentes de l’API. Autodesk présente l’Agent Skill comme un moyen de fournir le contexte de l’API à l’agent ; l’outil ne définit pas les exigences du projet à votre place.

  2. Choisissez les assemblies nécessaires. RevitAPI.dll est l’entrée de base contenant la couche de base de données de l’API Revit. Si l’agent a également besoin d’informations sur la couche d’interface utilisateur, envisagez d’ajouter RevitAPIUI.dll. L’article d’APS indique que ce second fichier peut être utilisé de manière facultative. Ne partez pas du principe que les deux assemblies sont nécessaires pour chaque tâche : c’est le périmètre du projet qui doit guider votre choix.

  3. Consultez le projet dll2llm. L’outil est présenté comme le projet dll2llm sur GitHub. Les détails d’installation et d’exécution ne figurant pas dans le texte source, nous ne fournissons pas ici de commande de terminal spécifique. Suivez les instructions du projet et vérifiez le chemin d’assembly que l’outil attend en entrée.

  4. Fournissez l’assembly à l’outil. Dans le flux de travail du guide APS, dll2llm est lancé en ciblant des assemblies situés dans le répertoire d’installation de Revit. Sélectionnez RevitAPI.dll et, si nécessaire, RevitAPIUI.dll, puis faites en sorte que l’outil rassemble le résultat dans un dossier de compétences distinct. Le guide précise que la structure produite répartit les fichiers par espaces de noms ; le résultat ne se limite donc pas nécessairement à un long document unique sur l’API.

  5. Vérifiez les fichiers générés. Assurez-vous que SKILL.md, INDEX.md et les fichiers Markdown thématiques ont bien été créés. Ces derniers contiennent des informations sur l’API classées par espace de noms. La division alphabétique des espaces de noms volumineux peut éviter que le contexte de l’agent ne se transforme en un bloc de contenu trop important. Ne considérez pas ces fichiers comme des exemples de code vérifiés simplement parce qu’ils ont été générés : l’outil fournit du contexte sur l’API, mais ne teste pas la logique de votre projet à votre place.

  6. Intégrez le skill au flux de travail de l’agent. Selon l’approche d’Autodesk, une fois le skill installé, l’agent peut consulter la référence de l’API Revit au cours d’une tâche. L’objectif est de réduire les allers-retours consistant à copier-coller des extraits de code dans la fenêtre de discussion et de donner à l’agent accès à un contexte plus large sur l’API. La source n’explique ni quels agents prennent en charge ce format de skill ni comment l’installer ; consultez les instructions propres à votre environnement.

  7. Testez les suggestions de code sur de petites tâches. Ne considérez pas le code généré par l’agent comme fiable d’emblée. Vérifiez d’abord que les noms de classes et de méthodes correspondent à la référence créée, puis que l’opération produit le résultat attendu sur le modèle cible. Pour le code qui modifie le modèle, vérifiez tout particulièrement la gestion des transactions : une Transaction est nécessaire pour modifier le modèle dans Revit, et une seule Transaction peut être ouverte à la fois. Lorsque l’opération se termine correctement, les modifications sont enregistrées avec Commit ; RollBack les annule. La documentation de l’API Revit indique également que l’état de ces opérations peut être contrôlé.

Erreurs fréquentes

Confondre le contexte de l’API avec la validation du projet : le skill fournit à l’agent des ressources sur les types et espaces de noms de l’API ; il ne prouve pas que le code généré fonctionnera correctement dans un projet. Testez séparément ce que le code fait au modèle.

Négliger la gestion des Transaction : les opérations qui modifient le modèle doivent s’exécuter dans le contexte d’une Transaction. Une SubTransaction peut servir à diviser une opération plus large en étapes logiques, mais elle doit être créée à l’intérieur d’une Transaction ouverte et fermée avant la fermeture de la transaction parente. Une TransactionGroup peut servir à regrouper plusieurs opérations indépendantes, mais elle ne peut pas être démarrée lorsqu’une Transaction est ouverte.

Ajouter des fichiers inutiles : le guide présente RevitAPIUI.dll comme une entrée supplémentaire utilisable lorsque la couche d’interface utilisateur est aussi nécessaire. Faites correspondre le périmètre du skill à la tâche plutôt que d’ajouter du contenu dont vous n’avez pas besoin.

Supposer des détails de version et d’installation : l’article APS ne fournit ni tableau de compatibilité détaillé ni commande d’installation. Notez donc la provenance de l’assembly Revit utilisé, suivez les instructions de dll2llm et ne supposez pas que d’autres versions produiront le même résultat.

Étapes suivantes : flux de travail en architecture et visualisation

Les équipes BIM, les développeurs de plug-ins et les étudiants qui apprennent l’API et réalisent régulièrement des tâches d’extraction de données ou de modification de modèles dans Revit peuvent tirer parti de cette méthode. Aider l’agent à mieux retrouver les classes de l’API peut contribuer à réduire les erreurs de méthodes supposées lors du prototypage. Cela ne remplace toutefois ni le contrôle du modèle, ni la revue du code, ni les tests du flux de travail dans les conditions réelles du projet. Dans les agences d’architecture et d’architecture d’intérieur, l’intérêt peut notamment se manifester dans le développement d’automatisations internes et dans la recherche de références par les nouveaux membres de l’équipe qui découvrent l’API.

L’Agent Skill pour l’API Revit n’est pas une fonctionnalité qui améliore directement la qualité du rendu ; il s’adresse aux processus logiciels et d’automatisation qui utilisent les données du modèle. Pour une équipe de visualisation, il peut servir à développer des outils qui extraient des informations de Revit ou automatisent les modifications du modèle. Les sources ne précisent pas les coûts liés au matériel, aux licences ou aux abonnements à des agents. Avant de passer à la mise en œuvre, évaluez séparément les conditions logicielles existantes et la prise en charge des skills par l’environnement d’agent utilisé.

Sources et licence

Ce tutoriel est adapté du guide « Let AI Write Your Revit Code » d’Autodesk Platform Services, consacré à dll2llm et aux Agent Skills, ainsi que des définitions de Transaction, SubTransaction et TransactionGroup dans la documentation de l’API Revit d’Autodesk. Les sources sont indiquées comme licence=libre ; le texte et les étapes ont été reformulés. La description du cours d’Autodesk University destiné aux débutants en API Revit a été utilisée pour étayer le périmètre d’apprentissage concernant l’API, le filtrage et les Transaction.

Sources

3 sources
H
help.autodesk.comhelp.autodesk.com/view/RVT/2013/ENU/caas.html
Résumé
A
aps.autodesk.comaps.autodesk.com/blog/let-ai-write-your-revit-code
Résumé
A
autodesk.comautodesk.com/autodesk-university/de/class/Revit-Programming-Beginners-Easily-Access-Revit-API-Using-Free-Tools-2018
Résumé

Les textes sources ne sont pas republiés ; les courtes citations sont signalées, le reste est notre propre résumé et commentaire.

L’avis de 3dsınıfı
3dL’analyse de la rédaction

Pour les agences et les étudiants qui utilisent Revit en Turquie, l’intérêt pratique de l’approche Agent Skill est d’intégrer au flux de travail de l’agent une référence plus structurée sur l’API. Les équipes qui travaillent notamment sur des tâches répétitives liées aux données du modèle ou sur des prototypes de plug-ins peuvent examiner plus rapidement les suggestions de code.

Cependant, un dossier de compétences n’est pas à lui seul une automatisation fonctionnelle ni un plug-in validé. Il faut vérifier au préalable l’accès aux DLL, la prise en charge des skills par l’environnement d’agent et les conditions logicielles utilisées. Les sources ne précisant pas les coûts du matériel ni des licences, ces postes doivent être clarifiés séparément lors de l’évaluation de l’investissement.

Questions fréquentes

Quels fichiers faut-il pour créer un Agent Skill pour l’API Revit ?

Le guide d’Autodesk explique comment fournir RevitAPI.dll à l’outil dll2llm. RevitAPIUI.dll peut également être ajouté si la couche d’interface utilisateur est nécessaire.

Quels fichiers dll2llm génère-t-il ?

Selon le guide APS, l’outil crée un dossier de compétences contenant SKILL.md, INDEX.md et des fichiers Markdown thématiques organisés par espaces de noms.

Une Transaction est-elle nécessaire pour le code qui modifie un modèle Revit ?

Oui. La documentation de l’API Revit indique qu’une Transaction est nécessaire pour modifier le modèle et qu’une seule Transaction peut être ouverte à la fois.

Les commentaires et le forum sont en turc.Rejoindre la discussion
+

À lire aussi