Практика

Сценарии RevitAiTools: 9 задач, которые выполняет AI-агент в Revit

Ниже — задачи, которые действительно решаются инструментами RevitAiTools. Для каждой: что делает агент, какой результат возвращает и какое ограничение действует. Это не обещание «любых задач», а описание проверенных сценариев.

Как читать сценарии

Каждый сценарий начинается с чтения и заканчивается проверкой. Даже там, где агент создаёт элементы, сначала он получает факты из модели, затем выполняет действие и возвращает отчёт. Если шаг нельзя проверить, сценарий не считается выполненным.

Запись в модель всегда идёт через транзакцию хоста. Там, где есть выбор между «сделать сразу» и «сначала показать план», выбран план: удаление, параметры и семейства имеют безопасный режим.

Аудит модели и инвентаризация

Задача: Понять, что реально лежит в модели: уровни, типы, стены, помещения, виды, листы, шаблоны.
Что делает агент: get_document_info, get_levels, get_all_views, get_all_sheets, get_all_schedules
выборки по категориям с фильтрами
read-only, без транзакции
Результат: Структурированный дамп (manifest/levels/types/walls/floors/rooms) с ключами вместо ElementId.
Ограничение: Дамп отражает только активный документ и то, что видно в текущем состоянии модели.

Пакетное заполнение параметров

Задача: Заполнить номера, имена и атрибуты помещений по правилу, не испортив формулы и read-only поля.
Что делает агент: parameter_write_plan классифицирует значения и возвращает contextToken
set_parameter_value с policy=enforce и acceptReview для REVIEW
пакет от 1 до 200 значений
Результат: Изменённые параметры и отчёт: что записано, что отклонено и почему.
Ограничение: READ_ONLY и формульные параметры не пишутся; конфликт источника и несовпадение единиц — отказ.

Спецификации, виды и листы

Задача: Собрать комплект документации: спецификации, виды на листах, нумерация.
Что делает агент: create_schedule / add_schedule_field / add_schedule_sorting
create_sheet / place_viewport / renumber_sheets
check_schedule_quality
Результат: Созданные спецификации и листы с проверкой качества.
Ограничение: Порядок шагов фиксирован; перестановка ломает зависимости между видами и листами.

Теплотехника и MEP-расчёты

Задача: Считать теплопотери/теплопоступления, гидравлику, водоснабжение по данным модели.
Что делает агент: предварительная проверка возвращает need_input и список недостающих данных
heat_calc_loss / heat_calc_gain / hydraulic_calc / water_supply_calc
запись результата — отдельным write-инструментом в транзакции
Результат: Расчёт с явными единицами и списком исходных допущений.
Ограничение: Без заполненных исходных данных расчёт не начинается; это не «угадай за инженера».

Создание семейства

Задача: Собрать параметрическое семейство: параметры, геометрия, типы, материалы.
Что делает агент: family_list_templates / create_new_family / open_family_document
family_add_parameter_v2, create_extrusion / create_blend / create_sweep
family_validate → save_family → load_into_project
Результат: Проверенный .rfa и загруженный в проект типоразмер.
Ограничение: Экспериментальные параметрические примитивы включаются отдельным флагом; чужой .rfa не перезаписывается молча.

Стены, проёмы и помещения по плану

Задача: Поднять планировку: уровни, стены, перекрытия, двери/окна, помещения, потолки.
Что делает агент: create_level / create_level_array
create_wall / create_walls_batch / place_door / place_window
create_floor / create_roof_by_footprint / create_ceiling / create_room
Результат: Фазированная модель с проверкой количества элементов на каждом шаге.
Ограничение: Нет одного «импорта плана»: сборка идёт шагами, каждый шаг проверяется.

Быстрый CSX-скрипт

Задача: Выполнить разовую операцию, для которой нет готового инструмента.
Что делает агент: quick_script_save сохраняет скрипт
code_runner_compile проверяет компиляцию
code_runner_execute выполняет с доступом к Doc, UIDoc, UIApp
Результат: Результат скрипта и журнал выполнения.
Ограничение: Скрипт исполняется без автоматической транзакции: изменения модели нужно оборачивать самому.

UI-инспекция и read-back

Задача: Проверить, что значение реально попало в поле интерфейса, а не только в ответ инструмента.
Что делает агент: ui_state / ui_ai_find / ui_get_value
ui_set_value с обязательным чтением обратно
ui_capture для снимка состояния
Результат: Подтверждённое значение и снимок окна.
Ограничение: UI-сервер — отдельный контур; он не заменяет проверку модели через API.

Работа из Claude Code через MCP

Задача: Управлять Revit из привычного AI-клиента, не переключаясь в отдельное приложение.
Что делает агент: stdio-мост регистрируется как сервер `revit`
клиент получает каталог инструментов и вызывает их по задаче
запись — после плана и на копии модели
Результат: Диалог с моделью, где каждый шаг опирается на фактический ответ Revit.
Ограничение: Сервер живёт только при запущенном Revit; при закрытии приложения инструменты недоступны.

Чего эти сценарии не делают

Не проектируют за инженера и не гарантируют соответствие нормам.
Не отменяют уже закоммиченные изменения по команде rollback.
Не работают с неактивным документом через stdio-мост.
Не запускаются, если Revit закрыт: сервер живёт внутри приложения.
Не являются «автопилотом»: каждый шаг опирается на проверяемый ответ модели.

Технические детали каждого ограничения — в разделе «MCP-сервер» и на странице совместимости. Если задача не попадает ни в один сценарий, её стоит проверить на копии модели до записи.