IMBACLOUD AI Agent

Что это

IMBACLOUD AI Agent — личный AI-инженер, встроенный в карточку VPS в панели ImbaCloud. Вы пишете задачу обычным текстом — система выполняет её на вашем сервере (режим «Выполнить») или даёт только советы без изменений на VPS (режим «Спросить»).

Типичный сценарий: «nginx отдаёт 502, разберись и почини» → агент сам смотрит статус сервиса, читает логи, находит причину, чинит и отчитывается. Настройка SSL, деплой Docker-приложения, разбор упавшего сервиса — всё это задачи в одну строку вместо получаса в SSH.

Это не отдельный сайт и не ChatGPT в браузере: агент работает через защищённый канал ImbaCloud и локальный сервис imbai-worker на вашем VPS (порт 9090, systemd). Клиентская часть (worker) — open-source в репозитории array05/IMBACLOUD-AI на GitHub.

Тарификация. Агент — платная опция к тарифу VPS: +390 ₽/мес на каждый сервер, где он подключён (входит в сумму заказа при галочке). При заказе сервера с агентом действует скидка 5% на стоимость сервера — на любой тариф и период оплаты, скидка отражается в итоге заказа и в истории списаний в биллинге. В подписку — 25 agent-кредитов + 50 вопросов «Спросить» в месяц. На первом сервере без подписки можно попробовать бесплатно: 5 кредитов и 10 вопросов (разово). Дополнительные кредиты — пакетами: +30 за 149 ₽ или +120 за 499 ₽ (не сгорают). Режим «Спросить» не тратит agent-кредиты. Один запуск «Выполнить» списывает 1–3 кредита в зависимости от числа шагов и объёма токенов (простой запрос — 1 кредит). Возврат за подписку агента при отмене сервера не предусмотрен — при досрочной отмене VPS (если она доступна) возвращается только неиспользованная часть аренды сервера; см. Возврат и отмена.

Как подключить

При заказе нового VPS

1. Заказы → Новый сервер → шаг 2 «Настройки»

2. Включите галочку «Установить IMBACLOUD AI Agent»

3. Оформите заказ как обычно

После статуса Активен агент устанавливается автоматически (обычно 2–7 минут). На карточке сервера появится блок чата; бейдж online означает, что агент готов.

Галочку можно не ставить — VPS работает как обычно, без AI.

На уже существующем сервере

На данный момент агент включается только при заказе нового VPS с галочкой. Для серверов без агента — напишите в поддержку.

Где находится в панели

Серверы → карточка сервера — блок «AI-агент на сервере» внизу страницы.

Элементы интерфейса:

История чата привязана к серверу и сохраняется в панели. Подгружается порциями — кнопка «Загрузить раньше» вверху ленты.

Два режима

Режим «Выполнить»

Агент выполняет команды на VPS: установка пакетов, правка конфигов, перезапуск сервисов, чтение логов.

• В процессе виден блок «Действия агента» — шаги с командами (можно раскрыть)
• Ответ приходит потоком (streaming), с поддержкой Markdown и блоков кода
• Лимит: 25 agent-кредитов в месяц на сервер (по подписке); сверх лимита — пакеты кредитов
• Один запуск списывает 1–3 кредита (зависит от шагов и токенов); после ответа видно «Списано N кредитов · M шагов»

Примеры:

• «Проверь состояние сервера: диск, память, нагрузка»
• «Какие сервисы запущены и какие порты открыты?»
• «Покажи последние ошибки в системных логах»
• «Установи nginx и настрой reverse proxy на порт 3000»
• «Проверь правила ufw и открой порт 443»

Режим «Спросить»

Только консультация — на сервере ничего не меняется. Удобно для планов, объяснений и разбора ошибок.

• Работает даже если worker временно недоступен (нет прямого доступа к shell)
• Лимит: 50 запросов в месяц на сервер (по подписке); 0 agent-кредитов

Примеры:

• «Как настроить nginx reverse proxy на этом сервере?»
• «Как проверить, что сервер не перегружен?»
• «Как безопасно обновить систему?»
• «Объясни эту ошибку в логе: …»

Переключайте режим вкладками внизу чата. Для опасных действий сначала спросите в «Спросить», затем подтвердите в «Выполнить».

Что умеет агент

Агент отвечает от имени ImbaCloud и не отправляет вас «настраивать через curl API панели», если задачу можно решить в чате.

Лимиты и биллинг

Счётчики отображаются под полем ввода: Agent: N кред. · Ask: X/Y · Пакет: Z.

Стоимость одного запуска «Выполнить»:

• Период подписки — календарный месяц (UTC), продление — 30 дней с момента оплаты
• Подписка и пакеты списываются с баланса прямо из чата (кнопка появится при исчерпании лимита)
• Пакеты кредитов не сгорают и тратятся после месячного лимита
• Списание agent-кредитов — только после успешного ответа; при ошибке кредиты не списываются
• Пробный период — один на аккаунт и закрепляется за первым сервером, где вы использовали агента

Автоустановка

После развёртывания VPS панель по SSH:

1. Ждёт доступность SSH (до 5 минут)

2. Настраивает apt-зеркало для RU-серверов

3. Скачивает установщик с imbacloud.ru (не с GitHub — на части VPS GitHub недоступен)

4. Поднимает imbai-worker и регистрирует его в ImbaCloud AI Gateway

5. Проверяет health (systemctl + HTTP :9090)

Статусы в карточке:

Фоновая задача на панели повторяет установку каждые 2 минуты, если первая попытка не удалась.

Если агент не установился

На карточке сервера при статусе ошибка:

1. «Установить с панели» — повтор через SSH с панели ImbaCloud

2. «Команда для SSH» — скопировать однострочник и выполнить от root на VPS, если панель не достучалась по SSH

Типичные причины:

• SSH ещё не готов сразу после создания — подождите 2–5 мин и нажмите повтор
• GitHub/apt недоступны с VPS — панель использует зеркало imbacloud.ru; при ручной установке берите команду из кнопки «Команда для SSH», не из старых инструкций
• Неверный root-пароль в панели — если меняли пароль только на сервере, напишите в поддержку

Проверка вручную на сервере:

systemctl is-active imbai-worker
curl -sf http://127.0.0.1:9090/health

Ожидается active и JSON {"status":"ok",...}.

Ограничения и важно знать

• Агент работает только на VPS, заказанных с галочкой AI при создании
• Чат скрыт для отменённых и удалённых серверов
• Возврат за подписку агента при отмене сервера не предусмотрен — при досрочной отмене VPS (если доступна) возвращается только неиспользованная часть аренды сервера; см. Возврат и отмена
• Во время переустановки ОС агент может потребовать повторной установки
• Один активный запрос на сервер — дождитесь ответа или нажмите Стоп
• Сообщение — до 8000 символов
• Агент имеет root-доступ на VPS — формулируйте задачи осознанно; для экспериментов используйте «Спросить»
• Не передавайте в чат секреты (пароли, ключи API) без необходимости

Безопасность

• Связь: браузер → панель ImbaCloud → AI Gateway → worker на вашем VPS
• У каждого пользователя свой API-ключ gateway; worker регистрируется с уникальным worker_id (server-<id>)
• Root-пароль VPS хранится зашифрованно на панели и используется только для автоустановки агента по SSH
• История чата видна только в вашем аккаунте

Исходный код и ручная установка

На VPS ставится Imbai Worker из репозитория github.com/array05/IMBACLOUD-AI:

• install.sh — точка входа установки
• worker/ — FastAPI-демон на порту 9090
• scripts/install-worker.sh — systemd, venv, регистрация на gateway

При заказе через панель всё это выполняется автоматически; команда из кнопки «Команда для SSH» генерируется панелью с вашим worker-id и token. Для продвинутых сценариев (свой VPS не из ImbaCloud, отладка, обновление worker) — см. README в репозитории.

Gateway и LLM — на стороне ImbaCloud; в GitHub только клиент worker, без доступа к нашим серверам.