ИИ помощник Бобби

Бобби — виртуальный помощник Пересвет. Он отвечает на вопросы о Пересвет-СТ, портале и документации, разбирает ошибки, скриншоты и логи и пишет скрипты для автоматизации. Бобби работает на docs.peresvet.it, на portal.peresvet.it и в Telegram.

Как открыть

1. Нажмите ИИ помощник в верхней панели сайта документации или портала.
2. Войдите учётной записью портала. Если вы уже вошли на портал, чат откроется сразу.
3. Напишите вопрос.

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

Что умеет Бобби

• Отвечает по документации и даёт ссылки на нужные разделы.
• Помогает с порталом: где скачать дистрибутив или обновление, как получить и привязать лицензию, почему недоступна кнопка.
• Подсказывает, как собрать и запустить задачу: какие плагины и параметры выбрать под цель испытания.
• Объясняет метрики, графики и счётчики и помогает найти причину проблемы.
• Разбирает вложения: скриншоты интерфейса и графиков, логи, конфигурации, PDF.
• Пишет скрипты для работы с Пересвет-СТ: автоматизация через REST API, выгрузки из ClickHouse и PostgreSQL, обслуживание серверов и агентов. Готовый скрипт можно скопировать или скачать файлом.
• Помнит сведения о стенде вашей группы: адреса, схемы, договорённости. Напишите «запомни…», и Бобби подскажет эти сведения вам и коллегам из вашей группы. Запись можно попросить исправить или удалить.

Примеры вопросов:

Как запустить HTTP-задачу на двух агентах?
Почему в Dynamic Applications растёт Flows Failed?
Напиши скрипт, который выгружает задачи за последние сутки в CSV.
Запомни: наш стенд — агенты 10.0.0.11 и 10.0.0.12, контроллер 10.0.0.10.

Скопировать в буфер обмена

Как работать с чатом

• Вложения. Нажмите +, перетащите файлы в чат или вставьте их через Ctrl+V (Cmd+V на Mac). К вопросу можно приложить до 10 файлов.
• Ответ печатается по ходу. Чтобы прервать его, нажмите кнопку остановки.
• Под ответом: Скопировать — копирует ответ вместе с разметкой; 👍 и 👎 — оценка ответа. При 👎 можно указать, что было не так: это помогает улучшать помощника.
• Новый разговор — меню ≡ → Создать новый чат. Полезное из прошлого разговора Бобби сохранит в базу знаний группы.
• Если Бобби сейчас не в сети, над полем ввода появится сообщение. В этом случае напишите в поддержку: support@peresvet.it.

Telegram-бот

Бобби доступен в Telegram: @peresvet_bobby_bot. Ему можно писать в личные сообщения или добавить его в рабочую группу. Бот отвечает так же, как в чате на сайте, с учётом базы знаний вашей группы.

Личный чат

1. Откройте @peresvet_bobby_bot и нажмите Запустить.
2. Отправьте /auth и нажмите Подключить через портал.
3. Войдите на портал и нажмите Подключить. Бот сообщит, что чат подключён.
4. Задавайте вопросы обычными сообщениями. Можно прикладывать фото и файлы до 20 МБ.

Групповой чат

1. Добавьте @peresvet_bobby_bot в группу.
2. Администратор группы отправляет /auth и подключает группу через портал. После этого бот отвечает всем участникам группы от имени вашей группы на портале.
3. Задайте вопрос одним из способов:
   • командой /ask <вопрос>;
   • ответом на сообщение бота;
   • упомянув @peresvet_bobby_bot в сообщении.

Бот видит только сообщения, адресованные ему; остальную переписку группы он не читает.

Команды

Команда	Что делает
/auth	Подключить чат к порталу
/ask <вопрос>	Задать вопрос в группе
/new	Начать новый разговор
/help	Показать справку

Ссылка для подключения действует 15 минут и срабатывает один раз. Если подключение отозвано, отправьте /auth ещё раз.

MCP-сервер (beta)

MCP-сервер Пересвет-СТ позволяет подключить к системе ИИ-клиент: например Codex, Claude, локальную LLM-оболочку или другой инструмент, который поддерживает MCP Streamable HTTP. После подключения пользователь может описывать задачу обычным языком, а ИИ-клиент будет получать актуальную схему Пересвет-СТ, читать библиотеку, подбирать рецепты, собирать черновики задач, проверять их и запускать действия через контролируемый workflow.

Endpoint публичного beta-сервера:

https://portal.peresvet.it/mcp

Скопировать в буфер обмена

Доступ закрыт учётной записью портала Пересвет. Используйте тот же e-mail и пароль, с которыми вы входите на portal.peresvet.it.

Beta

MCP-интерфейс находится в beta-режиме. Набор инструментов, названия рецептов и формат диагностических ответов могут меняться.

Зачем это нужно

MCP-сервер нужен, чтобы ИИ-клиент работал не по памяти и не по устному описанию интерфейса, а по фактической схеме системы.

Он помогает:

• понять, какие агенты, сети, сертификаты, словари, PCAP, CVE и пользовательские файлы доступны в библиотеке;
• подобрать подходящий сценарий под цель тестирования: NGFW, WAF, Anti-DDoS, TLS/IPsec, PCAP Replay, Dynamic Applications, control plane или access-сценарии;
• сформировать черновик задачи с правильными полями и ссылками на объекты библиотеки;
• проверить задачу до сохранения и получить понятные подсказки, если не хватает сети, файла, сертификата или параметра;
• создать задачу, запустить её, остановить или выполнить действие внутри задачи только после явного подтверждения;
• получить отчёт, сводку метрик, события control plane и результат анализа выполнения.

Что умеет MCP-сервер

Доступные возможности сгруппированы вокруг безопасного workflow.

Группа	Что делает
Схема и плагины	Показывает актуальные поля, доступные плагины, структуру задачи и правила control/access plane
Рецепты	Подсказывает готовые workflow для типовых задач и объясняет, какие вопросы нужно уточнить
Библиотека	Показывает метаданные объектов: сети, агенты, сертификаты, словари, файлы, PCAP, CVE и другие коллекции
Черновики	Собирает черновик задачи, валидирует его и объясняет ошибки до создания
Задачи	Создаёт, запускает и останавливает задачи через двухшаговое подтверждение
Действия	Выполняет runtime-действия: например access flap или flap/schedule для протоколов control plane
Анализ	Возвращает отчёт по задаче, сводку метрик, convergence report и события control plane

Операции, которые меняют состояние системы, разделены на два шага:

1. prepare_* — проверяет действие и возвращает короткоживущий approval token.
2. confirm_* — выполняет действие только с этим token.

Такой порядок нужен, чтобы ИИ-клиент сначала показал пользователю, что именно будет сделано, а затем выполнил действие после подтверждения.

Примечание

Остановка задачи не удаляет её. Задача остаётся в истории и доступна для просмотра результатов, отчётов и повторного анализа.

Подключение

Подключение можно поручить ИИ-агенту

Вы можете передать эту страницу вашему ИИ-агенту вместе с данными авторизации от портала. Если агент умеет изменять собственную конфигурацию MCP-клиентов, он сможет сам добавить endpoint https://portal.peresvet.it/mcp, настроить авторизацию и проверить подключение. Подключать MCP вручную с нуля необязательно.

Подключите MCP-сервер как HTTP MCP endpoint:

https://portal.peresvet.it/mcp

Скопировать в буфер обмена

Способ задания авторизации зависит от клиента.

Клиент поддерживает Basic Auth

Укажите:

Username: <ваш e-mail на портале>
Password: <ваш пароль на портале>

Скопировать в буфер обмена

Клиент поддерживает только HTTP headers

Сформируйте Basic Auth header:

printf '%s' '<email>:<password>' | base64

Скопировать в буфер обмена

Затем добавьте header:

Authorization: Basic <base64(email:password)>

Скопировать в буфер обмена

Пример для Codex

В ~/.codex/config.toml:

[mcp_servers.peresvet-st]
url = "https://portal.peresvet.it/mcp"
http_headers = { Authorization = "Basic <base64(email:password)>" }

Скопировать в буфер обмена

После изменения конфигурации перезапустите Codex, чтобы native MCP tools появились в новой сессии.

Проверка доступа

Проверить доступ можно через JSON-RPC initialize:

curl -u '<email>:<password>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {
        "name": "peresvet-smoke",
        "version": "1.0.0"
      }
    }
  }' \
  https://portal.peresvet.it/mcp

Скопировать в буфер обмена

Успешный ответ содержит serverInfo.name со значением controller-agent-gateway.

Если логин или пароль неверные, сервер вернёт:

HTTP/2 401
Unauthorized

Скопировать в буфер обмена

Типовой workflow

Рекомендуемый порядок работы:

1. Опишите цель тестирования обычным языком.
2. Попросите ИИ-клиент посмотреть схему, рецепты и библиотеку.
3. Уточните недостающие параметры: агенты, сети, длительность, интенсивность, файлы, сертификаты, профили TLS/IPsec.
4. Сформируйте черновик задачи.
5. Проверьте черновик через валидацию.
6. Создайте задачу через prepare_task_create и confirm_task_create.
7. Запустите задачу через prepare_task_start и confirm_task_start.
8. После выполнения запросите отчёт или анализ результата.

Пример пользовательского запроса:

Хочу протестировать NGFW. Подбери HTTP/TLS-сценарий на двух агентах,
проверь доступные сети и сертификаты, создай черновик задачи на 5 минут
и покажи, что нужно подтвердить перед запуском.

Скопировать в буфер обмена

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

Примеры запросов

Посмотреть доступные объекты

Покажи, какие агенты, сети, сертификаты и PCAP-файлы доступны в библиотеке.

Скопировать в буфер обмена

Создать задачу по описанию

Нужно проверить WAF: HTTP/1.1, 1000 RPS, 10 минут, клиент и сервер на разных агентах.
Подбери подходящий рецепт, создай черновик и проверь его.

Скопировать в буфер обмена

Проверить PCAP Replay

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

Скопировать в буфер обмена

Проанализировать результат

Проанализируй задачу 1234: статус, ошибки, ключевые метрики,
события control plane и ссылку на результат в интерфейсе.

Скопировать в буфер обмена

Проверить сходимость

Для запущенной задачи подготовь BGP flap, выполни его после подтверждения
и затем покажи convergence report.

Скопировать в буфер обмена

Безопасность и ограничения

• Используйте индивидуальные учётные записи портала. Не передавайте пароль администратора в shared-конфиги и публичные демонстрационные среды.
• Если ИИ-клиент работает в облаке, учитывайте политику вашей организации: текст запросов и ответы инструментов могут обрабатываться внешним сервисом.
• MCP-сервер возвращает метаданные библиотеки, но не должен раскрывать приватные ключи сертификатов.
• Загрузка файлов через MCP рассчитана на небольшие файлы и ограничена размером до 8 MiB decoded content.
• Перед запуском задач с высокой интенсивностью проверяйте сети, диапазоны портов, количество сессий и доступные ресурсы агентов.

Закрытый контур

Для on-prem стендов без доступа в интернет MCP-сервер размещается внутри инфраструктуры заказчика. Пока функционал находится в beta-режиме, схему такого размещения подбирает инженер, курирующий вашу интеграцию. Если вам нужен собственный MCP-сервер в закрытом контуре, обратитесь к нему за настройкой.

Частые проблемы

Симптом	Что проверить
401 Unauthorized	Логин/пароль портала, корректность Authorization header, отсутствие лишних пробелов в base64
MCP tools не появились в клиенте	Перезапустите MCP-клиент после изменения конфигурации
Клиент не умеет Basic Auth	Используйте Authorization: Basic <base64(email:password)>, если клиент поддерживает HTTP headers
Клиент видит endpoint, но не может вызвать tools	Проверьте, что клиент поддерживает Streamable HTTP MCP, а не только stdio MCP
Задача не создаётся	Попросите ИИ-клиент выполнить валидацию черновика и объяснить недостающие поля
Нужен закрытый контур	Обратитесь к инженеру, курирующему вашу интеграцию: в beta-режиме локальное размещение MCP-сервера настраивается индивидуально