Converto — Cómo usar

Última actualización: 1 de enero de 2026

Converto lee un grafo de Dynamo .dyn y genera una plantilla completa para un complemento de la API de Revit en C# — listo para compilar y extender.

Requisitos previos

Requisito Notas
Autodesk Revit 2026 Requerido para ejecutar el complemento
.NET 8 SDK Requerido para compilar los proyectos de la plantilla generada
Visual Studio 2022 (opcional) Recomendado para editar el código generado
Clave API de Claude o OpenAI (opcional) Requerida para la generación de código asistida por IA

Inicio rápido

Paso 1 — Abre un proyecto de Revit

Inicia Revit 2026 y abre cualquier proyecto. Converto se ejecuta dentro de una sesión activa de Revit.

Paso 2 — Abre Converto

Ve a la pestaña AvantLeap → panel CONVERTO → haz clic en Convertir grafo.

Paso 3 — Carga tu archivo .dyn

Haz clic en Examinar junto al campo "Archivo de Dynamo" y selecciona tu archivo de grafo .dyn.

Converto analiza el grafo y muestra una tabla de análisis de nodos con la siguiente información por nodo:

Columna Significado
Nombre del nodo La etiqueta del nodo en Dynamo
Estado Mapeado / Parcial / NoMapeado
Categoría Cómo se agrupa el nodo (Elemento, Filtro, Parámetro, Vista, etc.)
Método propuesto El nombre del método en C# que generará Converto
Sugerencia de API La equivalencia en la API de Revit (para los nodos mapeados)

Paso 4 — Revisa los resultados del mapeo

  • Los nodos Mapeados tienen una traducción directa a la API de Revit en C#. Sus métodos estarán pre-rellenados.
  • Los nodos NoMapeados (paquetes de terceros, scripts de Python) generan métodos de marcador de posición con comentarios TODO. Estos requieren implementación manual o ayuda de la IA.
  • Si se configura una clave API, haz clic en Sugerir con IA para obtener sugerencias generadas por IA para nodos no mapeados.

Paso 5 — Configura los ajustes de salida

Campo Descripción
Nombre del complemento El nombre del proyecto de Visual Studio y archivo DLL generados
Namespace Espacio de nombres raíz en C# (ejemplo: MiEmpresa.Herramientas)
Carpeta de salida Dónde se escribirá la carpeta del proyecto de la plantilla

Paso 6 — Genera y compila

Haz clic en Generar y compilar.

Converto hará lo siguiente:

  1. Escribirá el proyecto de la plantilla en OutputFolder\{AddinName}\
  2. Si se configura una clave AI: pedirá a la IA que implemente todos los métodos de marcador de posición con código real de la API de Revit
  3. Ejecutará dotnet build en el proyecto generado
  4. Si hay errores de compilación: enviará los errores a la IA y aplicará correcciones (hasta 3 iteraciones)
  5. Mostrará el resultado final de la compilación en el panel de registro

Una compilación exitosa produce un .dll compilado en {AddinName}\bin\Release\.

Ajustes de IA

Haz clic en ⚙ Ajustes de IA (visible en la barra superior de acciones) para configurar tu clave API.

Ajuste Descripción
Proveedor Elige Claude (Anthropic) u OpenAI (GPT-4o)
Clave API Tu clave API personal — se almacena localmente, nunca se envía a AvantLeap
Modelo Por defecto: claude-sonnet-4-6 / gpt-4o
Sugerir automáticamente no mapeados Consultar automáticamente a la IA para sugerencias de nodos no mapeados al cargar un grafo

Haz clic en Probar conexión para verificar tu clave antes de generar.

Validar plantilla

Usa el comando Validar plantilla (AvantLeap → CONVERTO → Validar) para compilar y corregir un proyecto de plantilla existente sin ejecutar de nuevo la conversión completa.

  1. Haz clic en Examinar para seleccionar el archivo de la plantilla .csproj
  2. Haz clic en Compilar para ejecutar dotnet build y ver errores
  3. Haz clic en Corregir con IA para enviar los errores a la IA y aplicar las correcciones
  4. Repite hasta que la compilación tenga éxito

Entendiendo el proyecto generado

OutputFolder\
└── MyTool\
    ├── MyTool.csproj           ← Estilo SDK, net8.0-windows, referencias de RevitAPI
    ├── MyTool.addin            ← Manifest de Revit — copiar a la carpeta Addins
    ├── App.cs                  ← IExternalApplication + botones de ribbon
    ├── Nodes\
    │   ├── ElementNodes.cs     ← Métodos auxiliares estáticos (uno por categoría de nodo)
    │   └── ...
    ├── Commands\
    │   ├── ElementCommand.cs   ← IExternalCommand por categoría
    │   └── ...
    └── README-converto.md      ← Inicio rápido para el proyecto generado

Desplegando el complemento generado

  1. Compila la plantilla: dotnet build MyTool.csproj -c Release
  2. Copia bin\Release\MyTool.dll a %APPDATA%\Autodesk\Revit\Addins\2026\MyTool\
  3. Copia MyTool.addin a %APPDATA%\Autodesk\Revit\Addins\2026\
  4. Reinicia Revit

Niveles de mapeo

Nivel Origen Resultado
1 — Dynamo principal Nodos integrados de Dynamo/Revit Mapeado → código C# pre-rellenado
2 — Paquete de terceros archilab, Clockwork, spring, BumbleBee, etc. NoMapeado → método base + comentario TODO
3 — Script de Python PythonScriptNode NoMapeado → método base con el script de Python embebido como comentario

Los métodos base de Nivel 2 y 3 se completan por la IA cuando hay una clave API disponible.

Solución de problemas

Problema Solución
"Probar conexión: Fallida" Verifica que tu clave API sea correcta y tenga créditos disponibles. El error completo se muestra debajo del botón.
Errores de compilación después de la corrección con IA Haz clic en "Corregir con IA" nuevamente — se intentan hasta 3 iteraciones automáticas. Los grafos complejos pueden requerir ediciones manuales.
RevitAPI.dll no encontrada Asegúrate de que Revit 2026 está instalado en C:\Program Files\Autodesk\Revit 2026\
Todos los nodos aparecen como NoMapeado El grafo probablemente utiliza solo paquetes de terceros. La generación por IA resolverá la mayoría de estos casos.
Botón de ribbon generado no aparece Comprueba que FullClassName en el archivo .addin coincida exactamente con el espacio de nombres de la clase App.

Versiones de Revit soportadas

Revit Soportado
2026 Sí
2025 y anteriores Fase 3 — próximamente

Soporte: https://www.avantleap.com/converto