ИИ-ассистент "Котангл"
ИИ-ассистент "Котангл"
В платформу Tangl встроен интеллектуальный помощник (ИИ-ассистент) "Котангл", который помогает быстрее и проще анализировать строительные BIM-модели. Главная задача этого инструмента – сделать работу с моделями доступной даже для тех специалистов, которые не являются экспертами в технологиях информационного моделирования. Для специалистов ИИ-ассистент позволяет за несколько минут получать точные и полезные выводы по конкретному проекту.
ИИ-ассистент работает как с отдельной моделью, так и со структурой всего проекта – он отслеживает изменения и версии данных, что позволяет получать более точные выводы и видеть полную картину.
ИИ-ассистент «Котангл» выполняет роль посредника между пользователем и базой данных платформы Tangl (BIM-модели, документация, отчеты ). Он принимает запросы, собирает необходимую информацию (модели, документы) и отправляет её на обработку во внешнюю нейросеть, которая и выступает в качестве вычислительного ядра.
Для работы ассистента у Компании должна быть подключена собственная нейросеть, которая и выполняет основной анализ, а ИИ-ассистент создаёт для неё точный структурированный запрос на основе информации, которая загружена в защищенное хранилище Tangl. Если для формирования ответа не хватает данных или запрос выходит за рамки компетенций ИИ-ассистента, он честно предупреждает об этом пользователя.
В качестве внешней нейросети рекомендуется использовать GPT 5.4 от OpenAI.
Получив ответ от внешней нейросети, ассистент показывает его пользователю и может визуализировать результаты прямо на 3D-модели. Аналитика тарифицируется в токенах: система выделяет лимиты на каждый день, а руководители могут легко отслеживать статистику их расхода по каждому сотруднику.
Интерфейс
Кнопка вызова "Котангла" расположена в правом нижнем углу.

По нажатию раскроется интерфейс окна чата "Уголок Котангла" поверх рабочей области. Окно можно перемещать и располагать, как удобно. Также можно менять размер самого окна.

Управление
Левая часть окна содержит интерфейс управления ИИ-ассистентом.
Вкладка "Задачи" является менеджером чатов пользователя с ИИ-ассистентом. Вся переписка с ИИ автоматически сохраняется в менеджере чатов и привязывается к учетной записи пользователя, при этом диалоги группируются по датам. Диалоги получают названия из первых сообщений и автоматически тегируются по проектам, моделям или версиям анализа, что позволяет в любой момент вернуться к прошлым обсуждениям и продолжить работу с контекстом.
"Котангл" строго соблюдает права доступа: пользователь может получать от ИИ информацию только по тем моделям и справочникам, на просмотр которых у него есть системное разрешение.
Найти диалог по названию или отфильтровать по тегу можно при помощи поля поиска и кнопки фильтрации по тегам над списком диалогов.
При желании, пользователь может отредактировать наименование чата или удалить сам чат при помощи кнопок «Редактировать» и «Удалить»

Вкладка "Инструменты" позволяет тонко настроить ИИ-ассистент. Она содержит набор системных команд (API-методов), которые ИИ-ассистент использует для работы с платформой. С их помощью текстовые запросы пользователя преобразуются в формализованные операции поиска, анализа, валидации и расчетов данных BIM-модели. Нажав на команду, можно отключить ее. Групповое отключение и включение команд осуществляется при помощи кнопок "все" и "нет" – таким образом можно отключить блок команд.
Инструменты, способные привести к безвозвратной потере данных, имеют более строгую визуальную маркировку уровня риска: маркером MEDIUM отмечены базовые операции удаления моделей, маркером HIGH – удаление версий объектов или элементов из корзины, а маркером CRITICAL – самые опасные и необратимые действия по окончательной очистке данных.
Команды отмечены индикаторами, отображающими логику выполнения команд: зеленый – на стороне клиента, синий – на стороне сервера.

Вкладка "Источники" содержит список загруженных источников и позволяет подключать и отключать их, отметив необходимые. Сами источники загружаются в отдельном интерфейсе (см. ниже Источники данных).

Вкладка "Модели" отображает список подключенных внешних нейросетей.

Чат
Само окно чата с ИИ-ассистентом расположено справа. Для удобства, можно свернуть левую панель, оставив только непосредственно чат.

Чат "Котангла" поддерживает как текстовые запросы, так и голосовые. Пользователь может, нажав иконку микрофона, надиктовать запрос. Или, включить режим ожидания кодовой фразы, услышав которую "Котангл" начнет записывать запрос пользователя.
Пока ИИ-ассистент формирует ответ, отправить следующий запрос нельзя.

Ответы ИИ-ассистента можно получать в свободном и строгом режимах. Переключение режима производится кнопкой "Режим":
Строгий режим предназначен для точной валидации данных, работы с регламентами и детализированной технической проверки модели. В этом режиме «Котангл» классифицирует элементы строго по общеизвестным классификаторам (например, ГЭСН, КСР, Uniformat) или по конкретным критериям, заданным пользователем. ИИ-ассистент проводит точечные проверки информации в модели на соответствие требованиям экспертиз и EIR. При расчетах "Котангл" строго опирается на свойства элементов, возвращая только те объемы, которые указаны в модели, не придумывая значения самостоятельно. Ответы формируются в виде детальных интерактивных таблиц, с помощью которых пользователь может выделять и проверять конкретные элементы в 3D-просмотрщике для обоснования источника информации. Кроме того, режим обеспечивает строгий контроль доступа, выдавая данные только по тем сущностям, к которым у пользователя есть права на чтение;

Свободный режим ориентирован на гибкую аналитику, быстрое получение сводной информации и самостоятельную работу языковой модели с естественными запросами. В этом режиме ИИ-ассистент способен находить и структурировать наборы элементов здания по простому текстовому запросу. "Котангл" может классифицировать элементы и рассчитывать объемные показатели выборки самостоятельно, анализируя суть каждой группы без привязки к заранее заданным пользователем параметрам или классификаторам. Режим позволяет получать сводку по объемам и стоимости, используя свободное описание позиций, а не их точные коды или названия. Также свободный режим дает ИИ-ассистенту возможность проводить дополнительные логические расчеты с объемами (например, вычислять необходимое количество рейсов грузовых машин) или анализировать выгоду от замены одних элементов модели на другие.

Для удобного взаимодействия в чате можно включить дополнительные вопросы при помощи соответствующей кнопки – "Котангл" будет задавать несколько уточняющих вопросов после вывода ответа на запрос. Пользователь может выбрать один из уточняющих вопросов.

При желании, пользователь может очистить чат кнопкой "Очистить чат".

Токены
Все запросы к ИИ-ассистенту потребляют токены. Расход токенов отображается в строке внизу окна чата.

Токены в Tangl — это единицы измерения объема информации, которую обрабатывает ИИ. Это своего рода «цифровые слоги», из которых строятся вопросы пользователя и ответы системы.
Любой текст и данные о модели, которые пользователь отправляет в чат, переводятся в токены. Чем длиннее сообщение и чем больше в нем данных о проекте, тем больше токенов расходуется. Чтобы ИИ «помнил» суть разговора, при каждом новом вопросе он заново перечитывает историю текущего чата. Счетчик токенов показывает суммарный объем этой памяти. Если счетчик становится слишком большим, ИИ сложнее фокусироваться на задаче. В этом случае эффективнее создать новый чат.
Узнать количество израсходованных и оставшихся токенов можно на странице "Использование ИИ" – для просмотра страницы необходимо нажать на кнопку шестеренки и в открывшемся меню выбрать пункт "Использование ИИ".

Страница отображает общие затраты токенов компании, а также детализацию расходов по каждому пользователю за интересующий период.

Верхняя часть страницы содержит фильтр выбора отчетного периода: 7 дней, 30 дней, 90 дней и за все время использования.

Ниже расположен блок из четырех информационных карточек. В них выводятся ключевые сводные метрики: суммарное количество израсходованных токенов, число активных пользователей, количество задействованных моделей и актуальный остаток баланса токенов компании.

Основную часть экрана занимает таблица с подробной статистикой использования. Данные в ней сгруппированы по типу подключения, внутри которой раскрывается распределение ресурсов между конкретными пользователями.
Таблица содержит столбцы:
Credential – указывает на используемые учетные данные или группу подключения;
Модель – отображает название задействованной модели искусственного интеллекта;
Endpoint — адрес конечной точки или шлюза для подключения;
Пользователи — показывает количество пользователей, входящих в данную группу;
Токены — суммарное количество израсходованных токенов по данной строке. Возле названия столбца есть иконка сортировки: по убыванию, по возрастанию.

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

Откроется страница для работы с источниками на которой можно добавить источники в виде файлов, отредактировать название источника или удалить устаревшие источники.

Поддерживается загрузка файлов форматов pdf, xlsx, docx, txt, md, csv, а также прямая вставка текста из буфера обмена. Загрузка осуществляется простым перетаскиванием (drag-and-drop) или через выбор файла. Видеть общий список источников и редактировать его могут пользователи с ролями Администратор, Менеджер, Редактор, Тест-Драйвер и Партнер.
На данный момент для всех проектов используется общая база источников. Подключенные к проекту источники отображены на вкладке "Источники для ИИ-агента" в проекте и интерфейсе "Котангла".

Примеры использования
Поиск элементов
"Котангл" позволяет управлять 3D-моделью с помощью обычных текстовых запросов. ИИ-ассистент способен самостоятельно изучать метаданные модели, сопоставлять логические условия пользователя (например, тип объекта и его расположение по высоте) с внутренними параметрами базы данных и визуально выделять нужные элементы прямо на 3D-модели.
Пример:
- Пользователь открывает чат с ИИ рядом с 3D-моделью здания и вводит задачу: "Выведи список всех учебных помещений на отметке +3.750".
- ИИ-ассистент сначала проверяет доступные свойства модели, определяет, как в ней называются помещения и уровни (находит категорию IFCSpace), а затем отфильтровывает нужную высотную отметку.
- ИИ-ассистент успешно генерирует текстовый список всех подходящих помещений, указывая их номера и названия.
- Пользователь отправляет следующий запрос: "Выдели все эти помещения в модели".
- ИИ-ассистент мгновенно обрабатывает команду, обращается к элементам сцены и визуально подсвечивает 21 найденное помещение на самой 3D-модели здания.

Работа с элементами модели
ИИ-ассистент способен фильтровать элементы модели по их расположению (например, по принадлежности к конкретному этажу) и извлекать их свойства. "Котангл" умеет по текстовому запросу пользователя группировать найденные элементы, суммировать их числовые показатели (такие, как площадь) и выводить результат в виде интерактивной таблицы, которая двусторонне связана с визуальным отображением модели.
Пример:
- Пользователь отправляет в чат команду: "Выведи экспликацию помещений первого этажа".
- ИИ-ассистент самостоятельно исследует доступные метаданные, определяет нужную категорию и уровень, после чего сообщает, что нашел 59 помещений, и выводит их первичный список.
- Пользователь просит организовать данные: "Сгруппируй помещения по названию и сделай интерактивную таблицу".
- ИИ-ассистент обращается к базе данных и генерирует таблицу, где помещения разбиты на категории (тамбур, спальня, кухня и т.д.) с указанием количества комнат каждого типа.
- Пользователь уточняет: "Выведи суммарную площадь каждой группы помещений".
- ИИ-ассистент выводит итоговую таблицу с подсчитанной площадью для каждой строки.
- Пользователь выделяет курсором определенные строки в сгенерированной таблице (например, выбирает группы "Кухня", "Спальня", "Ванная"), и они выделяются в дереве модели и на модели во вьювере.

Работа с формулами
ИИ-ассистент способен генерировать, тестировать и отлаживать математические и логические формулы для расчетов внутри BIM-модели. Он способен не только писать синтаксис по запросу, но и валидировать его: при обнаружении отсутствующих параметров ИИ-ассистент автономно исследует метаданные модели, находит реальные свойства элементов и помогает пользователю скорректировать первоначальную задачу.
Пример:
- Пользователь отправляет запрос на создание формулы с условной логикой: если параметр типа подсчета равен 1, то площадь умножается на 50 (штуки), а если равен 2, то берется просто значение площади.
- "Котангл" формирует базовую формулу и пытается применить ее к модели. В процессе он обнаруживает ошибку, так как параметр для определения типа подсчета у стен не заполнен или отсутствует. Чтобы найти решение, ИИ-ассистент автономно вызывает команды для проверки свойств модели и запрашивает через SQL-подобный синтаксис реальные параметры материалов. Результат выводится пользователю в виде таблицы с доступными характеристиками.
- Пользователь просит скорректировать формулу и передает ИИ-ассистенту точный системный путь к параметру в модели.
- ИИ-ассистент переписывает формулу с учетом правильного пути и синтаксиса платформы .
ИИ-ассистент также может предоставить подробную расшифровку формулы, которую предоставил ему пользователь: как именно она работает и что означает каждый ее элемент.

Работа с проектами
ИИ-ассистент может самостоятельно анализировать запросы на создание папок, интерпретировать логику вложенности и находить нужные модели для загрузки. Он способен не только выстраивать иерархию папок по описанию, но и связывать конкретные модели со структурой проекта.
Пример:
- Пользователь открывает чат в интерфейсе управления проектами и отправляет подробный запрос: "В проекте Губернаторский лицей создай структуру папок: верхний уровень – номер блока, нижний уровень – раздел документации. Загрузи в папки соответствующие модели. Раздел в моделях указан в названии после "Р"".
- ИИ-ассистент анализирует запрос и отвечает, что не знает, из каких моделей состоит проект и по какому правилу выделять номер блока.
- Пользователь корректирует запрос, указывая, что модели нужно взять из текущей открытой компании, и объясняет правило выделения номера блока: «Блок и номер».
- "Котангл" понимает новые вводные, анализирует доступные модели компании, находит нужные, создает структуру папок по правилу «блок/раздел» и загружает в них 30 моделей.
- Пользователь закрывает чат и проверяет структуру проекта: ИИ-ассистент успешно создал папки с номерами блоков ("Блок1", "Блок2" и т.д.), внутри которых создал папки с разделами ("АОВ», "ОС СОД" и т.д.), и распределил соответствующие BIM-модели по нужным разделам.

Взаимодействие с 3D-моделью
ИИ-ассистент позволяет пользователю управлять 3D-моделью с помощью текстовых запросов на естественном языке, превращая их в операции поиска, фильтрации и визуализации элементов. "Котангл" способен самостоятельно исследовать метаданные модели, группировать элементы по определенным свойствам (например, по ширине и высоте сечения) и выводить результаты в виде интерактивной таблицы, из которой можно выделить нужные элементы на 3D-сцене. Кроме того, он способен находить элементы по логическим условиям, например, с минимальной длиной, и изолировать их в модели для детального рассмотрения.
Пример:
- Пользователь отправляет команду: "Сгруппируй все воздуховоды по ширине и высоте сечения".
- ИИ начинает поиск нужных параметров. Сначала он запрашивает свойства модели, пытаясь найти, как называются категории и параметры ширины и высоты. Затем он ищет элементы в категории Воздуховоды, но обнаруживает, что они пустые, и уточняет у пользователя, не нужно ли искать в других смежных категориях (например, Арматура воздуховодов, Соединительные детали воздуховодов).
- Пользователь уточняет, что его интересует "Только категория воздуховоды".
- ИИ-ассистент находит нужные данные по физически заполненным полям и выводит результат в виде интерактивной таблицы. В таблице указаны ширина, высота и количество воздуховодов с такими параметрами.
- Пользователь выбирает одну из строк в таблице (например, воздуховоды 250х250 мм, 334 штуки), нажимает кнопку выделения, а затем просит "Котангла": «Изолируй в модели воздуховоды шириной 300 мм».
- ИИ-ассистент выполняет команду и оставляет на 3D-сцене только 119 воздуховодов с шириной 300 мм.
- Пользователь отправляет новый запрос: "Найди воздуховод с самой маленькой длиной и сфокусируйся на нём".
- "Котангл" находит элемент с минимальной длиной (18 мм), выводит его ID и параметры, а затем изолирует и приближает его на 3D-сцене.
- Пользователь просит "Снова включи видимость всех элементов", и ИИ-ассистент возвращает отображение всей модели целиком.

Работа с ВОР
ИИ-ассистент способен рассчитывать объемные показатели выборки элементов без использования предварительно настроенных классификаторов. Система умеет самостоятельно классифицировать элементы на основе свойств BIM-модели, уточнять у пользователя критерии фильтрации через диалог, формировать результаты в виде интерактивных таблиц и выполнять дополнительные математические расчеты с полученными объемами.
Пример:
- Пользователь отправляет в чат запрос: "Рассчитай ведомость объемов работ по отделке".
- ИИ-ассистент задает уточняющие вопросы для конкретизации задачи. Сначала пользователь подтверждает расчет по открытой на экране 3D-модели. Затем ИИ самостоятельно исследует свойства модели и просит уточнить состав отделки. Пользователь выбирает вариант, включающий расчет отделки стен, полов и потолков. ИИ-ассистент выполняет запросы к базе данных, классифицирует элементы и генерирует интерактивную таблицу. В таблице отображаются разделы (например, перекрытия и стены), материалы и итоговая площадь в квадратных метрах. Пользователь просматривает таблицу, выделяет отдельные строки (что позволяет визуализировать их в 3D) и задает дополнительный аналитический вопрос: "Какого материала больше: ламината или плитки?".
- ИИ-ассистент анализирует ранее полученные данные и дает точный ответ на основе вычисленных объемов, сообщая, что ламината больше (643,514 м²), чем плитки (587,871 м²)

Работа с ВОРМ
ИИ-ассистент способен рассчитывать суммарный объем выборки элементов по заданным текстовым критериям и формировать результаты в виде структурированной таблицы. При получении комплексного или неоднозначного запроса он задает встречные уточняющие вопросы, чтобы корректно определить границы анализируемых данных. Полученную в чате интерактивную таблицу можно легко скопировать и перенести для дальнейшей работы во внешние табличные редакторы.
Пример:
- Пользователь отправляет в чат подробный запрос: "Рассчитай ведомость материалов по разделу архитектурные решения. Единицу измерения прими подходящую к данному материалу. Ответ в виде таблицы, сгруппированной по виду материала".
- ИИ-ассистент анализирует модель и сообщает, что ему требуется конкретизация того, что именно считать "архитектурными решениями". Ассистент предлагает несколько логических путей: отфильтровать элементы по префиксу уровней, по категориям/классам или по специальному признаку раздела "АР" в свойствах материалов.
- ИИ-ассистент автономно анализирует метаданные модели и находит материалы, которые обычно относятся к архитектурным решениям, исключая элементы несущих конструкций и инженерных сетей.
- ИИ-ассистент выводит в чат итоговую таблицу, где материалы (например, пластик, ламинат, кирпич, стяжка) сгруппированы, а для каждого вида подобрана своя единица измерения (квадратные или кубические метры, штуки) и рассчитано точное количество.
- Пользователь успешно переносит в таблицу Excel данные из чата с сохранением структуры колонок: "Вид материала", "Ед. изм." и "Количество".

Техническая поддержка
ИИ-ассистент берет на себя роль умной технической поддержки первой линии. Опираясь на базу знаний справочного центра Tangl, он подробно объясняет назначение и логику работы любых функций платформы. Бот может проконсультировать, для чего нужны основные разделы системы и как правильно применять конкретные инструменты. Ответы ИИ-ассистента сопровождаются ссылкой на конкретную статью из базы знаний платформы.
