LLM-агент собрал редуктор в КОМПАС-3D, но спецификацию сдал на 50 баллов из 100

Автор статьи на Хабре написал плагин kompas-mcp, через который LLM-агент работает внутри КОМПАС-3D, российской САПР для инженерного моделирования: открывает модели, строит и правит детали и сборки, оформляет чертежи. Связь с агентом идёт по MCP — открытому протоколу, через который модель вызывает внешние инструменты. Главный пример — одноступенчатый цилиндрический редуктор из классической курсовой по деталям машин: от расчёта до сборочного чертежа и спецификации, то есть полного комплекта конструкторской документации (КД). Чтобы понять, где агент помогает, автор собрал самодельный бенчмарк из 15 заданий с оценкой до 100 баллов. Детали и узлы получили 88–100 баллов, а спецификация по сборке — только 50.

Что агент выдал на курсовой по редуктору

Автор конструктором себя не считает и выступал заказчиком: ставил ТЗ по этапам, принимал каждый из них и ловил ошибки, заметные глазом. Исходные данные типовые: двигатель АИР112M4 (5,5 кВт, 1440 об/мин), передаточное число 4, ресурс 10 000 часов. Агент посчитал передачу по Чернавскому. Расчёт записан не картинкой, а переменными и уравнениями прямо в документе КОМПАС, а таблица итогов ссылается на них.

Затем он собрал сборку со скелетом: межосевое расстояние, модуль, числа зубьев, диаметры и ширины хранятся в сборке, детали берут размеры оттуда. Параметричность агент проверил сам: временно поставил u = 5, убедился, что скелет перестроился, и откатил изменение. В модели вал-шестерня z = 26 и колесо z = 105 (m = 1,5), тихоходный вал, подшипники 207 и 208, шпонки по ГОСТ 23360, концы валов по ГОСТ 12080, литой корпус с бобышками и уклонами, врезные крышки под манжеты 35×58 и 40×60. Зубья строятся штатным приложением «Валы и механические передачи 3D», а не эскизами.

Параметричность появилась только после вмешательства человека. Автор спросил, переданы ли результаты расчёта в переменные. Оказалось, что нет. Агент предложил варианты, автор выбрал уравнения в документе расчёта и опорные переменные в сборке. Ещё одна находка: на чертежах у шпоночных пазов были вогнутые концы, и агент исправил это и в моделях, и на чертежах. За правильность редуктора в целом автор не ручается, а к комплекту КД у него остались вопросы.

Код вместо набора кнопок: как устроен плагин

Плагин — MCP-сервер для КОМПАС. Подключить можно любой клиент с поддержкой MCP: Claude Code, Claude Desktop, Cursor, VS Code, Codex, Gemini CLI. В статье использован Claude. Внутри КОМПАС работает библиотека со встроенным Python, и код агента исполняется прямо в процессе программы с полным доступом к API. Снаружи стоит небольшой мост от MCP к этой библиотеке. Установка — одним скриптом в профиль пользователя, без прав администратора.

Главное решение — отказ от отдельного инструмента на каждое действие. У КОМПАС тысячи операций с десятками параметров, и реальная задача всегда их комбинация. Поэтому агент пишет скрипт на API и выполняет его. Плагин даёт ему справку по интерфейсам и методам, обзор модели (дерево, переменные, сопряжения, связи деталей и чертежей), проверки (ошибки перестроения, пересечения тел, масса как контрольное число) и кадры с разрезами, чтобы агент видел модель, а не гадал по числам.

Любая правка идёт внутри этапа: открыл, выполнил код, закрыл. При закрытии плагин проверяет результат, и если появились ошибки перестроения или пересечения, этап не принимается. Агент должен разобраться или откатить его целиком. В истории КОМПАС этап — одна запись, поэтому человек тоже отменяет его одним действием. Агент может поднять и отдельный экземпляр КОМПАС, чтобы не мешать инженеру в его окне.

Бенчмарк: где 100 баллов, а где 50

Автор оговаривается: бенчмарк самопальный. 15 заданий выведены из готовых сборок, которые идут в поставке КОМПАС. Он берёт законченное изделие, что-то убирает или ломает и просит агента восстановить. Исходная сборка служит эталоном, проверка автоматическая: геометрия, сборка, масса, чертёж. Это инструмент для доработки плагина, а не научное сравнение моделей.

Часть результатов (баллы из 100, время):

• вал по рабочему чертежу, Sonnet: 100, 8 минут;
• узел вала по сборочному чертежу, Sonnet: 88–94, 7 минут;
• новый вал в контексте сборки, Sonnet: 91, 15 минут;
• достройка металлокаркаса по образцу, Opus: 100, 5 минут;
• рабочий чертёж зубчатого колеса, Sonnet: 82, 49 минут;
• КМД металлокаркаса (марки, чертежи, сталь), Opus: 88, 32 минуты;
• узлы металлокаркаса из типовых решений, Opus: 63, 44 минуты;
• спецификация по сборке, Sonnet: 50, 7 минут.

В 3D агент справляется уверенно, правок почти не требуется, токенов уходит немного. Чертежи и КД получаются с замечаниями и стоят заметно больше времени и токенов. Агент подбирает виды, выноски, размеры и допуски, но путается в API при размещении всего на листе: информация на чертеже есть, читать его трудно. Встроенные библиотеки КОМПАС интегрируются тяжело, у многих нет даже COM-интерфейсов, и простое действие превращается в серию команд.

Вторая причина слабых мест — нехватка данных. Примеров кода на API КОМПАС в сети мало, модели путаются в отдельных операциях, и расход токенов растёт. Тяжёлые задачи пока по силам только моделям уровня Opus, простые вытягивает Sonnet. Автор надеется, что новые поколения моделей, включая открытые, сделают такое моделирование доступнее.

Практический вывод: агент уже забирает рутину в 3D — деталь по чертежу, узел, правку по всей сборке, достройку по образцу, прикидку допусков. Чертежи и спецификации нужно проверять и дорабатывать вручную. Плагин лежит на GitHub (cad-lab-ai/kompas-mcp), а автор просит присылать случаи, где агент помог и где нет.