Что такое ИИ-агент для КОМПАС-3D: независимый проект строит параметрические детали по тексту и фото

До сих пор ИИ-агенты хорошо справлялись с текстовыми задачами: код, отчёты в офисных программах. Работа с CAD-системами (программами трёхмерного проектирования) устроена иначе: пространственное мышление остаётся слабым местом языковых и визуальных моделей, а программный интерфейс КОМПАС-3D, COM API, сложен даже для опытного разработчика. Автор проекта предложил обходной путь: собственный Python-слой поверх COM API и визуальную обратную связь, которая замыкает цикл «построил, посмотрел, поправил».

Что понадобится

• КОМПАС-3D с доступом к COM API (версия, поддерживающая внешние скрипты на Python)
• Python с настроенным подключением к COM-интерфейсу КОМПАСа
• Доступ к VLM-модели (визуально-языковая модель, которая принимает и текст, и изображения), облачной или локальной
• Базовое понимание параметрического моделирования в КОМПАСе: дерево построения, переменные, эскизы
• Примерно 30 минут на первый запуск и тестовую деталь

Пошаговая инструкция

1. Откройте КОМПАС-3D и убедитесь, что COM API доступен. Агент работает внутри окна программы как боковая панель, а не как отдельное приложение. Он видит текущий документ, дерево построения и переменные.

2. Сформулируйте задачу текстом или прикрепите изображение. Агент принимает оба формата. Можно отправить фотографию эскиза с листа бумаги или скан чертежа.

3. Отправьте запрос агенту. Пример промпта (текстового запроса к ИИ) для зубчатого колеса:

Построй зубчатое колесо: модуль 5, 50 зубьев, ширина венца 60, вал диаметр 50 со шпонкой

Агент сам достроит параметры, которые вы не указали (ступицу, обод, диск, шпоночный паз), опираясь на стандартные соотношения.

1. Дождитесь, пока агент выполнит цикл ReAct. На каждом шаге модель принимает решение о следующем действии, пишет код, выполняет его в КОМПАСе и получает обратную связь. Визуальный контроль работает так: агент сам делает рендеры детали с разных ракурсов и сверяет результат с заданием «глазами» VLM.

2. Проверьте дерево построения. Результат появится как обычная деталь КОМПАСа, а не импортированный STEP-файл. Агент заводит переменные с понятными именами и комментариями. Чтобы поменять, например, посадочное отверстие с диаметра 50 на 80, достаточно исправить одну ячейку в таблице переменных.

3. При работе с чертежом агент дополнительно заполняет свойства детали. Он читает основную надпись, проставляет наименование, обозначение и материал. Если масса не сходится (например, модель построена в стали, а деталь картонная), агент сам анализирует расхождение и подставляет нужную плотность.

Почему один блок кода лучше десяти инструментов?

Автор проекта перепробовал два подхода, и оба проиграли третьему.

• Отдельный инструмент на каждое действие (выдавить, отверстие и так далее). Каждый вызов равен одному нажатию кнопки вручную. Нет переменных, нет циклов, нет функций. Медленно и негибко.
• Прямой доступ модели к COM API. Одна осмысленная операция разворачивается в десяток служебных шагов, параметры передаются числовыми константами, а ошибка роняет не скрипт, а сам КОМПАС вместе с несохранённой работой.
• Итоговое решение: собственный Python-слой поверх COM API. Модель пишет код на более высоком уровне абстракции, а библиотека транслирует его в безопасные вызовы. Это даёт и переменные, и циклы, и защиту от падений.

Зачем агенту «глаза»?

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

Это компенсирует главную слабость языковых моделей в CAD-задачах: они плохо «представляют» трёхмерные объекты по тексту, но могут сравнить картинку с картинкой.

Что это даёт вам прямо сейчас?

Инженерам и конструкторам в КОМПАСе. Рутинные детали (зубчатые колёса, фланцы, корпуса с типовыми элементами) можно получать текстовым запросом, а потом дорабатывать в привычном дереве построения. Экономия на первичном моделировании ощутима, но финальная проверка остаётся за человеком.

Авторам Дзена, пишущим про инженерные инструменты. Тема пересечения ИИ и отечественного софта даёт сильный контент: аудитория инженеров активна, а материалов на русском языке мало. Формат «показал запрос и получил деталь» работает и в тексте, и в видео.

Предпринимателям в производственном секторе РФ. КОМПАС-3D широко используется в российской промышленности. Если агентный подход дозреет до стабильного инструмента, он ускорит проектирование типовых изделий без перехода на западный софт, который и так всё менее доступен.

Для инженеров, которые хотят понять, что такое ИИ-агент на практике, а не в теории, этот проект, пожалуй, самая наглядная демонстрация на отечественном софте: запрос текстом, деталь с деревом построения на выходе и возможность всё поправить руками.