Коротко
- dll2llm — инструмент командной строки, который анализирует сборки .NET и может создавать папку Agent Skill.
- В качестве входных данных можно указать RevitAPI.dll; если нужен слой пользовательского интерфейса, добавьте RevitAPIUI.dll.
- В созданную папку входят SKILL.md, INDEX.md и тематические файлы, сгруппированные по пространствам имён.
- Для изменений в Revit требуется Transaction; SubTransaction можно использовать внутри открытой Transaction.
Что вы узнаете из этого руководства?
ИИ-агент, работающий с Revit API, не всегда может правильно выбрать класс или метод, опираясь только на общие знания программирования. В руководстве Autodesk Platform Services (APS) это объясняется недостатком контекста API: агент может знать распространённые типы, но ошибаться при выборе менее известных методов. У Revit API множество классов и пространств имён, поэтому предоставлять всю информацию в одном текстовом файле тоже не слишком практично.
В этом руководстве мы рассмотрим, как создать папку Agent Skill на основе сборок Revit API и использовать её в процессе разработки агента. Цель — не настроить автоматизацию Revit от начала до конца, а предоставить агенту более структурированный и доступный для поиска контекст API. В качестве инструмента для этой задачи Autodesk приводит dll2llm — утилиту командной строки.
Требования и ограничения
Для этого процесса необходим доступ к сборкам Revit API. В руководстве APS предлагается указать инструменту файл RevitAPI.dll и, если требуется также слой пользовательского интерфейса, добавить RevitAPIUI.dll. В руководстве есть демонстрация, в которой исходные файлы берутся из каталога установки Revit, после чего создаётся папка навыка.
Инструмент представлен как проект dll2llm на GitHub: он анализирует сборку .NET и преобразует её в файлы Agent Skill. В источнике не указаны поддерживаемые операционные системы, необходимая версия .NET, матрица совместимости с версиями Revit, команды установки или конкретный продукт для работы с агентом. Поэтому приводить здесь команды, пути в меню или предположения о версиях было бы неправильно. Перед началом работы проверьте актуальное описание проекта dll2llm и DLL-файлы в используемой установке Revit.
В официальном руководстве в числе основных файлов созданной папки названы SKILL.md, INDEX.md и тематические файлы Markdown. Тематические файлы сгруппированы по пространствам имён; крупные пространства имён могут делиться на части в алфавитном порядке, чтобы не перегружать контекстное окно. В источнике не говорится о необходимости учётной записи, поэтому в этом руководстве такое требование не предполагается.
Создание Agent Skill: пошаговая инструкция
Определите цель. Сначала уточните, в каких задачах с Revit API должен помогать агент. Например, чтение данных модели, фильтрация элементов и внесение изменений в модель могут требовать разных знаний API. Autodesk представляет Agent Skill как способ предоставить агенту контекст API; сам инструмент не определяет требования проекта.
Выберите необходимые сборки. RevitAPI.dll — основной входной файл, содержащий слой базы данных Revit API. Если агенту нужны сведения о слое пользовательского интерфейса, рассмотрите возможность добавить RevitAPIUI.dll. В статье APS говорится, что второй файл можно использовать дополнительно. Не считайте, что обе сборки обязательны для каждой задачи: их состав зависит от потребностей проекта.
Изучите проект dll2llm. Инструмент представлен как проект dll2llm на GitHub. Поскольку в исходном тексте нет подробностей об установке и запуске, мы не приводим конкретную команду терминала. Следуйте инструкциям проекта и проверьте, какой путь к сборке инструмент ожидает получить в качестве входных данных.
Передайте сборку инструменту. В описанном в руководстве APS процессе dll2llm указывают сборки из каталога установки Revit. Выберите RevitAPI.dll и, если требуется, RevitAPIUI.dll, а результат сохраните в отдельной папке навыка. Согласно руководству, файлы в полученной структуре разделены по пространствам имён, поэтому результат может состоять не из одного длинного документа по API.
Проверьте созданные файлы. Убедитесь, что помимо SKILL.md и INDEX.md появились тематические файлы Markdown. Они содержат сведения об API, сгруппированные по пространствам имён. Разделение крупных пространств имён по алфавиту помогает избежать превращения контекста агента в один огромный массив данных. Не считайте файлы проверенными примерами кода только потому, что они созданы: инструмент формирует контекст API, но не тестирует логику вашего проекта.
Добавьте навык в рабочий процесс агента. Согласно подходу Autodesk, после настройки навыка агент может обращаться к справочной информации Revit API во время выполнения задачи. Цель — сократить необходимость по очереди копировать и вставлять фрагменты кода в окно чата и предоставить агенту более широкий контекст API. В этом источнике не описано, какие агенты поддерживают формат навыков и как именно его установить; обратитесь к инструкциям своей среды.
Проверяйте предложения кода на небольших задачах. Не доверяйте автоматически коду, созданному агентом. Сначала проверьте, соответствуют ли имена классов и методов сформированному справочнику, а затем — даёт ли операция ожидаемый результат в целевой модели. Особенно тщательно проверяйте управление транзакциями в коде, который изменяет модель: для внесения изменений в Revit необходима Transaction, и одновременно может быть открыта только одна Transaction. После успешного завершения операции изменения сохраняются с помощью Commit; RollBack отменяет их. В документации Revit API также указано, что можно проверять состояния этих операций.
Частые ошибки
Путать контекст API с проверкой проекта: Skill предоставляет агенту сведения о типах и пространствах имён API, но не доказывает, что созданный код будет корректно работать в проекте. Отдельно проверяйте, что именно код делает с моделью.
Игнорировать порядок работы с Transaction: операции, изменяющие модель, должны выполняться в контексте Transaction. SubTransaction можно использовать, чтобы логически разделить более крупную задачу, но её необходимо создать внутри открытой Transaction и закрыть до завершения родительской транзакции. TransactionGroup можно использовать для совместной обработки нескольких независимых транзакций; её нельзя начать, пока открыта Transaction.
Добавлять ненужные файлы: в руководстве RevitAPIUI.dll описана как дополнительный входной файл, который можно использовать, если необходим слой пользовательского интерфейса. Вместо добавления ненужного содержимого соотносите охват навыка с задачей.
Делать предположения о версиях и установке: в статье APS нет подробной таблицы совместимости или команды установки. Поэтому зафиксируйте, из какой сборки Revit получен файл, следуйте инструкциям dll2llm и не предполагайте, что другие версии дадут такой же результат.
Дальнейшие шаги: рабочие процессы в архитектуре и визуализации
Метод может пригодиться BIM-командам, разработчикам плагинов и студентам, изучающим API, если они регулярно извлекают данные из Revit или редактируют модели. Более уверенный поиск классов API агентом может помочь сократить количество ошибочных предположений о методах при создании прототипов. Однако это не отменяет проверку модели, ревью кода и тестирование рабочего процесса в условиях реального проекта. Архитектурным и интерьерным бюро метод может быть особенно полезен при разработке внутренней автоматизации и поиске справочной информации для сотрудников, которые только начинают работать с API.
Revit API Agent Skill не улучшает качество рендеринга напрямую: он предназначен для работы с программным обеспечением и автоматизацией, использующими данные модели. Для команды визуализации возможная область применения — разработка инструментов для автоматизации получения информации из Revit или внесения изменений в модель. В источниках не указаны расходы на оборудование, лицензии или подписки на сервисы для агентов. Перед началом работы отдельно оцените действующие программные условия и поддержку навыков в используемой среде агента.
Источники и лицензия
Это руководство подготовлено на основе описаний dll2llm и Agent Skill в статье Autodesk Platform Services «Let AI Write Your Revit Code», а также определений Transaction, SubTransaction и TransactionGroup в документации Autodesk Revit API. Для источников указана лицензия=свободная; текст и инструкции изложены своими словами. Описание курса Autodesk University для начинающих изучать Revit API использовано в качестве дополнительного источника по темам API, фильтрации и Transaction.
Источники
Источников: 3Тексты источников не перепечатываются; короткие цитаты отмечены, остальное — наш пересказ и комментарий.
Для бюро и студентов в Турции практическая ценность подхода Agent Skill заключается в том, что систематизированную справочную информацию по API можно встроить в рабочий процесс агента. Команды, которые работают с повторяющимися задачами по обработке данных модели или прототипами плагинов, смогут быстрее проверять предложения кода.
Однако папка навыка сама по себе не является готовой автоматизацией или проверенным плагином. Заранее проверьте доступ к DLL, поддержку навыков в среде агента и условия использования программного обеспечения. Поскольку источники не содержат сведений о стоимости оборудования или лицензий, эти статьи расходов нужно уточнить отдельно при расчёте инвестиций.
Частые вопросы
Какие файлы нужны для Revit API Agent Skill?
В руководстве Autodesk предлагается передать инструменту dll2llm файл RevitAPI.dll. Если необходим также слой пользовательского интерфейса, можно добавить RevitAPIUI.dll.
Какие файлы создаёт dll2llm?
Согласно руководству APS, инструмент создаёт папку навыка с файлами SKILL.md, INDEX.md и тематическими файлами Markdown, сгруппированными по пространствам имён.
Нужна ли Transaction для кода, изменяющего модель в Revit?
Да. В документации Revit API указано, что для внесения изменений в модель необходима Transaction и одновременно может быть открыта только одна Transaction.



