FAQ MultiAgent

Чем MultiAgent отличается от Agent?

Pastukhov Agent работает с одним проектом в изолированном контейнере. MultiAgent — центральный пульт над флотом экземпляров Agent на любом количестве серверов: развёртывание, обновление, контроль, аналитика и бэкапы — всё из одного окна. Agent решает задачи, MultiAgent управляет армией агентов.

Какие требования к управляемым серверам?

Linux (Ubuntu/Debian) с SSH-доступом и правами root/sudo. Docker и все зависимости установит сам MultiAgent — одной кнопкой прямо из интерфейса. Ничего ставить вручную не нужно.

Где хранятся данные?

Сам MultiAgent хранит всё в volume /data: базу SQLite (или PostgreSQL, если указан MULTIAGENT_DATABASE), ключи шифрования и лицензию. Данные на управляемых серверах лежат в настраиваемых папках — агенты, данные, проекты и инструменты, по умолчанию под /root.

Как обеспечивается безопасность?

SSH-ключи, пароли агентов и API-ключи шифруются в базе — ключи шифрования хранятся в /data/keys и не покидают сервер. Программный доступ (Agent API) закрыт ключом X-API-Key и работает только если он явно задан переменной окружения MULTIAGENT_API_KEY; вход для человека и программный доступ разделены. Проверка входа пользователей — JWT-токенами сроком 90 дней.

Можно ли управлять уже работающими агентами?

Да. MultiAgent умеет импортировать агентов: он сканирует сервер, находит существующие контейнеры агентов и регистрирует их без пересоздания. Все чаты, проекты и данные остаются на месте.


Нужен ли отдельный домен каждому агенту?

Нет. На каждом сервере MultiAgent ставит свой Nginx-контейнер (agents-nginx), который раздаёт все приложения по подпапкам одного домена: каждый агент, продукт и инструмент получает адрес вида https://ваш-домен/имя/. Домен и SSL-сертификат настраиваются один раз — для подпапок ничего отдельно настраивать не нужно, а в корне / nginx живёт домашняя страница сервера (Heimdall) с карточками приложений. Подробнее — на странице Nginx-роутинг.

Как работает Nginx-роутинг и нужен ли свой сертификат?

Сертификаты трех видов выдаются во вкладке Nginx страницы сервера: самоподписанный (по умолчанию), собственная пара PEM или Let’s Encrypt через ACME — для последнего нужен ваш домен. Без домена достаточно самоподписанного: браузер один раз попросит подтвердить его, дальше соединение шифруется. Если домен есть — удобнее Let’s Encrypt: он выдаётся по webroot-методу через сам nginx и автоматически обновляется при обновлении конфигурации маршрутов.


Что такое свой агент (Own Agent)?

Свой агент — внешний Xedant Agent, которого MultiAgent подключает переменными окружения AGENT_API_URL и AGENT_API_KEY. Его интерфейс встроен в каждую страницу: блок в боковой панели со сводкой чатов, глобальный панель чата, очередь промптов и голосовой ввод. Обратное направление — агент управляет MultiAgent — работает через программный интерфейс по ключу MULTIAGENT_API_KEY. Подробнее — на странице Собственный ассистент.

Что такое Agent API?

Agent API — программный интерфейс /api/agent/* для автоматических клиентов, закрытый ключом X-API-Key (переменная MULTIAGENT_API_KEY хранит его отпечаток SHA-256). Через неё внешний агент управляет серверами, агентами, инструментами и продуктами; запрос GET /api/agent возвращает каталог всех операций с описаниями. Без переменной интерфейс отвечает 503 Agent API is disabled («API выключен»). Подробнее — на странице Agent API.

Что такое домашняя страница сервера (Heimdall)?

Домашняя страница сервера — единая закладка, с которой открываются все приложения сервера. Она устанавливается из вкладки Heimdall страницы сервера и раздаётся в корне / nginx: у каждого сервера может быть своя страница со своим входом, а карточки приложений синхронизируются из базы MultiAgent автоматически. Подробнее — на странице Домашняя страница сервера.

Чем задачи и боты отличаются от прежних триггеров и менеджеров?

Прежние менеджеры и триггеры (cron, вебхуки, email, Telegram) убраны из продукта. Вместо них в чатах агентов живут задачи по расписанию, боты и очередь промптов — а также MCP-серверы и навыки. Это собственные сущности агента: MultiAgent передаёт их, а не переизобретает — диалоги открываются из страницы агента и работают через его же API. Подробнее — на странице Задачи и боты.

Как установить MultiAgent на Windows?

Мастером установки PastukhovMultiAgent-Setup-<версия>.exe: приложение работает локально на http://localhost:3991 с папкой данных %LOCALAPPDATA%\Pastukhov\MultiAgent\data — Docker, WSL и .NET не нужны. Управляемые серверы остаются Linux-машинами, подключаемыми по SSH. Подробнее — на странице Установка на Windows.


Работает ли MultiAgent без интернета?

MultiAgent полностью self-hosted: сервер, база, Git-сервер Forgejo и файлы — всё внутри вашей инфраструктуры. Наружу нужен только доступ к API моделей и, при обновлении, к Docker-реестру.

Почему не open-source?

Я уже пробовал запускать и поддерживать бесплатные продукты — больше 20 лет назад. Это того не стоит — объём поддержки намного выше, при этом нет ресурсов на дальнейшее развитие. Я предпочитаю иметь гораздо меньше пользователей, которые действительно любят продукты и готовы за них платить. Ещё одна важная причина — контроль: я предпочитаю сохранять продукты простыми и минималистичными. С открытым исходным кодом я ожидаю тонны AI-сгенерированных PR с функциями, которые я намеренно избегал из-за их сложности и плохих решений.