В начале июня Трамп подписал указ о добровольной проверке мощных ИИ-моделей перед релизом . OpenAI согласилась на ограниченный предрелиз для "доверенных партнёров" . Администрация провела дополнительные тесты через Центр по стандартам ИИ и инноваций, после чего разрешила полноценный запуск .

Если вам интересна тема ai и веб разработки, я также публикую разборы других кейсов в своем Telegram-канале и на Максе. Буду рад единомышленникам

Купить грок из России в 2026 году напрямую российской картой не выходит: оплата подписки уходит на зарубежный биллинг xAI, и платёж отклоняется на стороне сервиса. При этом сам Grok - один из самых заметных ИИ-ассистентов года: он отвечает в реальном времени, ищет по вебу и по соцсети X, генерирует изображения и короткие видео через Imagine и работает на модели Grok 4. Спрос на то, чтобы оплатить грок и получить полноценный доступ, только растёт, а вместе с ним растёт и число вопросов, как сделать это корректно.

Ниже разберём по шагам, как купить подписку грок из России и какой способ оплаты выбрать под свою задачу. Платный план называется SuperGrok и стоит 30 долларов в месяц - это отдельная подписка именно на ИИ, без привязки к соцсети X. Дальше идут три рабочих способа оплатить грок премиум: через сервис-посредник Oplatym, виртуальной картой и прямо с баланса Apple ID или Google Play в приложении. Каждый способ закрывает свой случай, а активация всегда идёт на ваш аккаунт грок в России - без смены основных данных профиля.

Что такое Grok и почему за SuperGrok платят отдельно от X

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

Первая экосистема - подписки соцсети X (X Premium и X Premium+): там нейросеть идёт в комплекте с социальными функциями. Вторая - отдельная подписка SuperGrok на grok.com и в приложениях, где вы платите именно за ИИ, без надстроек соцсети. Тем, кому супер грок нужен ради работы, вторая экосистема выгоднее: SuperGrok стоит дешевле, чем X Premium+, а модель даёт ту же. Поэтому логичнее оплатить грок как отдельную подписку, а не переплачивать за соцсетевой пакет.

Вот что вы получаете, когда оформляете подписку грок:

• доступ к модели Grok 4 - с рассуждениями, вызовом инструментов и работой над сложными задачами;

• DeepSearch - режим глубокого поиска, который сам обходит веб и X в несколько шагов и собирает ответ со ссылками на источники;

• Imagine - генерацию изображений и коротких видео прямо в интерфейсе;

• голосовой режим и работу с загруженными файлами;

• повышенные лимиты и приоритетную скорость ответов;

• ранний доступ к новым функциям и коннекторы к внешним сервисам.

Сильная сторона Grok - работа с актуальными данными: нейросеть подтягивает свежие события из веба и ленты X в момент запроса, а не отвечает по устаревшей базе. Для аналитики и текстов это заметно: можно спросить про новость сегодняшнего дня и получить ответ со ссылками. Отдельно подписчикам доступен инструмент Grok Build для генерации кода, режим Expert для сложных задач и расширенный контекст для длинных диалогов. Если коротко, оплатить грок имеет смысл ради связки «свежие данные плюс сильная модель», которую бесплатные лимиты просто не раскрывают.

На практике подписка раскрывается через два инструмента. DeepSearch удобен, когда нужен разбор темы: вместо одного ответа модель делает серию поисковых шагов по вебу и X и собирает выжимку со ссылками - это заметно экономит время на ресёрче. Imagine закрывает визуал: генерация изображений под соцсети, обложки, иллюстрации, а с недавних пор и короткие видеоролики со звуком. Плюс голосовой режим для диктовки и работа с загруженными документами - всё это входит в один тариф, отдельно докупать ничего не нужно.

Grok 4 и апдейты: что входит в подписку супер грок в 2026

Актуальная флагманская модель линейки - Grok 4.3, и по тарифам она открывается поэтапно. Базовая подписка супер грок даёт Grok 4 и новые версии в порядке очереди, а полный доступ к Grok 4.3 без ожидания есть на верхнем тарифе Heavy. На практике вывод простой: купить грок премиум стоит уже сейчас, если вам нужны текущие возможности, а не гонка за самой свежей сборкой модели.

Что реально изменилось для подписчика к 2026 году:

• Imagine научился генерировать не только картинки, но и короткие видео со звуком;

• появился промежуточный тариф SuperGrok Lite - недорогой вход для тех, кому не нужен полный план;

• лимиты на генерацию и длину диалога на платных тарифах заметно выше, чем на бесплатном.

Ещё нюанс выкатки: в приложении не всегда видно, какая именно версия модели отвечает на конкретный запрос - во время поэтапного обновления два подписчика с одним тарифом могут получить разные сборки. На повседневных задачах это не мешает, но если вам критично всегда работать на самой свежей версии, единственный гарантированный вариант - тариф Heavy.

Бесплатная версия грок тоже существует, но она урезана по лимитам и моделям - для регулярной работы её не хватает. На бесплатном доступе счёт запросов быстро упирается в потолок, а часть режимов недоступна вовсе. Именно поэтому пользователи и оформляют платную подписку грок, а не остаются на free-режиме.

Оплата Grok из России через Oplatym

Самый простой способ оплатить грок, когда нет подходящей зарубежной карты, - сервис-посредник Oplatym. Схема прозрачная: доступ к аккаунту вы никому не передаёте, а финальную оплату на сайте Grok проводите сами.

Логика такая. Вы пишете менеджеру Oplatym в Telegram, называете нужный тариф SuperGrok, вносите сумму в рублях и получаете назад данные для оплаты. Затем заходите на grok.com под своим профилем и завершаете покупку. Формат удобен тем, что купить подписку грок реально без собственной иностранной карты, а сама подписка сразу привязывается к вашему аккаунту.

Чтобы всё прошло гладко, заранее подготовьте почту и пароль от аккаунта grok.com, на который оформляете тариф, и определитесь с длительностью подписки - месяц или год. Общение с сервисом идёт только в Telegram: это единый канал, где вам выставляют счёт и присылают инструкцию. Никакие данные банковской карты сервису не нужны - вы просто переводите рубли и получаете реквизиты для финальной оплаты.

Весь путь от первого сообщения до активной подписки занимает обычно 10–15 минут.

Инструкция: купить подписку грок через Oplatym за 6 шагов

1. Войдите в аккаунт на grok.com или зарегистрируйте новый - тот, на котором хотите активировать SuperGrok. Именно на него встанет подписка, так что выбирайте основной профиль.

2. Определитесь с тарифом. Для большинства это SuperGrok за 30 долларов в месяц; если планируете пользоваться долго - присмотритесь к годовой оплате, она выходит выгоднее.

3. Напишите менеджеру Oplatym в Telegram и укажите, что хотите оплатить грок и какой именно план вам нужен. Это единственный канал общения - так надёжнее.

4. Внесите сумму в рублях по выставленному счёту. В ответ вам передадут реквизиты и короткую инструкцию, по которой пройдёт оплата на стороне сервиса.

5. Вернитесь на grok.com, откройте раздел подписки и завершите оплату по полученным данным - платёж проводите вы сами, а не кто-то за вас.

6. Убедитесь, что тариф SuperGrok активировался в вашем профиле, и переходите к работе.

Так можно купить грок в России буквально за несколько минут, не заводя зарубежную карту. Если на шаге оплаты что-то не срастётся, менеджер в Telegram подскажет по ходу - на этом и держится удобство способа.

Виртуальная карта: ещё один способ оплатить грок премиум

Второй вариант - выпустить виртуальную карту иностранного банка и оплатить грок премиум ею напрямую на grok.com. Он подойдёт тем, кто платит за зарубежные сервисы регулярно: одна карта закрывает сразу все подписки, и Grok среди них.

Как это выглядит на практике:

• вы выпускаете виртуальную карту через сервис, который работает с российскими пользователями;

• пополняете её баланс с учётом стоимости тарифа и небольшого запаса на конвертацию;

• привязываете карту в разделе оплаты на grok.com и оформляете SuperGrok.

Плюс подхода - автономность: чтобы купить Grok и потом продлевать подписку, посредник каждый раз не нужен. Минус - карту надо выпустить и держать на ней баланс, а за выпуск и обслуживание обычно берут комиссию. Если Grok у вас единственная зарубежная подписка, проще остаться на первом способе; если сервисов много - виртуальная карта окупается быстро.

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

Оплата через баланс Apple ID и Google Play в приложении Grok

Третий способ пригодится, если на смартфоне установлено приложение Grok. Подписку супер грок можно оформить прямо внутри приложения, а оплата спишется с баланса Apple ID на iPhone или Google Play на Android. Это удобно, когда баланс уже пополнен и и возиться с картой не хочется.

Порядок действий простой:

• установите приложение Grok из App Store или Google Play и войдите в свой аккаунт;

• пополните баланс Apple ID или Google Play подарочной картой на нужную сумму;

• откройте раздел подписки в приложении и выберите тариф SuperGrok;

• подтвердите покупку - деньги спишутся с баланса магазина.

Один момент стоит учесть: цена внутри приложения иногда чуть выше, чем на сайте, - магазины закладывают свою комиссию. Зато чтобы купить подписку грок этим путём, не нужны ни карта, ни посредник - только баланс в App Store или Google Play. Подписка так же встанет на ваш аккаунт грок, как и при других способах.

Учтите, что подписка через магазин по умолчанию продлевается автоматически: следующий месяц спишется с того же баланса, если не отключить продление. Управление подпиской при этом живёт не в самом Grok, а в настройках Apple ID или Google Play - там же её можно поставить на паузу или отменить. Это удобно тем, кто хочет попробовать супер грок на месяц и решить, продлевать ли дальше.

Сколько стоит Grok в 2026: тарифы SuperGrok, Lite и Heavy

Цены на грок в 2026 году зависят от экосистемы и уровня доступа. По официальным данным xAI, платные тарифы линейки SuperGrok выглядят так:

• SuperGrok Lite - 10 долларов в месяц. Начальный платный вход: базовый доступ к ИИ, упрощённая генерация картинок и видео, один ИИ-агент.

• SuperGrok - 30 долларов в месяц или 300 долларов в год. Основной тариф: полноценный доступ к Grok 4, DeepSearch, расширенная генерация в Imagine, повышенные лимиты. Именно его чаще всего имеют в виду, когда хотят купить грок премиум.

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

Есть и бесплатный доступ на grok.com и в приложениях, но он ограничен: небольшое число запросов в течение пары часов на облегчённой модели и базовый поиск. Для знакомства этого хватает, для регулярной работы - нет, поэтому большинство и переходит на платный план.

Как выбрать тариф по нагрузке: Lite подойдёт, если ИИ нужен изредка и хочется просто снять лимиты бесплатного доступа; SuperGrok за 30 долларов закрывает почти все рабочие сценарии и остаётся оптимальным выбором для тех, кто решает купить грок премиум для дела; Heavy оправдан только при действительно тяжёлых нагрузках. Годовая оплата SuperGrok за 300 долларов экономит примерно два месяца в сравнении с помесячной - если планируете пользоваться долго, есть смысл сразу купить Grok на год.

Особняком стоит X Premium+ за 40 долларов в месяц - это подписка на соцсеть X, куда доступ к Grok идёт бонусом. Если нейросеть нужна сама по себе, а не ради X, выгоднее взять именно супер грок. Все цены указаны в долларах: при оплате через посредника или картой итоговая сумма считается по курсу на момент платежа, отдельного тарифа «грок в России» у сервиса нет - вы платите за один из глобальных планов.

Что проверить до и после оплаты грок в России

Чтобы оплата грок в России прошла спокойно, держите под рукой короткий чек-лист. Он бережёт нервы и на этапе покупки, и после активации подписки.

До оплаты стоит проверить:

• вы на официальном сайте grok.com или в приложении из App Store либо Google Play, а не на стороннем клоне;

• выбран нужный тариф SuperGrok, а не соседний план линейки;

• если платите через посредника - сохранён номер заказа и переписка с менеджером.

После оплаты убедитесь, что:

• подписка отображается в настройках аккаунта как активная;

• возможности грок открылись - DeepSearch, Imagine и модель Grok 4 доступны;

• логин и пароль от аккаунта вы никому не передавали - для оплаты они не нужны ни при одном из способов.

Этого хватает, чтобы купить Grok спокойно и без сюрпризов. Все три способа оставляют аккаунт полностью в ваших руках, а подписку - под вашим контролем.

Частые вопросы о том, как купить и оплатить Grok в России

Как оплатить грок из России, если нет зарубежной карты?

Подойдёт сервис-посредник: вы вносите сумму в рублях, получаете реквизиты и сами завершаете оплату на grok.com. Так можно оплатить грок без собственной иностранной карты, а подписка привяжется к вашему аккаунту.

Можно ли купить подписку грок с баланса телефона?

Да. Если установлено приложение Grok, купить подписку грок можно с баланса Apple ID или Google Play - оплата пройдёт внутри приложения, и картой пользоваться необязательно.

Сколько стоит грок премиум в 2026 году?

Основной тариф SuperGrok стоит 30 долларов в месяц или 300 в год. Есть более дешёвый SuperGrok Lite за 10 долларов и максимальный Heavy за 300 в месяц. Так что купить грок премиум можно под разный бюджет.

В чём разница между SuperGrok и X Premium+?

SuperGrok - отдельная подписка на ИИ за 30 долларов в месяц. X Premium+ за 40 долларов - это подписка на соцсеть X, где доступ к Grok идёт дополнением. Если нужен именно ИИ, берите супер грок.

Как быстро активируется подписка после оплаты?

При оплате картой или с баланса магазина - практически сразу. Через посредника купить грок в России и получить активную подписку обычно выходит в пределах нескольких минут после платежа.

Итог: когда и как выгоднее купить грок в 2026

Купить Grok из России в 2026 году реально тремя понятными путями: через посредника Oplatym, виртуальной картой и с баланса Apple ID или Google Play. Если Grok - ваша единственная зарубежная подписка, проще всего оплатить грок через посредника: минимум действий и никакой карты. Платите за много сервисов сразу - заведите виртуальную карту. А когда под рукой пополненный баланс магазина, купить подписку грок можно прямо в приложении за пару касаний.

Определитесь с тарифом SuperGrok под свою нагрузку и оформите подписку удобным способом - доступ к Grok 4, DeepSearch и Imagine откроется сразу после активации на вашем аккаунте. Так грок премиум оказывается в вашем распоряжении без лишних сложностей.

Начнём с демо-видео, а затем перейдём к архитектуре.

Демо

Сценарий записан на реальной сборке из промышленной конструкторской документации. Задача: открыть 3D-документ 2025БК.100.10.00.000.a3d, обойти состав, собрать спецификацию .spw по действующей редакции ГОСТ 2.106 с разделами «Документация / Сборочные единицы / Детали / Стандартные изделия».

Демо: генерация спецификации по сборке

youtube(если основная не работает): https://youtu.be/vMrWjM8IuQo

Почему не MCP

Первое, что напрашивается для такой задачи, это обернуть API KOMPAS в набор MCP-инструментов: «открыть документ», «получить состав», «заполнить ячейку штампа», каждый со своей JSON-схемой параметров. Я от этого отказался, и вот почему.

Возьмём простой сценарий: обойти состав сборки и у каждой детали прочитать обозначение. На Python агент пишет это ровно так, как думает:

def run(app):

d3 = cast(app.ActiveDocument, 'IKompasDocument3D')

top = d3.TopPart

result = []

for i in range(top.Parts.Count):

part = top.Parts.Item(i)

result.append(part.Marking)

return result

Семь строк, обычный цикл, привычная работа с объектами. Теперь то же самое через MCP: это цепочка отдельных tool call'ов. Сначала get_active_document, из ответа достать хэндл документа, скормить его в cast_to_3d, из ответа достать другой хэндл, вызвать get_top_part, потом get_parts_count, потом в цикле по одному вызову get_part_item и get_part_marking на каждой итерации. Каждый вызов это раунд-трип через модель, каждый ответ это JSON, который надо распарсить и передать в следующий вызов. Цикл на пять деталей превращается в десяток с лишним обменов.

Проблема в том, что JSON-схема плохой язык для выражения того, что агент и так знает. Приведение типа, цикл, временная переменная, ветвление, всё это в языке программирования выражается нативно, и LLM обучены на терабайтах такого кода. Разложенные на плоский список декларативных вызовов, те же операции становятся для модели непривычными: она хуже планирует цепочку, чаще теряет промежуточный хэндл, путает, что в какой вызов передавать. Мы забираем у агента ровно ту форму, в которой он силён, и заставляем работать в форме, которую он видел мало.

Поэтому решение получилось обратным по духу к MCP: дать LLM писать полноценный код и построить вокруг этого кода слои, которые ловят каждый класс ошибок до того, как он дойдёт до живого CAD. Остальная статья про эти слои.

Слой 1. Граф API

Первое, что нужно агенту до генерации, это знание, какие функции и типы вообще существуют в этой версии SDK. Компилятор такое не подскажет, он проверяет уже готовый код.

Я собрал граф из шести файлов описания COM-типов KOMPAS. Каждый файл зафиксирован по контрольной сумме, чтобы отследить ситуацию, если у клиента установлена другая сборка. Всего в графе 47 тысяч узлов (типы, функции, значения перечислений) и около 60 тысяч связей. Помимо связи «функция X принадлежит типу Y», отдельно хранится ещё один вид связи: «на объекте типа X вызов Y возвращает Z». По этим стрелкам агент ищет пути между интерфейсами.

Когда я собрал первый вариант и попробовал построить путь от главного объекта приложения к 3D-детали, оказалось, что он недостижим. Дело было в устройстве COM у KOMPAS. Один и тот же реальный объект часто прикидывается несколькими интерфейсами: то одним, то другим. Эта связь не выражена в описаниях типов напрямую, её нужно доставать из отдельной COM-конструкции. Пока я её не извлёк, граф не знал, что объект типа Part7 умеет обращаться к методу интерфейса IModelObject, а обычный документ можно привести к его 3D-версии.

Пришлось написать отдельный скрипт, который находит эти COM-классы в файлах описания типов и складывает список интерфейсов, которые каждый класс реализует одновременно. Плюс отсеивать интерфейсы-обработчики событий (их нельзя привести обратно, это односторонняя стрелка).

Отдельная возня была с интерфейсами-хабами вроде базового IKompasAPIObject, который встречается почти в каждом COM-классе. Если пускать его в переходы, поиск пути превращается в кашу «из чего угодно во что угодно». Я поставил порог отсечения (по умолчанию 10 классов) и вынес в переменную окружения, чтобы можно было калибровать.

На этом графе работают две функции, которые агент дёргает постоянно.

Первая: поиск ближайшего валидного имени. Агент попросил ActiveDocument3D, получил ответ «такого нет, ближайшее — ActiveDocument». Обычно за одну итерацию восстанавливается.

Вторая: поиск пути. Обход графа по проверенным стрелкам. Для задачи «обойти состав сборки» агент вместо имени получает готовый шаблон шагов:

IApplication.ActiveDocument -> IKompasDocument

привести к IKompasDocument3D

IKompasDocument3D.TopPart -> IPart7

IPart7.Parts -> IParts

IParts.Item(i) -> IPart7

Этот шаблон склеен из проверенных связей и работает как заготовка для генерации.

Слой 2. Справочник валидных значений

Есть ошибки, которые не поймёт ни граф, ни компилятор. Метод заполнения ячейки штампа IStamp.Text(cell_id, text) принимает целое число. Формально допустимо любое. Реально валидны только конкретные номера ячеек по ГОСТ 2.104. Агент без подсказки подставляет что попало:

stamp.Text(777, "МЧ.100.10.00.000") # 777 не существует

Код исполнится, ничего не упадёт, штамп останется пустым.

Я собрал курируемый справочник с константами KOMPAS: ячейки штампа, плоскости эскизов, типы объектов. Каждая запись хранит применимый паттерн (какой метод, какой аргумент) и таблицу разрешённых значений с русскими подписями («Обозначение документа», «Наименование изделия», «Материал», «Разраб.»). Компилятор дальше поднимает эту таблицу как правило и выдаёт предупреждение на литералах не из списка.

Слой 3. ГОСТ-база

С ЕСКД отдельная история. Даже когда агент угадал функции, он может сослаться в коде, комментариях или структуре спецификации на отменённый стандарт. Мне нужны были три вещи. Знать, какой стандарт сейчас действующий. Тихо мапить старое обозначение на актуальное, если пользователь по привычке назвал старую редакцию. И давать возможность процитировать раздел из локального текста стандарта, а не пересказывать по памяти.

Локальный корпус собирается в отдельный каталог. Внутри: инвентарь всех обработанных документов со статусами, каталоги действующих и отменённых, граф ссылок «ссылается на» и «заменяет», чанки текста для поиска. Резолвер по обозначению возвращает актуальный документ: либо тот же, если действующий, либо назначенную замену, либо практический аналог (несколько отменённых стандартов на крепёж вручную смапены на ISO-аналоги).

В проверке кода стоит правило: находим упоминания ГОСТ в исходнике и комментариях, если отменён, добавляем предупреждение. Не блокирует. Если инженер настаивает, оставит. Но в отчёт попадёт.

По текстам стандартов работает полнотекстовый поиск. Каждая цитата возвращается вместе с именем файла и его контрольной суммой на момент индексации. Это важно для норм-контроля: всегда видно, из какого документа взят фрагмент.

Слой 4. Компилятор-верификатор

Самый мощный слой стека. Прогоняю сгенерированный Python-скрипт через настоящий C#-компилятор.

Работает так. Транспилятор ходит по дереву Python-кода и переводит подмножество, которое агент реально пишет (присваивания, вызовы методов, приведения, if/else, return), в C#. Дальше C#-компилятор проверяет результат, опираясь на настоящие описания типов KOMPAS. Если конструкция транспилятором не поддержана, он возвращает None и пропускает такой скрипт. Это лучше, чем выдавать ложные ошибки на непокрытом синтаксисе.

Одна деталь. Агент часто пишет docs.Add(4, True) вместо docs.Add(SomeEnum(4), True). Транспилятор смотрит по графу, объявлен ли параметр как перечисление, и оборачивает литерал. Мелочь, но убирает пачку ложных ошибок.

Сборки описаний типов я делаю из лицензированных файлов напрямую, без вспомогательных утилит из платного SDK. На любой машине, где стоит KOMPAS, .NET Framework тоже есть, ничего доустанавливать не надо.

Дальше три реальных примера. Показываю: исходный Python от агента, что из этого получает транспилятор, и настоящий текст, который утилита отдаёт агенту обратно. Тексты фидбека приведены как есть, на английском, потому что именно в таком виде их видит LLM.

Пример 1. Галлюцинация метода

Агент придумал ActiveDocument3D. Такого поля у IApplication нет.

def run(app):

return app.ActiveDocument3D.TopPart

Транспилируется в:

using KompasAPI7;

using Kompas6API5;

using Kompas6Constants;

using Kompas6Constants3D;

public class Probe {

public static object Run(IApplication app) {

return app.ActiveDocument3D.TopPart;

return null;

}

}

Что agent получает обратно от утилиты:

Your code fails STRUCTURAL type-checking against the real KOMPAS type library

(compiled with the C# compiler against Interop.KompasAPI7.dll).

Fix these before it can run. KOMPAS separates API5 and API7 — do not mix them.

- CS1061: member does not exist on that interface

(wrong member or wrong API5/API7 interface)

(symbol: ActiveDocument3D)

did you mean: ActiveDocument, Documents, ApplicationName, Application

Rewrite `def run(app)` (Python, pywin32) using only members that exist.

Output ONLY the ```python code block.

Diag CS1061 — от настоящего csc. Строка did you mean — из графа, nearest_members по владельцу IApplication.

Пример 2. Приведение через границу API7 ↔ API5

Агент попытался привести app.ActiveDocument (это IKompasDocument из библиотеки KompasAPI7) к ksDocumentParam из старой библиотеки Kompas6API5. Формально оба типа существуют. Реально win32com.CastTo через границу двух разных typelib работает плохо и без известной COM-связи между интерфейсами почти гарантированно упадёт в runtime с E_NOINTERFACE.

def run(app):

doc = app.ActiveDocument

x = cast(doc, 'ksDocumentParam')

return x

Транспилируется в:

public class Probe {

public static object Run(IApplication app) {

var doc = app.ActiveDocument;

var x = ((ksDocumentParam)(doc));

return x;

return null;

}

}

C# такой каст спокойно компилирует, ошибок нет. Но guard добавляет свои предупреждения:

Static verifier warnings from checks the compiler cannot prove:

These are not hard structural errors; verify live behavior with the runner

when the code otherwise type-checks.

- CAST_TYPELIB_BOUNDARY: cast crosses a typelib boundary

(API7 ↔ API5/2D5/3D5/Constants);

win32com CastTo may not bridge that reliably

(symbol: IKompasDocument)

- QI_UNVERIFIED: cast target is not backed by a known coclass

co-implementation; runtime may raise E_NOINTERFACE

(symbol: IKompasDocument)

Это именно те два класса ошибок, ради которых я тащил из .tlb не только описания типов, но и список COM-классов. Компилятор про такое не знает: у него типы есть, каст между object и любым интерфейсом легален. Знание, что в живой COM это не заработает, лежит в отдельном файле cast_groups.jsonl, извлечённом из тех же .tlb.

Правильный вариант, который проходит без единой диагностики:

def run(app):

d3 = cast(app.ActiveDocument, 'IKompasDocument3D')

return d3.TopPart

Пример 3. Штамп с несуществующим номером ячейки

Агент решил вписать обозначение в штамп. Правильный номер ячейки «Обозначение документа» по ГОСТ 2.104 — 1. Агент подставил 777.

def run(app):

doc = cast(app.ActiveDocument, 'IKompasDocument2D')

layout = doc.LayoutSheets.ItemByNumber(1)

stamp = layout.Stamp

stamp.Text(777, 'МЧ.100.10.00.000')

return True

Здесь одновременно срабатывает два разных слоя. Guard понимает, что Text у IStamp — это параметризованное свойство (принимает cell_id и возвращает объект текста), а не метод для записи. Транспилятор переводит его в C# как get_Text:

public class Probe {

public static object Run(IApplication app) {

var doc = ((IKompasDocument2D)(app.ActiveDocument));

var layout = doc.LayoutSheets.get_ItemByNumber(1);

var stamp = layout.Stamp;

stamp.get_Text(777, "МЧ.100.10.00.000");

return true;

return null;

}

}

Обратная связь:

Your code fails STRUCTURAL type-checking against the real KOMPAS type library.

- CS1501: wrong number of arguments for this member (symbol: get_Text)

did you mean: Text, IText, ModelText, Vertex, ModelTexts

Static verifier warnings from checks the compiler cannot prove:

- APP_CONST_UNKNOWN: literal application-domain constant is not

in the curated KOMPAS app KB

(symbol: KompasStampCellEnum)

CS1501 от компилятора: Text принимает один аргумент (номер ячейки), а не два. APP_CONST_UNKNOWN от справочника валидных значений: 777 не входит в список номеров ячеек штампа. Первое агент чинит правкой формы вызова, второе — заменой литерала на конкретный designation (1), name (2) и так далее из подсказанного списка.

Слой 5. Live runner

Всё, что можно поймать статикой, до живого CAD доходить не должно. Всё, что нельзя, доходит. Этим занимается отдельный сервис.

Он стоит на Windows-машине с установленным KOMPAS. Минимальный набор операций: подготовить, запустить, сбросить, посмотреть, что внутри. Один рабочий процесс. Задачи сериализованы. Никакой параллельной работы с CAD.

Важное решение: скрипт исполняется не в основном сервисе, а в отдельном процессе, который стартует под каждый запуск. Основной сервис никогда сам не выполняет код агента и не держит открытые COM-объекты. Если что-то повесится или упадёт с ошибкой доступа к памяти, падает только дочерний процесс. Таймаут реализован как сторожевой цикл над этим процессом:

child = popen_hidden(cmd, ..., stdout=PIPE, stderr=PIPE, stdin=DEVNULL)

deadline = time.monotonic() + max(1, int(timeout_s))

while child.poll() is None and time.monotonic() < deadline:

time.sleep(0.05)

if child.poll() is None:

child.kill()

return {"ran": False, "timeout": True, ...}

Внутри дочернего процесса ограниченный набор встроенных функций, единый вход def run(app), стандартная обёртка над KOMPAS-приложением. На выходе стандартный результат с полями: выполнился ли, что вернул, тип исключения, код ошибки COM, хвост стека, был ли таймаут. На этом формате работает следующий слой.

Классификатор ошибок исполнения

Есть ошибки, которые формально правильные, а по сути бесполезные. Код исполнился, а чек задачи не сошёлся. Активный документ оказался обычным IKompasDocument, а нужен был 3D. Свойство позвали как метод.

Классификатор превращает сырой результат работы runner в структурированную классификацию и подсказку агенту. Внутри набор регэксп-правил по текстам исключений и кодам COM-ошибок. Каждое правило даёт стабильный тип ошибки и подсказку.

Пример. В тексте ошибки встретился IKompasDocument и один из TopPart, Part, GetPart, AttributeError. Тип: «нужно привести к 3D-документу». Подсказка агенту: d3 = cast(app.ActiveDocument, 'IKompasDocument3D'); part = d3.TopPart.

Отдельный интересный случай: расхождение между базой и реально установленной сборкой. Если исполнение упало «у интерфейса нет такого поля» на типизированной обёртке, возможно, поле было в описании, но в установленной сборке KOMPAS его нет. Классификатор в этом случае обращается к runner и получает настоящий список методов из живой библиотеки типов.

Как это работает вместе

Один шаг агента выглядит так.

1. Запрос контекста. Граф даёт релевантные интерфейсы, готовые шаблоны путей, релевантные значения из справочника, привязку к текущей редакции ГОСТ.

2. Агент пишет def run(app): ....

3. Проверка. Компилятор, справочник валидных значений, актуальность ГОСТ. На выходе результат, ошибки, предупреждения.

4. Агент правит по фидбеку. Обычно одна итерация на структурные ошибки.

5. Runner запускает код на живом CAD.

6. Классификатор. Если не отработало, разбор ошибки превращается в инструкцию по починке.

7. Ещё одна итерация правки. Финальный отчёт.

Как попробовать

KOMPAS-GUARD собран как готовый бинарный пакет под Windows x64 и ставится обычной командой pip install kompas-3d-guard. После установки доступны консольная команда kompas-guard и библиотека для Python kompas_guard, а kompas-guard up поднимает локальные службы: сервис контекста и исполнитель кода на живом CAD. Для работы на живом CAD нужен установленный КОМПАС-3D с зарегистрированным COM API (проверено на v24), всё остальное, включая скомпилированную среду исполнения и данные по API и ГОСТ, уже внутри пакета. Полная инструкция, описание навыка для агента и контрольная сумма сборки лежат в репозитории: github.com/dwnmf/kompas-3d-guard-bin

Сам подход не завязан на KOMPAS-3D: те же слои (граф API, справочник значений, проверка кода до запуска, разбор ошибок исполнения) ложатся на любой CAD с программным доступом. Если у вас есть похожие задачи, в том числе под SolidWorks, AutoCAD или другую систему, напишите мне на почту hello@kompasmcp.ru, можем разобрать ваши случаи