Последние новости
Получение данных о поверхности и пересечениях с узлом Raycast Node в Blender Geometry NodesAfter Night There Is Nothing: инсталляция с тремя куполами в ШарджеGraphic Override Rules в Archicad 29: руководство по созданию правилАнализ архитектурных изображений с Gemma 4: установка и работа в PythonBlender Bevel Modifier: контролируемая фаска без изменений геометрииПовышаем производительность SketchUp: лёгкое моделирование и CAD-обменКак запускать плагин Revit в облаке с APS Design AutomationКак создать Revit API Agent Skill: руководство по dll2llmГлобальные параметры и Parameters Service в Revit: практическое руководствоРуководство по MAXScript в 3ds Max: как открыть и запустить скрипт
УрокиRevitdll2llm

Как создать Revit API Agent Skill: руководство по dll2llm

В руководстве Autodesk APS описан рабочий процесс создания Agent Skill с помощью dll2llm, который передаёт ИИ-агентам знания о Revit API. Разбираем необходимые файлы и этапы работы.

Дизайнер работает с BIM-моделью в архитектурной студииИИ-изображение
Иллюстрация создана с помощью ИИ.Изображение: 3dsınıfı / FCA AI

Коротко

  1. dll2llm — инструмент командной строки, который анализирует сборки .NET и может создавать папку Agent Skill.
  2. В качестве входных данных можно указать RevitAPI.dll; если нужен слой пользовательского интерфейса, добавьте RevitAPIUI.dll.
  3. В созданную папку входят SKILL.md, INDEX.md и тематические файлы, сгруппированные по пространствам имён.
  4. Для изменений в 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: пошаговая инструкция

  1. Определите цель. Сначала уточните, в каких задачах с Revit API должен помогать агент. Например, чтение данных модели, фильтрация элементов и внесение изменений в модель могут требовать разных знаний API. Autodesk представляет Agent Skill как способ предоставить агенту контекст API; сам инструмент не определяет требования проекта.

  2. Выберите необходимые сборки. RevitAPI.dll — основной входной файл, содержащий слой базы данных Revit API. Если агенту нужны сведения о слое пользовательского интерфейса, рассмотрите возможность добавить RevitAPIUI.dll. В статье APS говорится, что второй файл можно использовать дополнительно. Не считайте, что обе сборки обязательны для каждой задачи: их состав зависит от потребностей проекта.

  3. Изучите проект dll2llm. Инструмент представлен как проект dll2llm на GitHub. Поскольку в исходном тексте нет подробностей об установке и запуске, мы не приводим конкретную команду терминала. Следуйте инструкциям проекта и проверьте, какой путь к сборке инструмент ожидает получить в качестве входных данных.

  4. Передайте сборку инструменту. В описанном в руководстве APS процессе dll2llm указывают сборки из каталога установки Revit. Выберите RevitAPI.dll и, если требуется, RevitAPIUI.dll, а результат сохраните в отдельной папке навыка. Согласно руководству, файлы в полученной структуре разделены по пространствам имён, поэтому результат может состоять не из одного длинного документа по API.

  5. Проверьте созданные файлы. Убедитесь, что помимо SKILL.md и INDEX.md появились тематические файлы Markdown. Они содержат сведения об API, сгруппированные по пространствам имён. Разделение крупных пространств имён по алфавиту помогает избежать превращения контекста агента в один огромный массив данных. Не считайте файлы проверенными примерами кода только потому, что они созданы: инструмент формирует контекст API, но не тестирует логику вашего проекта.

  6. Добавьте навык в рабочий процесс агента. Согласно подходу Autodesk, после настройки навыка агент может обращаться к справочной информации Revit API во время выполнения задачи. Цель — сократить необходимость по очереди копировать и вставлять фрагменты кода в окно чата и предоставить агенту более широкий контекст API. В этом источнике не описано, какие агенты поддерживают формат навыков и как именно его установить; обратитесь к инструкциям своей среды.

  7. Проверяйте предложения кода на небольших задачах. Не доверяйте автоматически коду, созданному агентом. Сначала проверьте, соответствуют ли имена классов и методов сформированному справочнику, а затем — даёт ли операция ожидаемый результат в целевой модели. Особенно тщательно проверяйте управление транзакциями в коде, который изменяет модель: для внесения изменений в 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
H
help.autodesk.comhelp.autodesk.com/view/RVT/2013/ENU/caas.html
Пересказ
A
aps.autodesk.comaps.autodesk.com/blog/let-ai-write-your-revit-code
Пересказ
A
autodesk.comautodesk.com/autodesk-university/de/class/Revit-Programming-Beginners-Easily-Access-Revit-API-Using-Free-Tools-2018
Пересказ

Тексты источников не перепечатываются; короткие цитаты отмечены, остальное — наш пересказ и комментарий.

Мнение 3dsınıfı
3dОценка редактора

Для бюро и студентов в Турции практическая ценность подхода 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.

Комментарии и форум — на турецком языке.Присоединиться к обсуждению
+

Похожие новости