ТРЭК
MCP-доступ ТРЭК

ИИ-агент работает с вашими проектами в Вебстер и Авеню

Получает данные модели УДС, выполняет нормативные расчёты и микромоделирование на сервере и вносит изменения в программы регулирования в рамках ваших прав, параллельно с вами.

Что такое MCP-доступ

MCP (Model Context Protocol) — открытый протокол подключения ИИ-агентов к внешним системам. Через MCP-доступ ТРЭК агент получает доступ к проекту и работает с ним как второй оператор: вы продолжаете работу в модуле, а агент формирует перечень перекрёстков, рассчитывает задержку и уровень обслуживания, подбирает схемы пофазного разъезда, выполняет микромоделирование и сохраняет программы регулирования.

Агенту открыты расчётные ядра модулей, те же, на которых работает интерфейс; вычисления выполняются на сервере. Поэтому агент возвращает результат нормативного расчёта, а не пересказ данных проекта. Собственных методик у MCP-доступа нет: это программный слой над ТРЭК.Вебстер (расчёт светофорного объекта) и ТРЭК.Авеню (координированное управление на сети).

Зачем это вам

Типовые операции выполняет агент. Расчёт и сохранение программ по десяткам перекрёстков проекта агент проводит сам; за вами остаются проверка результата и проектные решения.

Без ручного переноса данных. Программа регулирования формируется непосредственно из результата расчёта, отчёт собирается по его данным. Переписывать значения не требуется.

Результаты проверяемы. Агент выполняет тот же нормативный расчёт, что и модуль, и указывает метод и нормативный документ. Любое значение можно перепроверить в модуле.

Отраслевая терминология и привязка к модели УДС. Перекрёстки агент называет по пересекающимся улицам из модели сети, термины берёт из глоссария системы, различает модельную и контроллерную нумерацию сигнальных групп.

Куда уходит время в проекте

Расчёт одного перекрёстка в ТРЭК.Вебстер занимает минуты. В проекте ПОДД регулируемых перекрёстков бывает несколько десятков, и основное время уходит на повторяющиеся действия: открыть перекрёсток, проверить интенсивности движения, пересчитать, сохранить, перейти к следующему. Отдельно тратится время на перенос данных: действующая программа переносится из контроллера в проект, рассчитанная вносится обратно. Отчёты по перекрёсткам для приложения к проекту оформляются вручную.

ИИ-ассистент общего назначения здесь мало полезен. Формулу Вебстера он знает, но модели вашей сети не видит и рассчитать ваш перекрёсток не может, поэтому его ответ нечем проверить. MCP-доступ даёт агенту проект, нормативный расчёт и сведения о том, по какому документу определяется каждая величина.

Подключение

  1. Выпуск ключа. Ключ вы выпускаете сами и присваиваете ему понятное имя, например «Ноутбук, Claude Desktop». Выпуск подтверждается повторной аутентификацией.
  2. Конфигурация агента. Вместе с ключом формируется готовая конфигурация под выбранного агента. В неё включаются только нужные модули: чем короче перечень операций, тем точнее агент выбирает нужную.
  3. Проверка связи. После перезапуска агента достаточно запросить перечень проектов в Вебстере и Авеню.

Конфигурацию можно передать самому агенту с просьбой подключить MCP-сервер, и он выполнит подключение сам. Установка ПО не требуется: сервер удалённый.

Возможности агента

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

Чтение данных проекта. Эти операции проект не изменяют.

  • перечень проектов с поиском по наименованию, коридоры координации и их состав;
  • все перекрёстки проекта одним запросом, с названиями улиц на подходах и отметкой о настройке. Перекрёсток идентифицируется по пересекающимся улицам, без внешнего геокодирования;
  • программы регулирования перекрёстка: фазы, последовательность фаз, цикл, сигнальные группы с модельной и контроллерной нумерацией;
  • интенсивности движения по направлениям с проверкой их согласованности, маршрутное распределение спроса по видам транспорта;
  • полная модель УДС и сохранённое состояние проекта: агент с локальной средой исполнения (например, Claude Code или Codex) анализирует их по нужному перекрёстку.

Расчёты. Выполняются теми же расчётными ядрами, что и в модулях.

Модуль Расчёт Результат
Вебстер Показатели по HCM средняя задержка, степень насыщения (V/C), уровень обслуживания (LOS), длина очереди по стоп-линиям; сводка по перекрёстку
Вебстер Цикл по Вебстеру потерянное время, оптимальная длительность цикла, распределение основных тактов по фазам
Вебстер Варианты схем пофазного разъезда схемы с оценкой: цикл, задержка, LOS, V/C
Вебстер Рекомендуемая программа программа регулирования под текущие интенсивности по выбранному критерию: минимум задержки или максимум пропускной способности
Вебстер Микромоделирование моделирование по сохранённой программе и интенсивностям, в том числе для программ с вызывными фазами от детекторов; показатели по стоп-линиям и состав потока по типам ТС
Вебстер Пакетная оценка несколько перекрёстков проекта одним запросом, результаты в сопоставимом виде
Вебстер Диаграмма сигнальных групп данные для построения диаграммы в отчёте
Авеню Коридоры координации предложение коридоров по геометрии и связности УДС
Авеню «Зелёная волна» общий цикл и сдвиги фаз по критерию ширины ленты
Авеню Модель движения в коридоре легковые автомобили, автобусы и трамваи в обоих направлениях; скорость сообщения по маршруту и прогрессия по перегонам
Авеню Оптимизация сдвигов подбор сдвигов фаз по критерию суммарной задержки

Аналитический расчёт выполняется и на подставленных интенсивностях, без сохранения в проект. Микромоделирование воспроизводимо: при тех же исходных данных результат повторяется, поэтому эффект изменения программы оценивается повторным расчётом.

Изменение проекта. Требуется роль «редактор» или «администратор».

  • копирование, переименование, удаление проекта, передача его другому владельцу;
  • создание, изменение и удаление программ регулирования, в том числе из выбранной схемы пофазного разъезда или рекомендуемой программы; последовательность фаз с промежуточными тактами модуль формирует автоматически;
  • запись интенсивностей, настройка маршрутного распределения спроса, сохранение результатов расчёта в проект;
  • в Авеню: перенос программы из Вебстера в перекрёсток коридора, запись коридора и сдвигов фаз;
  • выгрузка программ перекрёстка в файл обмена и загрузка обратно. При загрузке модуль сверяет сигнальные группы и стоп-линии с моделью УДС и сообщает о расхождениях.

Порядок работы и справочные материалы

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

Справочник Содержание
Глоссарий светофорного регулирования термины в принятом в системе значении: программа, фаза, промежуточный такт, кольцо стадий, цикл, LOS, коридор, сдвиг, лента «зелёной волны»
Нормативная база расчётов по какому документу определяется величина (ОДМ 218.6.003-2011, HCM, формула Вебстера, ГОСТ для проверок безопасности) и границы уровней обслуживания. Документы вне этого перечня агент не приводит
Работа с моделью структура файлов модели УДС и состояния проекта, порядок их анализа по перекрёстку
Перечень операций все операции модуля с методом и назначением

Типовые сценарии запускаются одной командой и проходят весь путь от поиска проекта до вывода.

Сценарий Действия агента
Оценка перекрёстка рассчитывает программу, выделяет проблемные подходы и предлагает изменения
Отчёт по перекрёстку формирует HTML-документ для приложения к проекту со ссылками на нормативную базу
Подбор схемы пофазного разъезда представляет варианты с оценкой, выбранный сохраняет только после вашего подтверждения
Пересчёт цикла под интенсивности сравнивает действующий цикл с оптимальным; при несогласованных интенсивностях останавливается и сообщает об этом
Сравнение двух программ сводит показатели в одну таблицу и предупреждает, если программы рассчитаны на разные периоды суток
Оптимизация коридора рассчитывает исходное состояние, оптимизирует по ширине ленты или по задержке, показывает результат до и после

В клиентах с поддержкой сценариев MCP (Claude Code, Claude Desktop, Cursor) они вызываются как команды; в остальных ту же задачу достаточно сформулировать текстовым запросом.

Вы и агент в одном проекте

Изменения, внесённые агентом, сразу отображаются у вас в модуле: вы видите, что сделано, и можете вмешаться. Параллельную работу обеспечивают несколько правил.

  • Расчёт без записи. Результат сохраняется в проект только по явному поручению.
  • Предварительный просмотр. Основные операции записи возвращают результат без сохранения, и регламент требует от агента показать его вам до записи.
  • Контроль версии. Изменение передаётся с версией проекта, на которой оно подготовлено. Если проект за это время изменился, запись отклоняется и агент перечитывает данные.
  • Независимость правок. Изменения по разным перекрёсткам и коридорам не влияют друг на друга.
  • Контроль целостности. Запросы с несуществующими маршрутами или фазами отклоняются с пояснением причины, данные проекта не повреждаются.

Права агента совпадают с вашими

Агент действует от вашего имени и располагает вашими правами: видит те же проекты, а изменения вносит, если у вас роль «редактор» или «администратор». При недостаточных правах модуль отклоняет операцию, и агент сообщает об этом. Отдельная настройка прав для агентов не требуется.

Что вы получаете

  • результаты расчётов с указанием метода и нормативного документа;
  • программы регулирования, сохранённые непосредственно из результата расчёта;
  • отчёт по перекрёстку в виде HTML-документа: сводка по программе, таблица показателей по стоп-линиям, диаграмма сигнальных групп;
  • полное формальное описание программы: сигнальные группы с модельной и контроллерной нумерацией, промежуточные такты, фазы, длительности; файлы обмена в нейтральном формате.

Для кого

  • Проектировщик ПОДД и КСОДД. Расчёт и оформление программ по десяткам регулируемых перекрёстков проекта.
  • Инженер, который уже работает с ИИ-агентом. Нормативные расчёты по вашей модели УДС вместо ответов общего назначения.
  • Интегратор или разработчик ИТС и АСУДД. Расчётный слой ТРЭК в составе вашего агента.
  • Инженер ЦОДД или эксплуатирующей организации. Оценка многих перекрёстков по единой методике.

Интеграция с контроллерами и ИТС

Для обмена с внешними системами в ТРЭК предусмотрены нейтральный формат сигнального плана, контроллерная нумерация сигнальных групп и файлы обмена. Расчёт даёт полное формальное описание программы, и перенос в дорожный контроллер становится задачей интеграции.

Её может выполнить и сам агент, если передать ему описание протокола обмена вашего контроллера или АСУДД. Тогда он считывает действующую программу, воспроизводит её в проекте и передаёт рассчитанную обратно в требуемом формате.

Техническая сторона

Параметр Значение
Протокол MCP, удалённый сервер, транспорт Streamable HTTP
Агенты с готовой конфигурацией Claude Desktop, Claude Code, Cursor, Codex, ChatGPT (как коннектор), DeepSeek (через MCP-совместимый клиент)
Точки подключения отдельная для каждого модуля и общая для сквозных сценариев
Перечень операций формируется из описания OpenAPI модулей; дополнительно доступен прямой вызов любой операции модуля с теми же правами
Ключ доступа личный, вы выпускаете его сами, один на все подключённые модули; отображается однократно, хранится только его хеш; отзыв действует немедленно; фиксируется время последнего использования
Аутентификация ключ при вызове обменивается на служебный токен, до модулей исходный ключ не передаётся

Попробовать

Для начала достаточно выпустить ключ в ТРЭК.Вебстер или ТРЭК.Авеню, подключить агента и запросить у него перечень своих проектов. Первые эксперименты удобнее вести на копии проекта: агент создаст её по вашему поручению.