Un agente LLM montó un reductor en KOMPAS-3D, pero la lista de materiales 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 para modelado de ingeniería: abre modelos, crea y edita piezas y ensamblajes, y elabora planos. La conexión con el agente se establece mediante MCP, un protocolo abierto con el que el modelo llama a herramientas externas. El ejemplo principal es un reductor cilíndrico de una etapa, tomado de un proyecto de curso clásico de elementos de máquinas: desde el cálculo hasta el plano de conjunto y la lista de materiales, es decir, el juego completo de documentación de diseño (KD).

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 conjuntos obtuvieron entre 88 y 100 puntos, y la lista de materiales del ensamblaje, solo 50.

Qué entregó el agente en el proyecto del reductor

El autor no se considera diseñador y actuó como cliente: planteaba el encargo técnico por etapas, aceptaba cada una y detectaba los errores visibles a simple vista. Los datos de partida son los típicos: motor AIR112M4 (5,5 kW, 1440 rpm), relación de transmisión de 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 dentro del propio 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, el número de dientes, los diámetros y los anchos se almacenan en el ensamblaje, y las piezas toman de ahí sus dimensiones. El agente comprobó por sí mismo la parametrización: fijó temporalmente u = 5, verificó que el esqueleto se reconstruía y revirtió el cambio. El modelo incluye un 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 salientes y ángulos de desmoldeo, y tapas embutidas para retenes de 35×58 y 40×60.

Los dientes se generan con la aplicación estándar «Ejes y transmisiones mecánicas 3D», no con bocetos.

La parametrización apareció solo después de la intervención humana. El autor preguntó si los resultados del cálculo se habían pasado a variables. 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 extremos cóncavos, y el agente lo corrigió tanto en los modelos como en los planos. El autor no garantiza que el reductor sea correcto en su conjunto, y tiene dudas sobre el juego de KD.

Código en lugar de un conjunto 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, 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. Por 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, restricciones de ensamblaje, vínculos entre piezas y planos), comprobaciones (errores de reconstrucción, intersecciones de cuerpos, masa como cifra de control) y capturas con cortes, para que el agente vea el modelo en lugar de adivinar a partir de números.

Todo cambio se realiza dentro de una etapa: se abre, se ejecuta el código y se cierra. Al cerrarla, el plugin verifica el resultado, y si aparecen errores de reconstrucción o intersecciones, la etapa no se acepta. El agente debe resolverlos o revertirla por completo. En el historial de KOMPAS una etapa es una sola entrada, de modo que una persona también la deshace con una única acción. El agente puede además lanzar una instancia aparte de KOMPAS para no estorbar al ingeniero en su ventana.

El benchmark: dónde hay 100 puntos y dónde 50

El autor advierte de que el benchmark es casero. Las 15 tareas derivan de ensamblajes ya hechos que vienen con KOMPAS. Se toma un producto terminado, se elimina o se rompe algo y se pide al agente que lo reconstruya. El ensamblaje original sirve de referencia y la comprobación es automática: geometría, ensamblaje, masa, plano. Es una herramienta para mejorar el plugin, no una comparación científica de modelos.

Parte de los resultados (puntos de 100, tiempo):

• eje a partir del plano de trabajo, Sonnet: 100, 8 minutos;
• conjunto 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;
• KMD de una estructura metálica (marcas, planos, acero), Opus: 88, 32 minutos;
• nodos de una estructura metálica a partir de soluciones tipo, Opus: 63, 44 minutos;
• lista de materiales del ensamblaje, Sonnet: 50, 7 minutos.

En 3D el agente se desenvuelve con seguridad, apenas requiere correcciones y gasta pocos tokens. Los planos y la KD 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 para la API de KOMPAS en la red, los modelos se confunden en operaciones concretas y el consumo de tokens aumenta. Por ahora, las tareas complejas solo están al alcance de modelos de nivel Opus, mientras que Sonnet resuelve las sencillas. El autor confía en 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 conjunto, un cambio en todo el ensamblaje, la finalización a partir de un modelo, el cálculo aproximado de tolerancias. Los planos y las listas de materiales 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.