Un agente LLM montó un reductor en KOMPAS-3D, pero la especificación sacó 50 puntos de 100

El autor de un artículo en Habr escribió el plugin kompas-mcp, a través del cual un agente LLM trabaja dentro de KOMPAS-3D, un sistema CAD ruso de modelado para ingeniería. El agente abre modelos, crea y modifica piezas y ensamblajes, y elabora planos. La conexión con el agente se establece mediante MCP, un protocolo abierto con el que el modelo invoca herramientas externas.

El ejemplo principal es un reductor cilíndrico de una etapa, tomado de un trabajo de curso clásico de elementos de máquinas: desde el cálculo hasta el plano de ensamblaje y la especificación, es decir, el conjunto completo de documentación de diseño (КД). Para entender en qué ayuda el agente, el autor montó un benchmark propio de 15 tareas con una puntuación máxima de 100. Las piezas y los subconjuntos obtuvieron entre 88 y 100 puntos, pero la especificación del ensamblaje, solo 50.

Qué entregó el agente en el trabajo de curso del reductor

El autor no se considera diseñador y actuó como cliente: planteó el encargo técnico por etapas, aceptó cada una y detectó los errores visibles a simple vista. Los datos de partida son los típicos: motor АИР112M4 (5,5 кВт, 1440 об/мин), relación de transmisión 4 y vida útil de 10 000 horas. El agente calculó la transmisión según el método de Chernavski. El cálculo no está guardado como imagen, sino como variables y ecuaciones directamente en el documento de KOMPAS, y la tabla de resultados remite a ellas.

Después montó un ensamblaje con esqueleto: la distancia entre ejes, el módulo, los números de dientes, los diámetros y los anchos se almacenan en el ensamblaje, y las piezas toman de ahí sus dimensiones. El propio agente comprobó la parametrización: puso temporalmente u = 5, verificó que el esqueleto se reconstruía y revirtió el cambio. El modelo incluye un eje piñón con z = 26 y una rueda con z = 105 (m = 1,5), un eje lento, rodamientos 207 y 208, chavetas según GOST 23360, extremos de eje según GOST 12080, una carcasa fundida con bosses e inclinaciones de desmoldeo, y tapas embutidas para retenes de 35×58 y 40×60.

Los dientes se generan con la aplicación estándar «Валы и механические передачи 3D», y no con croquis.

La parametrización solo apareció después de la intervención humana. El autor preguntó si los resultados del cálculo se habían pasado a variables, y resultó que no. El agente propuso varias opciones, y el autor eligió ecuaciones en el documento de cálculo y variables de referencia en el ensamblaje. Otro hallazgo: en los planos, los chaveteros tenían los extremos cóncavos, y el agente lo corrigió tanto en los modelos como en los planos. El autor no responde de que el reductor sea correcto en su conjunto, y le quedan dudas sobre el conjunto de КД.

Código en lugar de un panel de botones: cómo funciona el plugin

El plugin es un servidor MCP para KOMPAS. Se puede conectar cualquier cliente compatible con MCP: Claude Code, Claude Desktop, Cursor, VS Code, Codex o Gemini CLI. En el artículo se usó Claude. Dentro de KOMPAS funciona una biblioteca con Python integrado, y el código del agente se ejecuta directamente en el proceso del programa, con acceso completo a la API. Fuera hay un pequeño puente entre MCP y esa biblioteca. La instalación se hace con un solo script en el perfil del usuario, sin derechos de administrador.

La decisión principal fue renunciar a una herramienta independiente para cada acción. KOMPAS tiene miles de operaciones con decenas de parámetros, y una tarea real siempre es una combinación de ellas. Por eso el agente escribe un script sobre la API y lo ejecuta. El plugin le ofrece documentación de interfaces y métodos, una vista general del modelo (árbol, variables, acoplamientos, vínculos entre piezas y planos), verificaciones (errores de reconstrucción, intersecciones entre cuerpos y la masa como cifra de control) y capturas con cortes, para que el agente vea el modelo en vez de adivinar a partir de números.

Todo cambio se hace dentro de una etapa: se abre, se ejecuta el código y se cierra. Al cerrarla, el plugin revisa el resultado, y si aparecen errores de reconstrucción o intersecciones, la etapa no se acepta. El agente debe resolver el problema o revertirla por completo. En el historial de KOMPAS, una etapa es un solo registro, así que el ingeniero también la deshace con una única acción. El agente puede además lanzar una instancia aparte de KOMPAS para no molestar al ingeniero en su ventana.

Benchmark: dónde hay 100 puntos y dónde 50

El autor aclara que el benchmark es casero. Las 15 tareas derivan de ensamblajes terminados que vienen con KOMPAS. Toma un producto acabado, le quita o le rompe algo y pide al agente que lo restituya. El ensamblaje original sirve de referencia, y la verificación es automática: geometría, ensamblaje, masa y plano. Es una herramienta para mejorar el plugin, no una comparación científica de modelos.

Algunos resultados (puntos sobre 100, tiempo):

• eje a partir del plano de trabajo, Sonnet: 100, 8 minutos;
• subconjunto de eje a partir del plano de ensamblaje, Sonnet: 88–94, 7 minutos;
• nuevo eje en el contexto de un ensamblaje, Sonnet: 91, 15 minutos;
• finalización de una estructura metálica a partir de un modelo, Opus: 100, 5 minutos;
• plano de trabajo de una rueda dentada, Sonnet: 82, 49 minutos;
• КМД de una estructura metálica (marcas, planos, acero), Opus: 88, 32 minutos;
• nudos de una estructura metálica a partir de soluciones tipo, Opus: 63, 44 minutos;
• especificación de un ensamblaje, Sonnet: 50, 7 minutos.

En 3D, el agente se desenvuelve con seguridad, casi no requiere correcciones y gasta pocos tokens. Los planos y la КД salen con observaciones y cuestan bastante más tiempo y tokens. El agente elige vistas, referencias, cotas y tolerancias, pero se confunde con la API al colocar todo en la hoja: la información está en el plano, pero resulta difícil de leer. Las bibliotecas integradas de KOMPAS se integran con dificultad, muchas ni siquiera tienen interfaces COM, y una acción sencilla se convierte en una serie de comandos.

La segunda causa de los puntos débiles es la falta de datos. Hay pocos ejemplos de código sobre la API de KOMPAS en la red, los modelos se confunden en operaciones concretas y el consumo de tokens aumenta. Por ahora, las tareas pesadas solo están al alcance de modelos de nivel Opus, y Sonnet se encarga de las sencillas. El autor espera que las nuevas generaciones de modelos, incluidos los abiertos, hagan este tipo de modelado más accesible.

Conclusión práctica: el agente ya se encarga de la rutina en 3D: una pieza a partir de un plano, un subconjunto, un cambio en todo el ensamblaje, la finalización a partir de un modelo y la estimación de tolerancias. Los planos y las especificaciones hay que revisarlos y completarlos a mano. El plugin está en GitHub (cad-lab-ai/kompas-mcp), y el autor pide que le envíen casos en los que el agente ayudó y en los que no.