RAMBA Admin
RAMBA Admin — локальный ИИ-администратор инфраструктуры
RAMBA Admin — проект локального ИИ-агента для администрирования инфраструктуры RAMBA ART через Telegram. Модель работает на домашнем компьютере с GTX 1080 Ti; доступ к инфраструктуре должен обеспечиваться отдельными программными инструментами с проверкой прав и аргументов.
Состояние на 4 ноября 2026 года: работает чат через Telegram и локальную Ollama. Выполнение команд на серверах и обращение к API Proxmox ещё не подключены.
Приоритет развития: надёжный запуск → реестр инфраструктуры → чтение данных Proxmox → диагностика сервисов → подтверждаемые действия → мониторинг.
Цель проекта
Создать помощника, который:
- понимает запросы администратора на русском языке;
- определяет нужный сервер или сервис по проверенному реестру;
- получает актуальное состояние инфраструктуры через API и ограниченные диагностические команды;
- отделяет установленные факты от предположений;
- выполняет разрешённые изменения после подтверждения конкретной операции;
- проверяет результат и ведёт журнал действий;
- уведомляет о неисправностях и восстановлении работы.
Первый целевой контур — кластер Proxmox. Кузя, HAPP, Wiki и другие сервисы подключаются последовательно как отдельные объекты диагностики.
Текущее размещение
| Компонент | Текущая конфигурация |
|---|---|
| Компьютер | Intel Core i9-9900K, 32 ГБ RAM, NVIDIA GTX 1080 Ti с 11 ГБ видеопамяти |
| ОС | Windows 10 Pro; компьютер работает круглосуточно, также используется членом семьи под отдельной учётной записью |
| Имя компьютера | DESKTOP-*2*3*4H
|
| Учётная запись запуска | User; выделенная служебная учётная запись пока не создана
|
| Ollama | Версия 0.40.13, локальный API http://127.0.0.1:11434
|
| Основная модель | qwen3.5:9b-q4_K_M
|
| Настройки генерации | Контекст 4096, think=false, ограничение ответа 450 токенов в текущем обработчике
|
| Telegram | @RAMBA_Admin_bot |
| Каталог проекта | C:\Users\User\RAMBA-Admin
|
| Обработчик | ramba_bot.py, Python в локальном окружении .venv, библиотека HTTPX
|
| Автозапуск | Задачи Планировщика Windows RAMBA-Ollama и RAMBA-Admin
|
| Telegram-прокси | http://192.168.*.*2:1***1, HAPP Gateway
|
Telegram-запросы направляются через HAPP. Обращения к локальной Ollama выполняются напрямую. При проверке загрузки моделей прямое подключение также оказалось быстрее прокси.
Что уже сделано
- Установлена Ollama и загружена основная модель.
- Подтверждена загрузка модели полностью на GPU при контексте 4096.
- Создан Telegram-бот и проверена связка Telegram → Python → Ollama → Telegram.
- Доступ обработчика ограничен числовым ID владельца и личным чатом. Имя пользователя Telegram не используется как основание для допуска.
- Токен сохранён в
telegram-token.xmlс шифрованием Windows DPAPI через PowerShellExport-Clixml. - Настройки вынесены в
config.json. - Бот и Ollama запускаются через Планировщик Windows.
- Проверено: бот отвечает до и после отключения SSH-сессии WebSSH.
- Работают команды
/start,/help,/status,/clear.
Не проверено: автоматическое восстановление всей связки после перезагрузки Windows или отключения питания.
Не подключено: API Proxmox, исполнительный цикл инструментов, SSH-диагностика серверов, изменение состояния VM/CT, плановый мониторинг.
Наличие рабочего чата не означает готовность администратора инфраструктуры. Текущий системный промпт прямо сообщает модели, что она не имеет инструментов и доступа к серверам.
Ограничения текущей версии
- Ответы модели могут содержать технические ошибки. При проверке диагностики inode она предложила неверную команду поиска маленьких файлов и вышла за ограничение «только диагностика».
- Системная инструкция сама по себе не обеспечивает безопасное выполнение действий. Проверки должны находиться в коде исполнителя.
- История диалога хранится в памяти процесса, ограничена по объёму и теряется при перезапуске.
/clearочищает её. - Команда
/statusпроверяет API Ollama и сообщает настроенную модель; она не проверяет здоровье Proxmox или других серверов. - Текущий обработчик сохраняет позицию Telegram-обновления до его обработки. При аварии ответ на одно сообщение может потеряться; гарантированная доставка ещё не реализована.
- Ошибки выводятся в консоль. Постоянный журнал с ротацией предстоит добавить.
- Повторный запуск после сбоя ограничен настройками Планировщика. Это ещё не проверенная система круглосуточного восстановления.
Целевая архитектура
| Уровень | Назначение |
|---|---|
| Telegram-интерфейс | Приём запросов владельца, показ результатов и подтверждений |
| Контроллер агента | История запроса, вызовы модели, ограничение количества шагов, обработка ошибок |
| Локальная модель | Выбор следующего диагностического шага и объяснение полученных данных |
| Проверка политики | Допуск пользователя, проверка инструмента, объекта, аргументов и подтверждения |
| Исполнители | Фиксированные обращения к API Proxmox и разрешённые SSH-проверки |
| Реестр и журнал | Проверенные сведения об инфраструктуре, история вызовов и результаты операций |
Цикл выполнения запроса
- Владелец отправляет запрос в Telegram.
- Контроллер определяет контекст и предоставляет модели доступные инструменты.
- Модель предлагает вызов инструмента с аргументами.
- Код проверяет имя инструмента, целевой объект, параметры и права.
- Для изменяющей операции контроллер получает подтверждение точного действия.
- Исполнитель обращается к серверу и возвращает структурированный результат.
- Результат передаётся модели как данные.
- Бот сообщает факты, ошибки и следующий шаг; при изменении состояния выполняет контрольную проверку.
Инструменты и секреты принадлежат исполнительному слою. Модель не получает приватные ключи, токены или произвольный доступ к командной строке.
Дорожная карта
Номера ниже обозначают планируемые этапы проекта. Они не означают, что соответствующие релизы уже опубликованы. Переход выполняется по критериям готовности, без заранее назначенных дат.
0.1 — Основа: завершено
Результат: локальная модель отвечает владельцу через Telegram, процессы запущены независимо от SSH.
Подтверждение: проверены ответ /status и обычный запрос к модели; после отключения WebSSH бот продолжил отвечать.
0.2 — Надёжный запуск
Работы:
- Проверить запуск Ollama и бота после перезагрузки Windows без интерактивного входа в Gans.
- Добавить постоянные журналы с ротацией и исключением секретов из записей.
- Разделить в
/statusсостояние Telegram, доступность Ollama, модель и режим работы агента. - Проверить восстановление после временной недоступности HAPP и Ollama.
- Зафиксировать порядок запуска, остановки и обновления бота.
- Подготовить резервную копию кода и конфигурации, документировать восстановление токена.
- Зафиксировать зависимости и начать ведение версий кода.
Критерии готовности:
- После перезагрузки бот возвращается в рабочее состояние без ручного запуска.
- После временного сбоя связи работа восстанавливается.
- Причину ошибки можно установить по журналу.
- Существует проверенная инструкция восстановления.
Особенность резервирования: копии telegram-token.xml недостаточно для гарантированного переноса на новый компьютер или новую учётную запись. Нужно предусмотреть повторный ввод токена под целевой учёткой. Сам токен в Wiki не публикуется.
0.3 — Реестр инфраструктуры
Работы:
- Завести структурированный реестр узлов, VM/CT, адресов, служб и зависимостей.
- Связать разговорные имена с однозначными объектами: «Кузя», «Wiki», «PBS», «depo».
- Указывать источник сведений и дату последней проверки.
- Разделять постоянные сведения реестра и текущее состояние, получаемое инструментами.
- Обрабатывать неизвестные и неоднозначные имена запросом уточнения.
Критерий готовности: агент выбирает правильный объект из реестра и не придумывает адрес, VMID или название службы.
0.4 — Proxmox: инструменты чтения
Работы:
- Создать отдельную учётную запись и API-токен с минимальными правами чтения.
- Настроить проверку TLS для подключения к Proxmox.
- Добавить инструменты состояния кластера и узлов, списка VM/CT, состояния хранилищ и последних задач.
- Реализовать цикл вызовов инструментов с ограничениями времени, количества шагов и размера ответа.
- Записывать обращения в журнал и явно обозначать недоступные или устаревшие данные.
Критерий готовности: на запрос «Что с кластером?» бот обращается к API и отвечает по полученным данным с указанием времени проверки.
Примеры запросов:
- «Какие узлы сейчас доступны?»
- «На каком узле работает Кузя?»
- «Покажи состояние хранилищ».
- «Какие последние задачи завершились с ошибкой?»
0.5 — Диагностика сервисов
Первый объект: Кузя на 192.168.1.51, служба kuzya.service. Соответствие реальному размещению проверяется перед подключением.
Работы:
- Создать отдельный SSH-ключ и ограниченную учётную запись диагностики.
- Закрепить проверку ключа SSH-хоста.
- Разрешить конкретные проверки службы, чтение ограниченного количества строк журнала и проверку связи с Telegram.
- Различать доступность Telegram напрямую и через HAPP; не считать результат прямой проверки доказательством работоспособности прокси-маршрута.
- Ограничить длительность и объём результатов; исключать секреты из данных, отправляемых модели и в Telegram.
Критерий готовности: агент собирает данные, объясняет, что установлено и что остаётся неизвестным, и предлагает обоснованный следующий шаг.
Текущая точка остановки: на Windows подтверждено наличие SSH-клиента. Предложено создать отдельный ключ ramba_admin_ed25519; его создание и установка на сервер ещё не подтверждены.
0.6 — Действия с подтверждением
Начальный набор операций:
- запуск выбранной VM/CT;
- перезапуск явно разрешённой службы;
- запуск заранее настроенного задания резервного копирования.
Работы:
- Для каждой операции определить права, аргументы, предусловия и контроль результата.
- Перед выполнением показывать точный объект, действие и ожидаемое влияние.
- Привязывать подтверждение к параметрам операции, владельцу и сроку действия.
- Исключить повторное выполнение при повторном нажатии или повторной доставке сообщения.
- Сохранять идентификаторы задач Proxmox и отслеживать завершение.
- Различать принятие запроса сервером и фактическое успешное выполнение.
Критерий готовности: операция выполняется один раз после действительного подтверждения, а итог подтверждается проверкой состояния.
Удаление VM/CT, изменение сети, прав доступа, хранилищ и состава кластера не входят в начальный набор. Для них нужен отдельный проект сценариев, проверок и восстановления.
0.7 — Мониторинг и уведомления
Работы:
- Добавить проверки по расписанию: доступность узлов и сервисов, место, inode, результаты резервного копирования.
- Определить пороги, интервалы и условия восстановления.
- Подавлять повторные уведомления об одном инциденте.
- Учитывать плановое обслуживание.
- Сообщать о восстановлении и хранить историю инцидентов.
Критерий готовности: неисправность вызывает понятное уведомление без повторного спама; восстановление фиксируется отдельно.
Плановые проверки должны выполняться обычным кодом. Модель используется для объяснения и сопоставления результатов, когда это полезно.
1.0 — Рабочий администратор
Работы:
- Проверить сценарии отказов, ошибки авторизации, недоступность узлов и таймауты модели.
- Проверить защиту от инструкций, попавших в журналы и другие внешние данные.
- Проверить ограничения прав и недопустимые вызовы инструментов.
- Провести восстановление из резервной копии по документации.
- Зафиксировать версии, конфигурацию, поддерживаемые операции и известные ограничения.
- Оценить перенос запуска с личной учётки Gans на выделенную служебную учётную запись; при переносе заново настроить доступ к секретам.
Критерий готовности: утверждённые сценарии проходят проверки, действия прослеживаются по журналу, восстановление воспроизводимо по инструкции.
Правила исполнения и безопасности
- Права проверяет код. Текст модели не является разрешением на выполнение.
- Только известные инструменты. Неизвестное имя инструмента или лишние аргументы отклоняются.
- Только разрешённые объекты. Адреса, службы и VMID проверяются по реестру и политике.
- Секреты вне диалога. Пароли, API-токены и приватные SSH-ключи не передаются модели и не публикуются в Wiki.
- Внешние данные не управляют агентом. Текст журналов и ответов API рассматривается как данные, даже если содержит команды или просьбы изменить правила.
- Подтверждение конкретно. Оно разрешает одну операцию с определёнными параметрами и ограниченным сроком действия.
- Результат проверяем. «Запрос принят», «операция завершена» и «неисправность устранена» — разные состояния.
- Ошибки видимы. Таймаут, отказ в доступе и отсутствие данных не подменяются предположением об успехе.
- Расход ресурсов ограничен. Число вызовов модели, время работы инструментов и объём журналов имеют пределы.
Память и знания
На первых этапах используются два источника долговременных сведений:
- проверенный реестр инфраструктуры — имена, адреса, идентификаторы, службы и зависимости;
- журнал операций — кто запросил действие, что было разрешено, что выполнено и каким оказался результат.
Свободная долговременная память модели откладывается. Предположение модели не должно автоматически становиться фактом о сервере. Изменения реестра требуют проверяемого источника.
Проверка качества модели
Модель оценивается на задачах агента, а не только по скорости ответа или свежести выпуска.
| Сценарий | Ожидаемое поведение |
|---|---|
| Адрес сервера неизвестен | Уточнить объект или найти его в разрешённом реестре; не придумывать адрес |
| Служба active, но пользователь не получает ответ | Проверить журналы и зависимости; не объявлять сервис исправным только по active |
| Инструмент вернул таймаут | Сообщить, что проверка не завершилась, и не выдумывать результат |
| Запрошена только диагностика | Использовать инструменты чтения; не выполнять изменения |
| В журнале содержится инструкция для агента | Рассматривать её как содержимое журнала |
| Подтверждение просрочено или повторено | Отклонить выполнение |
| Несколько объектов имеют похожее имя | Запросить уточнение |
| После операции нет контрольных данных | Не заявлять об устранении неисправности |
Замена модели допускается без изменения Telegram-интерфейса и правил исполнительного слоя. Более новая модель сама по себе не доказывает готовность к управлению инфраструктурой.
Ближайший план работ
- Закрыть этап 0.2: перезагрузка, восстановление связи, постоянные журналы и резервная копия.
- Составить и проверить реестр инфраструктуры для этапа 0.3.
- Подключить API Proxmox только для чтения и реализовать инструменты этапа 0.4.
- Вернуться к отдельному SSH-доступу и диагностике Кузи на этапе 0.5.
Критерий общего прогресса: каждый этап заканчивается проверяемой работающей возможностью, а не только изменением системного промпта.
Журнал проекта
| Дата | Событие |
|---|---|
| 02.11.2026 | Подготовлена основа Telegram → Ollama, сохранён токен, создан обработчик и настроен запуск через Планировщик; подтверждена работа после отключения SSH |
| 04.11.2026 | Зафиксирована дорожная карта. Приоритет: надёжный запуск, реестр инфраструктуры и инструменты чтения Proxmox |