Начало работы

Pastukhov MultiAgent — центральный пульт над флотом агентов (экземпляров Pastukhov Agent). Он подключается к любому количеству Linux-серверов по SSH, разворачивает на них агентов и продукты (Research, Analytics, Data, Proxy, сам MultiAgent, а также чатботы, Telegram, Тест-агент, новостной агент, портал-агент и CRM), собирает их чаты и аналитику в одном интерфейсе, а доступ к приложениям раздаёт по своим подпапкам сервера через Nginx-роутинг.

Системные требования: управляемые серверы — Linux (Ubuntu/Debian) с SSH-доступом и правами root/sudo. Docker и всё остальное на серверах MultiAgent устанавливает сам.


Первый вход

MultiAgent открывается по адресу, куда он развёрнут (локально — http://localhost:3990). Логин и пароль не задаются переменными окружения — первый пользователь создаётся кнопкой «Регистрация» на странице входа, последующие аккаунты так же. Аутентификация работает через JWT-токены сроком 90 дней — входить заново придётся редко.

Главный экран

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

Плоской страницы со списком всех агентов нет: агенты видны под строкой своего сервера, а общий список флота даёт «Реестр» в «Менеджменте». За чатами всех агентов удобно следить в «Менеджмент → Чаты».

  • Сервера — подключение и настройка серверов: SSH, установка Docker, папки и базы, Nginx-роутинг и сертификаты, домашняя страница сервера, центральный вход, бэкапы, передача сервера клиенту;
  • Менеджмент — пульт для флота, когда агентов стало много. Внутри десять экранов: «Флоты», «Реестр», «Чаты», «Решения», «Стоимость», «Токены», «Готовность», «Политики» и последним пунктом «Аналитика» — общая статистика по всем агентам. Корневая строка раздела сама открывает экран «Флот». Подробнее — Менеджмент;
  • Активы — папка без собственной страницы: клик по ней раскрывает список, но никуда не уводит. Внутри — «Лицензии», «Модели», «Навыки», «Окружения», «Файлы», «Инструменты» и «Аккаунты».

Из «Активов» удобно раздавать одинаковые настройки всем агентам сразу: «Модели» и «Навыки» — каталоги, из которых конфигурация или набор файлов уходят на выбранных агентов (одноимённая запись агента при этом заменяется), «Окружения» — именованные наборы переменных окружения. «Файлы» — просмотр и правка файлов сервера вместе с терминалом, «Инструменты» — библиотека шаблонов Docker-сервисов, «Аккаунты» — учёт LLM-аккаунтов с квотами и балансами, «Лицензии» — лицензионные ключи агентов.

Если заданы переменные окружения AGENT_API_URL и AGENT_API_KEY, внизу боковой панели появляется блок собственного ассистента (Own Agent): список активных чатов с таймерами и сводкой токенов и стоимости, кнопки «Задачи (N)» — очередь работ с живым счётчиком — и «Чаты». Панель открывается с любой страницы и переключается между чатом и задачами на месте. Подробнее — Собственный ассистент и Задачи.


Типичный путь

  1. Добавьте сервер — имя, хост, SSH-порт, пользователь, пароль или приватный ключ. Там же указывается слаг развёртывания (по умолчанию agents) — короткое имя, которое отделяет это развёртывание от других на той же машине. Если MultiAgent стоит на Windows, вместо SSH выбирается режим «Локальный WSL» — дистрибутив на этом же компьютере, без пароля и ключа. Подробнее — Серверы.
  2. Проверьте подключение — MultiAgent протестирует SSH и покажет статус соединения.
  3. Установите Docker — одной кнопкой, с потоковым выводом в интерфейс.
  4. Добавьте агента — мастер «Новый агент»: выберите тип — автономный агент или продукт (Research, Analytics, Data, Proxy, MultiAgent, чатботы, Telegram, Тест-агент, новостной, портал, CRM); имя, сервер, образ и порт подставятся автоматически. Подробнее — Агенты.
  5. Разверните агента или продукт — MultiAgent сгенерирует compose.yml и поднимет контейнер на сервере. Продукты разворачиваются со связанным агентом: по умолчанию берётся первый отдельный агент сервера, а если его нет — создаётся новый тем же мастером.
  6. Включите маршрут — установите Nginx из вкладки сервера, и агент сразу получит свою подпапку {база}/{слаг}/ на сервере. Подробнее — Маршруты.
  7. Установите домашнюю страницу — MultiAgent соберёт статичную панель карточек в корне сервера: агенты, приложения и инструменты, а кнопка «Вход по QR-коду» в углу откроет вход с телефона. Отдельный контейнер и свой вход не нужны — достаточно Nginx. Подробнее — Домашняя страница сервера.
  8. Включите центральный вход — вкладка «Авторизация» (Authelia) на странице сервера: посетитель входит один раз и получает доступ к любому защищённому приложению сервера. Нужен HTTPS — локальный сертификат на вкладке Nginx или публичный адрес сервера (шаблон адреса вида https://{база}/{слаг} тоже подойдёт). Подробнее — Серверы.
  9. Откройте чаты — все чаты всех агентов появятся в едином списке. Подробнее — Чаты.

Язык интерфейса

Интерфейс полностью переведён на русский. Язык (English/Russian) переключается в настройках профиля и сохраняется для каждого пользователя отдельно.

← Оглавление документации