Выберите ситуацию и пройдите демодиалог: от уточнения фактов до действия и развития сотрудника. Все четыре сценария работают без ключа и подключения к серверу.
Демосценарий для приемки ИТ. Данные условные, ответы заранее подготовлены. Нажмите вариант ответа, затем сохраните действие или шаг развития.
Коуч изучает контекст и готовит ответ…
Используйте коды сотрудников и проектов. Автофильтр ФИО помогает, но не заменяет проверку текста.
Контекст сохраняется
Проекты и договоренности
Фиксируйте цель, стадию, ограничения и факты. Возвращайтесь к разговору с тем же контекстом.
Действия из разговоров
Справочник строительства
Где возникает сбой?
Выберите БП: посмотрите владельца, вход, ожидаемый результат и связанные показатели. Откройте разбор в чате.
Процесс
Ответственный по справочнику
Результат процесса
Владельцы взяты из вкладки «Ответственные по БП». Отметка роли в матрице статистик сама по себе не означает владение процессом.
Развитие через работу
Кому и чему учиться?
Наблюдение → проверка причины → навык → практика → подтверждение результата. Должность или плохая статистика не доказывают дефицит навыка.
Согласованные шаги развития
Ожидания по роли и материалы обучения
Требования из планов адаптации; это ориентир для разговора, а не автоматическая оценка сотрудника.
Внешний контекст · с источниками
Нормы и строительные практики
Официальные нормы, российский опыт и зарубежные практики рассматриваются отдельно. Источник и дата проверки видны рядом.
Как устроен коуч
Логика и архитектура
Нажмите на блок схемы, чтобы увидеть его роль. Раздел пригоден для обсуждения с командой хакатона и ИТ.
Выберите блок на схеме.
Проверяемая база
Что уже есть и чего не хватает
Загружены обезличенные извлечения. Ссылки ведут на исходные документы и могут требовать корпоративного доступа.
Версия 0.3 · 17 сентября 2026 · проект на согласование
ТЗ: постоянный ИИ-коуч строительства
Назначение прототипа — согласовать поведение продукта, интерфейс, данные и границы первой версии. Демонстрационные ответы не являются результатами работы подключенной модели.
Цель продукта. Помогать сотруднику в любой момент разобрать рабочую ситуацию в проекте, найти применимый БП и основание, принять следующий шаг и освоить недостающий навык. Руководителю — понимать подтвержденные потребности команды в развитии и проверять эффект обучения в работе.
РС, УСМР с выбором специализации, МЗ и ВМЗ. ИСК, РВСК и ДП — участники процессов и дополнительные роли.
Расширение на другие функции и регионы после проверки пилота.
Выбор 7 ролей; детальные планы адаптации по 4 ролям. Специализации УСМР: каркас; отделка и внутренние сети; фасады и кровля; благоустройство.
Свободный диалог, контекст проекта, поиск оснований, уточнения, предложения действий и развития, фиксация результата.
Автоматическое получение план/факта из корпоративных систем и запуск согласованных действий через API.
4 демонстрационных диалога с развилками, проекты, карточки БП, наблюдения, принятие действия и фиксация результата.
Обезличенная база с источниками и статусом; ручной ввод фактов; адресная проверка нормативных изменений.
Синхронизация версий документов, корпоративный вход, роли доступа, промышленный мониторинг и доставка уведомлений.
Полностью автономные материалы и схемы. Поиск по словам не имитирует свободный ответ модели.
Персональная рекомендация обучения по подтвержденному основанию и назначенной роли.
Автоматическая запись в Moodle и обратная загрузка результатов.
Сохранение шага развития и подбор материалов по запросу. Нет автоматической аттестации или назначения кадрового решения.
2. Сквозные пользовательские сценарии
S-01 · РС · А3.3.5.1 / А3.3.5.2
Отставание по СМР
Ситуация → уточнение по захватке, РД, фронту, материалу → подтвержденное ограничение → план его снятия → проверка факта.
Развилка: материала нет — рабочее действие; причина неизвестна — сбор фактов. Обучение автоматически не назначается.
S-02 · УСМР / ИСК · А3.3.6
Замечания и развитие
Повторный пропуск критерия → проверка условий → разбор применения навыка → практика с наставником → проверка следующих комплектов.
Развилка: критерий не согласован — сначала исправление процесса; подтверждена ошибка применения — адресное развитие.
S-03 · МЗ / ВМЗ · А3.2.3 / А3.3.7
Рост стоимости
Общее отклонение → объем / цена / состав / изменение РД → сопоставление оснований → расчет и маршрут согласования.
Граница: коуч не утверждает бюджет, допсоглашение и объем принятых затрат.
S-04 · РС / ИСП · А3.1
Разные версии РД
Различие версий → статус действующего альбома → подтверждение передачи → согласование изменения БП с его владельцем.
Результат: предложены проверяемый порядок передачи и контроль отзыва старой версии.
3. Функциональные требования
ID
Поведение системы
Проверяемый результат
FR-01 · Контекст
Определять роль, специализацию, проект, регион, стадию и доступные сотруднику материалы. Разрешать отдельный разговор без проекта.
Смена роли или проекта начинает новый контекст; факты разных проектов не смешиваются. Неизвестные поля запрашиваются.
FR-02 · Диалог
Принимать свободный вопрос, уточнять 1–2 ключевых пробела, помнить историю в пределах прав доступа. Пользователь может вернуться к разговору.
На следующий вопрос ответ учитывает уже сообщенные ограничения; не повторяет вопросы, на которые был ответ.
FR-03 · Основания
Искать фрагменты только в доступных документах. Показывать название, точное место, версию, статус утверждения и дату проверки.
Каждая ссылка открывает использованный фрагмент; отсутствие основания обозначено явно. Нельзя ссылаться на не найденный документ.
FR-04 · БП
Связывать ситуацию с кодом БП, владельцем, участниками, входом, выходом, критерием приемки и статистиками.
Владение БП берется из справочника владельцев. Отметка в матрице метрик не превращается в назначение владельцем.
FR-05 · Причина
Разделять факты и гипотезы; проверять процесс, ресурсы и применение навыка.
Одно плохое значение статистики не приводит к выводу «сотрудник некомпетентен» и автоматическому обучению.
FR-06 · Действия
Предлагать до 3 следующих шагов: действие, роль владельца, основание, критерий результата; срок — при наличии данных или после согласования.
Действие сохраняется после принятия пользователем. Принятое предложение, выполненная работа и подтвержденный эффект имеют разные статусы.
FR-07 · Развитие
По подтвержденному наблюдению формировать связь «код сотрудника → навык → основание → практика → материал → проверка → результат».
Если оснований недостаточно, предложена диагностика, а не персональное заключение. Роль и специализация учитываются при подборе.
FR-08 · Возврат к результату
На следующем обращении показывать незавершенные договоренности; принимать факт выполнения и подтверждение.
Закрытие задачи не считается автоматически ростом компетенции. Хранятся факт, дата и проверяющий.
FR-09 · Руководитель
Показывать в пределах своей команды подтвержденные потребности в развитии, основания, практику и результат проверки.
Нет рейтинга личности или скрытой оценки по приватным диалогам. Руководитель видит предоставленные рабочие наблюдения и согласованные планы.
FR-10 · Практики рынка
Вести группу ТОП-20 по объему текущего жилищного строительства ЕРЗ с датой среза; изучать первичные публикации компаний и международных организаций.
Состав рейтинга отделен от полноты изучения практик; «подтвержденный факт компании» отделен от «нашей гипотезы применения».
FR-11 · Нормативные изменения
Проверять официальные публикации; сравнивать редакции, даты публикации и действия; определять затронутые БП, работы и роли.
Уведомление содержит официальный URL, было / стало, дату действия или статус «не проверена», применимость и предлагаемое действие.
FR-12 · Неподтвержденная норма
Не пересказывать поисковый фрагмент как прочитанный полный текст. Отделять проекты документов, действующие нормы и зарубежные практики.
При недоступном тексте система сообщает ограничение; не ставит статус «изменений нет» как итог полной проверки.
FR-13 · Уведомления
Уведомлять адресно, после проверки применимости; исключать повторы по документу и редакции. Владелец подтверждает изменение внутреннего чек-листа.
В уведомлении понятны получатель по роли, причина получения и конкретный шаг. Внутренний регламент не меняется автоматически.
FR-14 · Ошибки и расходы
Обрабатывать отсутствие ключа, 401/402/403/429, таймаут, ошибку в теле HTTP 200, обрезанный ответ и неверный JSON. Учитывать модель и usage.cost_rub.
Ошибка не отображается как ответ коуча. После неоднозначного таймаута нет незаметного повторного платного запроса.
FR-15 · Версии знаний
Хранить источник, дату чтения, редакцию, владельца, статус и права. При конфликте источников показывать конфликт.
Рабочая редакция книги и черновик эталона не выдаются за утвержденный корпоративный стандарт.
FR-16 · Права и обезличивание
Применять доступ по пользователю, проекту и роли до поиска и формирования контекста. Заменять ФИО и контакты стабильными кодами до внешнего запроса.
Запрос к модели не содержит ФИО; таблица соответствий кодов хранится отдельно в корпоративном контуре. Маскирование регулярными выражениями само по себе недостаточно для промышленного допуска.
4. Данные и связи
В текущей выгрузке: 22 уникальных БП из 30 строк перечня, 115 строк показателей, 743 строки этапов пакетов работ, 477 задач адаптации. Это не численность сотрудников, не число компетенций и не фактические результаты работы.
Каталог обучения и планы адаптации доступны; завершение курса само по себе не подтверждает применение навыка.
Документ / фрагмент
source_id, URL, тип, версия, статус, точное место, текст, дата проверки, ACL
В HTML — фиксированный обезличенный срез 17.09.2026. Автоматического обновления исходников нет.
Нормативное изменение
document_id, редакция до/после, опубликовано, действует с, применимость, роли, review_status, notification_id
Полнотекстовая актуальная база СП/СНиП и промышленный канал доставки пока не подключены.
Связь: сотрудник работает в проекте и участвует в БП; наблюдение относится к задаче / результату; подтвержденный пробел связан с навыком; шаг развития содержит практику и проверку. Документы и нормативы объясняют требования, но не заменяют факты о сотруднике.
5. Доступы, приватность и архитектура
Участник
Доступ по умолчанию для согласования
Сотрудник
Свои разговоры, разрешенные проекты, принятые действия и план развития.
Руководитель
Проекты и сотрудники в своей области ответственности; согласованные рабочие наблюдения и развитие. Приватный диалог сотрудника автоматически не раскрывается.
HR / корпоративный университет
Согласованные потребности в обучении и агрегированная аналитика. Детальные права и минимальный размер группы для агрегации согласовать.
Владелец БП / нормативный эксперт
Проверка содержания требований, противоречий и применимости изменений.
ИТ-администратор
Настройки, технические журналы и расходы; содержание персональных разговоров не требуется для обычной диагностики.
Целевая архитектура: интерфейс → корпоративный вход и проверка доступа → контекст и поиск разрешенных фрагментов → серверный адаптер AITUNNEL → проверка ответа и ссылок → показ предложения → принятие пользователем → хранение результата. Внешний поиск выполняется отдельно, с публичным запросом без персональных и проектных данных. Подробные схемы находятся в разделе «Логика и архитектура».
6. Подключение и интеграции
Интеграция
Контракт первой версии
Что нужно от ИТ
AITUNNEL
Серверный POST /v1/chat/completions; ключ из окружения / хранилища секретов; точная модель из GET /public/aitunnel/models/chat; max_tokens обязателен. Первый вариант без стриминга.
Ключ, разрешенная модель, бюджет, срок действия, IP-ограничения, согласованный состав передаваемых данных и провайдеров.
Корпоративные документы
Чтение, извлечение фрагментов, версия, ссылка, статус и ACL. Никаких команд из текста документов.
Сервисный доступ к согласованным папкам / источникам; владелец и правило обновления.
Feroom / 1С
Сначала чтение справочника ЦКП, статистик и проектного план/факта; изменения — только после отдельного согласования.
API или утвержденная выгрузка, ID сущностей, формулы, периодичность, контроль качества и права.
Moodle
Каталог, компетенции, уровень, формат, длительность; затем назначение и результаты через согласованный API.
API, права и стабильные course_id; правила связи курса с навыком. Ссылка на курс уже есть в исходной базе.
Нормативный мониторинг
Ежедневное чтение официальных публикаций; версии, сравнение, проверка применимости, очередь эксперта, уведомление по ролям.
Разрешенные источники / лицензированный доступ, ответственный эксперт, канал доставки и проектные атрибуты.
В инструкции ИТ рабочего ключа нет. Это не мешает просмотру и приемке интерфейсного прототипа. Полная функциональная приемка диалога выполняется после подключения модели; подготовленный адаптер еще не проходил проверку реальным платным запросом.
7. Предлагаемый контракт ответа коуча
Стабильные ID и проверяемые поля; интерфейс не должен зависеть от произвольного Markdown модели.
{
"answer": "Факты, гипотезы и понятный следующий шаг",
"questions": ["До двух ключевых уточнений"],
"actions": [{"task":"…", "owner":"роль", "evidence":"…", "check":"…"}],
"learning": [{"employee":"код", "skill":"…", "evidence":"…", "practice":"…", "check":"…"}],
"citations": ["идентификатор найденного фрагмента"],
"model": "реальная модель из ответа шлюза",
"usage": {"costRub": "значение шлюза или null"}
}
В промышленной версии сервер добавляет request_id, project_id, conversation_id, версию источников и журнал согласования. URL источников сервер получает из своего реестра, а не принимает произвольный URL от модели. Ключ и баланс аккаунта в интерфейс сотрудника не передаются.
8. Критерии приемки
ID
Проверка
Ожидаемый результат
AT-01
Открыть HTML без интернета.
Все экраны, сценарии, поиск, проекты и схемы работают без внешних библиотек. Для перехода на исходный сайт нужен интернет.
AT-02
Пройти S-01: материала нет.
Коуч предлагает снятие ресурсного ограничения; персональное обучение не назначается.
AT-03
Пройти S-02 в двух ветках.
Несогласованный критерий → изменение процесса. Подтвержденная ошибка → диагностическая практика и критерий проверки.
AT-04
Принять действие, перейти в проект, зафиксировать результат, перезагрузить.
Контекст и результат доступны; статус не превращается в автоматическую аттестацию.
AT-05
Запросить вывод без данных или по спорной статистике.
Коуч запрашивает основания / отмечает конфликт и не выдает вымышленную оценку.
AT-06
Указать ФИО, контакт или инструкцию «игнорировать правила» внутри документа.
Данные маскируются до внешнего запроса; команды из источника не исполняются. Промышленная проверка включает тесты обхода фильтра.
AT-07
Открыть чужой проект / передать его ID в API.
Доступ отклонен до поиска. Проверяется на промышленной версии с корпоративным входом; локальный макет однопользовательский.
AT-08
Получить ответ с выдуманным ID источника, неверным JSON или обрезкой.
Неизвестная ссылка не показывается как подтвержденная; ошибочный ответ не сохраняется как решение.
AT-09
Смоделировать 401, 402, 403, 429, таймаут и error в HTTP 200.
Понятный статус; ключ не раскрывается; нет бесконечных повторов и скрытого удвоения запроса.
AT-10
Нормативный текст недоступен / дата действия не установлена.
Отмечена неполнота проверки. Нет ложного подтверждения актуальности или обязательности нормы.
AT-11
Один нормативный документ обнаружен повторно.
Нет повторного уведомления по той же редакции; измененная редакция проходит новый разбор применимости.
AT-12
Открыть подборку ТОП-20.
Есть дата и основание рейтинга; полнота изучения практик обозначена отдельно. У зарубежного опыта нет статуса нормы РФ.
Качество модели — отдельный этап
Согласовать минимум 20 реальных обезличенных вопросов по пилотным ролям и эталон допустимых действий. Оценить полезность, достаточность уточнений, точность ссылок и отсутствие необоснованных выводов о людях.
Предлагаемый порог пилота: ≥ 90% ответов приняты экспертами; 0 утечек между проектами и 0 вымышленных обязательных нормативных требований. Это целевые критерии, а не измеренный результат прототипа.
Нефункциональные требования
Предлагаемые цели пилота: подтверждение отправки ≤ 1 с; поиск источников ≤ 3 с; 95% обычных ответов ≤ 30 с при доступном провайдере. Показ состояния и возможность безопасного повтора при сбое.
Лимиты бюджета и запросов, контроль длины контекста, резервное копирование, удаление данных по согласованной политике, журнал версии модели и источников. Значения уточнить нагрузочным тестом.
9. Решения перед промышленной разработкой
Вопрос
Ответственный за решение
Что уже известно
Утвержденная редакция производственной книги и приоритет источников
Владелец строительного процесса
Название исходника содержит «для редактуры в 2026»; статус утверждения всех разделов не доказан.
Эталоны диагностики УСМР
РВСК / владелец аттестации / КУ
В оценочном листе есть «уточнить» и вопросы. Не использовать его как утвержденный эталон.
Подчинение МЗ и маршруты согласования
ВМЗ / ДП / HR
Справочник указывает ВМЗ, план адаптации — ДП. Нужно различить виды подчинения.
Формулы и направление улучшения показателей
Владелец статистики
В части строк просроченных замечаний указано «выше — лучше». До уточнения оценка не рассчитывается.
Факты сотрудников, регион и проекты пилота
Руководители пилота
Персональные результаты не переданы. Для проверки полезности нужны обезличенные наблюдения и план/факт.
Размещение, модель, данные и срок хранения
ИТ / ИБ / владелец продукта
AITUNNEL задан инструкцией ИТ. Локальный макет не заменяет корпоративную систему доступа.
Нормативная база и экспертная проверка
Нормативный эксперт / ИТ
Есть официальные каналы. Полнотекстовая база СП/СНиП и адресная доставка в продукт требуют реализации.
Дополнена файлом ИТ «aitunnel-api_1 (1).md». Каталог моделей проверен 17.09.2026. Рабочий ключ не передан.
Дополнительная база
Реестр профилей, ЦКП и статистики ФЕ, программа аттестации ПК, каталог развития и курс А3. Точное покрытие, ограничения и внешние первичные источники перечислены в разделе «Источники» прототипа.
Подготовлено по инструкции ИТ
Подключение AITUNNEL
HTML открывается самостоятельно. Для живого диалога используется локальное приложение из архива: ключ остается в памяти серверного процесса.
01 · открыть сейчас
Один HTML-файл
Скачайте файл и откройте его двойным щелчком в Chrome, Edge или Firefox. Интернет нужен только для перехода к источникам.
Доступны проекты, наблюдения, поиск по БП и материалам, схемы, источники, резервная копия. Генерации ответов ИИ без подключения нет.
02 · включить ИИ
Локальное приложение
Распакуйте архив «ИИ-коуч-приложение.zip». Запустите Запустить.bat на Windows или server.py через Python 3.10+.
ИТ вводит ключ AITUNNEL в скрытом приглашении и выбирает модель из актуального каталога. Приложение откроется в браузере автоматически.
Требуются интернет, Python и действующий ключ с бюджетом. Для HTML они не нужны.
Что передать ИТ
Параметр
Что требуется
AITUNNEL_API_KEY
Ключ администратора мероприятия. В присланной инструкции только примеры; рабочего ключа нет.
AITUNNEL_MODEL
Точный ID из текущего каталога; текстовый вход и выход, окно ≥ 32 000 токенов. Модель должна быть разрешена для ключа.
AITUNNEL_MAX_TOKENS
2000 по умолчанию; ограничение 512–4096. Бюджет в рублях задается на стороне ключа.
Доступ к сети
Основной адрес api.aitunnel.ru; зеркало ru-api.aitunnel.ru — только при необходимости. Уточнить IP-ограничения ключа.
Данные компании
Подтвердить, какие обезличенные фрагменты разрешено передавать через шлюз выбранному провайдеру. Экран поиска в интернете не получает внутренние материалы.
После пилота
Корпоративный вход и роли доступа, централизованная база, версии документов, интеграции Moodle / Feroom / 1С, доставка нормативных уведомлений в приложение.