Agente de LLM montou um redutor no KOMPAS-3D, mas tirou 50 em 100 na lista de materiais

O autor de um artigo no Habr escreveu o plugin kompas-mcp, por meio do qual um agente de LLM trabalha dentro do KOMPAS-3D, um sistema CAD russo para modelagem de engenharia: ele abre modelos, cria e edita peças e montagens e prepara desenhos. A comunicação com o agente ocorre via MCP, um protocolo aberto pelo qual o modelo chama ferramentas externas. O exemplo principal é um redutor cilíndrico de um estágio, do tipo clássico dos trabalhos de curso de elementos de máquinas: do cálculo ao desenho de conjunto e à especificação, ou seja, o conjunto completo de documentação de projeto (KD).

Para entender em que o agente ajuda, o autor montou um benchmark caseiro com 15 tarefas e nota de até 100 pontos. Peças e conjuntos receberam de 88 a 100 pontos, e a especificação da montagem, apenas 50.

O que o agente entregou no trabalho de curso do redutor

O autor não se considera projetista e atuou como cliente: definia o termo de referência por etapas, aprovava cada uma delas e apontava os erros visíveis a olho nu. Os dados de entrada são típicos: motor AIR112M4 (5,5 kW, 1440 rpm), relação de transmissão 4 e vida útil de 10 000 horas. O agente calculou a transmissão pelo método de Chernavski. O cálculo não foi registrado como imagem, mas como variáveis e equações diretamente no documento do KOMPAS, e a tabela de resultados faz referência a elas.

Em seguida, ele montou o conjunto com um esqueleto: distância entre eixos, módulo, números de dentes, diâmetros e larguras ficam armazenados na montagem, e as peças pegam as dimensões de lá. O próprio agente verificou a parametrização: definiu temporariamente u = 5, confirmou que o esqueleto foi reconstruído e desfez a alteração. No modelo, o eixo-pinhão tem z = 26 e a roda, z = 105 (m = 1,5).

Há ainda o eixo lento, rolamentos 207 e 208, chavetas conforme GOST 23360, pontas de eixo conforme GOST 12080, carcaça fundida com ressaltos e ângulos de saída, e tampas embutidas para retentores de 35×58 e 40×60. Os dentes são gerados pelo aplicativo nativo «Eixos e transmissões mecânicas 3D», e não por esboços.

A parametrização só apareceu depois da intervenção humana. O autor perguntou se os resultados do cálculo haviam sido transferidos para variáveis. Descobriu-se que não. O agente propôs alternativas, e o autor escolheu equações no documento de cálculo e variáveis de referência na montagem. Outra descoberta: nos desenhos, os rasgos de chaveta tinham extremidades côncavas, e o agente corrigiu isso tanto nos modelos quanto nos desenhos. O autor não garante a correção do redutor como um todo e ainda tem dúvidas sobre o conjunto de KD.

Código em vez de um conjunto de botões: como o plugin funciona

O plugin é um servidor MCP para o KOMPAS. É possível conectar qualquer cliente com suporte a MCP: Claude Code, Claude Desktop, Cursor, VS Code, Codex, Gemini CLI. No artigo, foi usado o Claude. Dentro do KOMPAS roda uma biblioteca com Python embutido, e o código do agente é executado diretamente no processo do programa, com acesso total à API. Do lado de fora, há uma pequena ponte entre o MCP e essa biblioteca. A instalação é feita por um único script no perfil do usuário, sem direitos de administrador.

A decisão central foi abandonar uma ferramenta separada para cada ação. O KOMPAS tem milhares de operações com dezenas de parâmetros, e uma tarefa real é sempre uma combinação delas. Por isso, o agente escreve um script na API e o executa. O plugin fornece a ele uma referência de interfaces e métodos, uma visão geral do modelo (árvore, variáveis, restrições de montagem, vínculos entre peças e desenhos), verificações (erros de reconstrução, interseções entre sólidos, massa como valor de controle) e imagens com cortes, para que o agente veja o modelo em vez de adivinhar pelos números.

Toda alteração acontece dentro de uma etapa: abre, executa o código, fecha. Ao fechar, o plugin verifica o resultado, e, se surgirem erros de reconstrução ou interseções, a etapa não é aceita. O agente precisa resolver o problema ou desfazer a etapa inteira. No histórico do KOMPAS, a etapa é um único registro, de modo que o humano também a desfaz com uma só ação. O agente também pode abrir uma instância separada do KOMPAS para não atrapalhar o engenheiro na janela dele.

Benchmark: onde saem 100 pontos e onde saem 50

O autor faz uma ressalva: o benchmark é caseiro. As 15 tarefas derivam de montagens prontas que acompanham o KOMPAS. Ele pega um produto acabado, remove ou quebra algo e pede que o agente o restaure. A montagem original serve de gabarito, e a verificação é automática: geometria, montagem, massa, desenho. É uma ferramenta para aprimorar o plugin, e não uma comparação científica entre modelos.

Parte dos resultados (pontos em 100, tempo):

• eixo a partir do desenho de trabalho, Sonnet: 100, 8 minutos;
• conjunto de eixo a partir do desenho de conjunto, Sonnet: 88–94, 7 minutos;
• novo eixo no contexto de uma montagem, Sonnet: 91, 15 minutos;
• complemento de uma estrutura metálica a partir de um modelo, Opus: 100, 5 minutos;
• desenho de trabalho de roda dentada, Sonnet: 82, 49 minutos;
• KMD de estrutura metálica (marcas, desenhos, aço), Opus: 88, 32 minutos;
• nós de estrutura metálica a partir de soluções típicas, Opus: 63, 44 minutos;
• especificação da montagem, Sonnet: 50, 7 minutos.

Em 3D, o agente se sai com segurança, quase não exige correções e gasta poucos tokens. Os desenhos e a KD saem com ressalvas e custam bem mais tempo e tokens. O agente escolhe vistas, chamadas, cotas e tolerâncias, mas se perde na API ao posicionar tudo na folha: a informação está no desenho, mas ele é difícil de ler. As bibliotecas nativas do KOMPAS são difíceis de integrar, muitas nem têm interfaces COM, e uma ação simples vira uma série de comandos.

A segunda causa dos pontos fracos é a falta de dados. Há poucos exemplos de código para a API do KOMPAS na internet, os modelos se confundem em operações específicas, e o consumo de tokens aumenta. As tarefas pesadas, por ora, só estão ao alcance de modelos da classe Opus; as simples o Sonnet resolve. O autor espera que as novas gerações de modelos, incluindo os abertos, tornem esse tipo de modelagem mais acessível.

Conclusão prática: o agente já assume a rotina em 3D, como peça a partir de desenho, conjunto, alteração em toda a montagem, complemento a partir de um modelo e estimativa de tolerâncias. Desenhos e especificações precisam ser revisados e finalizados à mão. O plugin está no GitHub (cad-lab-ai/kompas-mcp), e o autor pede que lhe enviem casos em que o agente ajudou e em que não ajudou.