Últimas noticias
TutorialesRevitdll2llm

¿Cómo crear una Agent Skill para Revit API? Guía de dll2llm

La guía de Autodesk APS presenta un flujo de trabajo con la herramienta dll2llm para trasladar conocimientos de Revit API a agentes de IA. Esta guía explica los archivos necesarios y los pasos de implementación.

Un diseñador trabaja con un modelo BIM en un estudio de arquitecturaImagen IA
Imagen ilustrativa generada con IA.Imagen: 3dsınıfı / FCA AI

En resumen

  1. dll2llm es una herramienta de línea de comandos que analiza ensamblados .NET y puede crear una carpeta Agent Skill.
  2. Se puede proporcionar RevitAPI.dll a la herramienta; si también se necesita la capa de interfaz de usuario, se puede añadir RevitAPIUI.dll.
  3. La carpeta generada incluye SKILL.md, INDEX.md y archivos temáticos organizados por espacios de nombres.
  4. Las modificaciones en Revit requieren una Transaction; SubTransaction puede utilizarse dentro de una Transaction abierta.

¿Qué aprenderás en esta guía?

Un agente de IA que trabaja con Revit API no siempre puede elegir las clases y los métodos correctos basándose únicamente en conocimientos generales de programación. La guía de Autodesk Platform Services (APS) explica esta situación como una falta de contexto de la API: aunque el agente reconozca algunos tipos habituales, puede hacer conjeturas incorrectas sobre métodos menos comunes. Como Revit API cuenta con numerosas clases y espacios de nombres, proporcionar toda la información en un único archivo de texto tampoco suele ser una solución práctica.

En este tutorial veremos cómo generar una carpeta Agent Skill a partir de ensamblados de Revit API y cómo utilizarla durante el desarrollo de agentes. El objetivo no es configurar de principio a fin una automatización en Revit, sino proporcionar al agente un contexto de la API más organizado y fácil de consultar. La guía de Autodesk muestra como ejemplo la herramienta de línea de comandos dll2llm.

Requisitos y limitaciones

Este flujo de trabajo requiere acceso al ensamblado de Revit API. La guía de APS explica cómo indicar a la herramienta el archivo RevitAPI.dll y cómo añadir RevitAPIUI.dll si también se necesita la capa de interfaz de usuario. La guía incluye una demostración en la que los archivos de origen se obtienen de un directorio de instalación de Revit antes de generar la carpeta de skills.

La herramienta se presenta como el proyecto de GitHub dll2llm y analiza un ensamblado .NET para convertirlo en archivos Agent Skill. La fuente no especifica los sistemas operativos compatibles, la versión de .NET necesaria, una matriz de compatibilidad con versiones de Revit, comandos de instalación ni un producto de agente concreto. Por eso, no sería correcto indicar aquí un comando, una ruta de menú o una versión por suposición. Antes de empezar, consulta la descripción actualizada del proyecto dll2llm y comprueba los archivos DLL de la instalación de Revit que vayas a utilizar.

La guía oficial enumera SKILL.md, INDEX.md y archivos Markdown temáticos entre los archivos básicos de la carpeta generada. Los archivos temáticos se organizan por espacios de nombres; los espacios de nombres grandes pueden dividirse alfabéticamente para evitar saturar en exceso la ventana de contexto. Como la fuente no menciona que se necesite una cuenta, este tutorial no presupone tal requisito.

Crear una Agent Skill paso a paso

  1. Define el objetivo. Primero, determina en qué tareas de Revit API debe ayudar el agente. Por ejemplo, leer datos del modelo, filtrar elementos o modificar el modelo en un complemento puede requerir conocimientos distintos de la API. Autodesk presenta Agent Skill como un método para proporcionar contexto de la API al agente; la herramienta no determina los requisitos del proyecto.

  2. Elige los ensamblados necesarios. RevitAPI.dll es el archivo de entrada principal, ya que contiene la capa de base de datos de Revit API. Si el agente también necesita información sobre la capa de interfaz de usuario, considera añadir RevitAPIUI.dll. El artículo de APS indica que el segundo archivo se puede utilizar de forma opcional. No des por hecho que es obligatorio incluir ambos ensamblados para todas las tareas: el alcance debe responder a las necesidades del proyecto.

  3. Consulta el proyecto dll2llm. La herramienta se presenta como el proyecto dll2llm de GitHub. Como el texto de origen no incluye instrucciones de instalación ni de ejecución, no indicamos aquí un comando concreto de terminal. Sigue las instrucciones del proyecto y confirma qué ruta de ensamblado espera como entrada.

  4. Proporciona el ensamblado a la herramienta. En el flujo de trabajo de la guía de APS, se ejecuta dll2llm indicando como destino los ensamblados del directorio de instalación de Revit. Selecciona RevitAPI.dll y, si es necesario, RevitAPIUI.dll, y configura la herramienta para que reúna los resultados en una carpeta de skills independiente. La guía señala que los archivos generados se organizan por espacios de nombres, por lo que el resultado no tiene por qué ser un único documento extenso de la API.

  5. Revisa los archivos generados. Comprueba que se hayan creado SKILL.md, INDEX.md y los archivos Markdown temáticos. Estos últimos contienen información de la API clasificada por espacios de nombres. La posible división alfabética de los espacios de nombres grandes ayuda a evitar que el contexto del agente se convierta en un bloque de contenido demasiado extenso. No consideres los archivos ejemplos de código verificados solo porque se hayan generado: la herramienta proporciona contexto de la API, pero no prueba la lógica del proyecto por ti.

  6. Integra la skill en el flujo de trabajo del agente. Según el enfoque de Autodesk, una vez configurada la skill, el agente puede consultar la referencia de Revit API durante una tarea. El objetivo es reducir el ciclo de copiar y pegar fragmentos de código individuales en la ventana de chat y permitir que el agente acceda a un contexto más amplio de la API. La fuente no explica qué agentes admiten este formato de skills ni cómo se instala; consulta las instrucciones de tu entorno.

  7. Prueba las sugerencias de código con tareas pequeñas. No des por sentado que el código generado por el agente es fiable. Primero, comprueba que los nombres de clases y métodos coincidan con la referencia generada; después, verifica que la operación produzca el resultado esperado en el modelo de destino. Revisa especialmente la gestión de transacciones en el código que modifica el modelo: para realizar cambios en Revit se necesita una Transaction y solo puede haber una Transaction abierta a la vez. Cuando la transacción finaliza correctamente, los cambios se guardan con Commit; RollBack los revierte. La documentación de Revit API también explica que se puede comprobar el estado de estas operaciones.

Errores frecuentes

Confundir el contexto de la API con la validación del proyecto: la skill proporciona al agente una referencia sobre tipos y espacios de nombres de la API; no demuestra que el código generado funcione correctamente en un proyecto. Comprueba por separado qué hace el código en el modelo.

Ignorar la estructura de las transacciones: las operaciones que modifican el modelo deben ejecutarse dentro de una Transaction. SubTransaction puede servir para dividir una tarea más amplia en partes lógicas, pero debe crearse dentro de una Transaction abierta y cerrarse antes de que termine la transacción principal. TransactionGroup permite tratar conjuntamente varias operaciones independientes, pero no se puede iniciar mientras haya una Transaction abierta.

Añadir archivos innecesarios: la guía describe RevitAPIUI.dll como una entrada adicional que se puede utilizar cuando también se necesita la capa de interfaz de usuario. En lugar de añadir contenido que no hace falta, ajusta el alcance de la skill a la tarea.

Dar por sentados los detalles de versión e instalación: el artículo de APS no incluye una tabla detallada de compatibilidad ni comandos de instalación. Por eso, anota el origen del ensamblado de Revit utilizado, sigue las instrucciones de dll2llm y no presupongas que otras versiones producirán el mismo resultado.

Próximos pasos: flujos de trabajo de arquitectura y visualización

Los equipos BIM, desarrolladores de complementos y estudiantes que aprenden la API y realizan tareas repetitivas de extracción de datos o edición de modelos en Revit pueden beneficiarse de este método. Ayudar al agente a localizar mejor las clases de la API puede reducir las conjeturas sobre métodos incorrectos al crear prototipos. Sin embargo, no sustituye la comprobación del modelo, la revisión del código ni las pruebas del flujo de trabajo en condiciones reales de proyecto. En estudios de arquitectura e interiorismo, su utilidad puede hacerse notar especialmente en el desarrollo de automatizaciones internas y en la búsqueda de referencias por parte de quienes empiezan a trabajar con la API.

Revit API Agent Skill no es una función que mejore directamente la calidad del render; está pensada para procesos de software y automatización que trabajan con datos del modelo. Para un equipo de visualización, puede servir para desarrollar herramientas que obtengan información de Revit o automaticen cambios en el modelo. Las fuentes no detallan los costes de hardware, licencias o suscripciones a agentes. Antes de implementarla, evalúa también las condiciones de software existentes y la compatibilidad con skills del entorno de agente utilizado.

Fuentes y licencia

Este tutorial se basa en las explicaciones de dll2llm y Agent Skill de la guía “Let AI Write Your Revit Code” de Autodesk Platform Services, así como en las definiciones de Transaction, SubTransaction y TransactionGroup de la documentación de Revit API de Autodesk. Las fuentes se indican con licencia=libre; el texto y los pasos se han explicado de nuevo de forma original. También se ha utilizado la descripción del curso de Autodesk University para principiantes en Revit API como apoyo al alcance formativo sobre API, filtrado y Transaction.

Fuentes

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

No republicamos los textos de las fuentes; las citas breves van marcadas y el resto es resumen y comentario propios.

La opinión de 3dsınıfı
3dValoración del editor

Para los estudios y estudiantes que utilizan Revit en Turquía, el valor práctico del enfoque Agent Skill reside en incorporar al flujo de trabajo de los agentes una referencia más sistemática sobre la API. Los equipos que trabajan especialmente con tareas repetitivas de datos del modelo o prototipos de complementos pueden revisar más rápido las sugerencias de código.

Sin embargo, una carpeta de skills no es, por sí sola, una automatización funcional ni un complemento validado. Conviene comprobar de antemano el acceso a las DLL, la compatibilidad del entorno de agente con las skills y las condiciones del software utilizado. Como las fuentes no detallan los costes de hardware ni de licencias, estos conceptos deben aclararse por separado al calcular la inversión.

Preguntas frecuentes

¿Qué archivos se necesitan para Revit API Agent Skill?

La guía de Autodesk explica cómo proporcionar RevitAPI.dll a la herramienta dll2llm. También se puede añadir RevitAPIUI.dll si se necesita la capa de interfaz de usuario.

¿Qué archivos genera dll2llm?

Según la guía de APS, la herramienta crea una carpeta de skills que contiene SKILL.md, INDEX.md y archivos Markdown temáticos organizados por espacios de nombres.

¿Se necesita Transaction en el código que modifica el modelo en Revit?

Sí. La documentación de Revit API indica que se necesita una Transaction para realizar cambios en el modelo y que solo puede haber una Transaction abierta a la vez.

Los comentarios y el foro están en turco.Únete al debate
+

Noticias relacionadas