Помощник ИИ, ИИ-кнопки и MCP-сервер

Кратко. Модель Claude в ТГИД не считает режим сама. Числа дают расчётный движок и инструменты ТГИД, а модель выбирает, какие инструменты вызвать, и объясняет результат. Есть помощник-собеседник, который ищет, трассирует, локализует аварии, сравнивает сценарии и показывает найденное на карте. Есть ИИ-кнопки в окнах: разбор протокола, поиск фразой, выборка по вопросу, колонки импорта, качество данных, точка подключения ТУ, похожие аварии, записка к плану ремонтов. Внешние ИИ-клиенты подключаются через MCP-сервер с теми же инструментами и вашими правами.

Зачем это

Не каждый пользователь знает, в каком окне и какими условиями найти «бесканальные трубы Ду 400 старше 1985 года в 500 м от камеры». Помощник переводит вопрос в действия программы и показывает ход работы: видно, каким инструментом и с какими параметрами получено каждое число. Ответ модели — подсказка: решение и правку данных делает человек.

Как устроен помощник

flowchart LR
  A["Вопрос словами"] --> B["Сервер ТГИД"]
  B --> C["Модель Claude: какие инструменты нужны"]
  C --> D["Инструменты ТГИД с правами пользователя"]
  D --> C
  C --> E["Ответ + подсветка на карте"]

Инструменты — те же, что у MCP-сервера: поиск объектов, выборка по условиям, трассировка, локализация аварии, запросы по сети, анализ режима, сводка по теме, износ, похожие аварии, места повторных отказов, качество данных, списки расчётов и сценариев, сравнение сценария с основой, запуск расчёта.

Правила:

• Права — ваши. Нет права — шаг завершается ошибкой «Нет права «…»», модель отвечает по тому, что удалось собрать.
• Исходные данные помощник не меняет. Единственный инструмент с последствиями — запуск гидравлического расчёта: он пишет только результаты и не чаще 5 раз за 10 минут.
• Персональные данные в ответах инструментов закрыты, если у вас нет права pii_view (урок 20). У пользователя с этим правом ПДн уходят в Claude API.
• Беседу сервер не хранит: окно само отправляет прежние пары «вопрос — ответ» (до 20 реплик).
• Пределы: вопрос до 4000 символов, 12 обращений к модели и 300 с на вопрос, 30 вопросов за 10 минут.
• Каждый вопрос — запись «AI» в журнале действий с моделью и токенами, каждый вызов инструмента — своя запись.

Подсветка на карте — это ответы инструментов, а не итог. Если модели нужно было только количество, выборка вернула одну строку, и на карте будет одна линия, хотя в тексте — тысячи.

ИИ-кнопки в окнах

Где	Что делает модель	Что делает код ТГИД
Протокол расчёта	причины ошибок по важности, что исправить, совет к запуску	разбирает протокол, таблица регуляторов
Поиск узлов, «Поиск фразой»	превращает фразу в запрос: узел, участок между узлами, источник, инструмент	выполняет поиск
Выборка по условиям, «Спросите словами»	заполняет строки конструктора	проверяет условия и выполняет выборку
Импорт, «Сопоставить ИИ»	колонка файла → поле базы	проверка (dry-run) и запись
Качество данных, «Объяснить»	причина, последствия для расчёта, порядок исправления	считает проверки
ТУ, «Точка подключения»	выбирает кандидата, пишет объяснение, риски, черновик ТУ	подбирает до 8 узлов с баллом
Нарушения, «Уточнить с ИИ»	пересортировывает похожие аварии по смыслу	находит кандидатов по признакам
Износ, «Записка к плану»	группы «в этот сезон», «в следующий», «наблюдение»	считает износ и приоритет

Точка подключения — пример разделения ролей. Код ищет узлы в радиусе (по умолчанию 300 м) и считает балл:

балл = 100 − min(расстояние, 1000)/20  − 30 (нет расчёта)  − 25 (Hрасп < 15 м)
           − 30 (скорость после подключения > 3,5 м/с)  − 20 (участок уже перегружен)  − 10 (Ду < 100)
доп. расход Gдоп = Q · 1000 / Δt          Δt — перепад в узле, без данных — 60 °C
скорость после v' = v · (|G| + Gдоп) / |G|

Модель выбирает номер из списка кандидатов. Номер вне списка сервер отбрасывает, а имена камеры и источника в черновике подставляет сам. Рекомендация ничего не пишет в журнал ТУ.

MCP-сервер

Внешний ИИ-клиент (Claude Desktop, Claude Code, Cursor, свой агент) подключается к адресу …/mcp с токеном, который пользователь выдаёт себе в личном кабинете (по умолчанию на 30 дней). Клиент получает 19 инструментов, 18 из них только читают. Модель работает на стороне клиента, поэтому помощник на сервере для MCP не нужен. Пределы: 60 вызовов в минуту на пользователя, запуск расчёта — 5 за 10 минут и только с правом «Запуск расчётов».

Как сделать в ТГИД

• Помощник ИИ и обзор всех функций — Функции ИИ.
• Разбор протокола расчёта (ИИ), Поиск фразой (ИИ), Выборка по вопросу (ИИ).
• Сопоставление колонок импорта (ИИ), Объяснение проверок качества (ИИ).
• Рекомендация по техническим условиям (ИИ), Похожие аварии (ИИ), Записка к плану ремонтов (ИИ).
• MCP-сервер для ИИ-клиентов; сквозной ролик — ИИ: помощник, выборка по вопросу, разбор протокола.

Задания

1. Вопрос помощнику

Сформулируйте вопрос, который за один заход даст длину сети открытого фрагмента и число участков Ду 500 и больше. Какие инструменты вызовет помощник и как проверить ответ?

Ответ

«Какая длина сети и сколько участков Ду 500 и больше в открытых фрагментах?» Будут шаги «Запросы по сети» (длина) и «Выборка объектов по условиям» (Ду ≥ 500). Проверка — окно «Выборка по условиям» с тем же условием: «Найдено: N».

2. Балл кандидата

Узел в 140 м, по фрагменту есть расчёт, располагаемый напор 12 м, Ду 150, скорость после подключения 1,9 м/с. Какой балл?

Ответ

100 − 140/20 − 25 = 68: штраф за расстояние 7 и за напор меньше 15 м — 25; по скорости и диаметру штрафов нет.

3. Что нельзя доверять

Помощник написал: «узел 4-12 питается от ТЭЦ-2, напор на вводе 18 м». Как убедиться, что это не выдумка?

Ответ

Посмотреть шаги над ответом: какой инструмент вернул источник (трассировка «к источнику») и какой — напор (анализ режима или карточка по последнему расчёту), с какими параметрами. Если шага с числом нет, число не подтверждено: откройте карточку узла или пьезометр.