Перейти к содержанию

RAMBA Admin

Материал из RAMBA Wiki
Версия от 13:45, 4 ноября 2026; Artem (обсуждение | вклад) (Новая страница: «= RAMBA Admin — локальный ИИ-администратор инфраструктуры = '''RAMBA Admin''' — проект локального ИИ-агента для администрирования инфраструктуры RAMBA ART через Telegram. Модель работает на домашнем компьютере с GTX 1080 Ti; доступ к инфраструктуре должен обеспечиваться отде...»)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)

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 через PowerShell Export-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-проверки
Реестр и журнал Проверенные сведения об инфраструктуре, история вызовов и результаты операций

Цикл выполнения запроса

  1. Владелец отправляет запрос в Telegram.
  2. Контроллер определяет контекст и предоставляет модели доступные инструменты.
  3. Модель предлагает вызов инструмента с аргументами.
  4. Код проверяет имя инструмента, целевой объект, параметры и права.
  5. Для изменяющей операции контроллер получает подтверждение точного действия.
  6. Исполнитель обращается к серверу и возвращает структурированный результат.
  7. Результат передаётся модели как данные.
  8. Бот сообщает факты, ошибки и следующий шаг; при изменении состояния выполняет контрольную проверку.

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

Дорожная карта

Номера ниже обозначают планируемые этапы проекта. Они не означают, что соответствующие релизы уже опубликованы. Переход выполняется по критериям готовности, без заранее назначенных дат.

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 на выделенную служебную учётную запись; при переносе заново настроить доступ к секретам.

Критерий готовности: утверждённые сценарии проходят проверки, действия прослеживаются по журналу, восстановление воспроизводимо по инструкции.

Правила исполнения и безопасности

  1. Права проверяет код. Текст модели не является разрешением на выполнение.
  2. Только известные инструменты. Неизвестное имя инструмента или лишние аргументы отклоняются.
  3. Только разрешённые объекты. Адреса, службы и VMID проверяются по реестру и политике.
  4. Секреты вне диалога. Пароли, API-токены и приватные SSH-ключи не передаются модели и не публикуются в Wiki.
  5. Внешние данные не управляют агентом. Текст журналов и ответов API рассматривается как данные, даже если содержит команды или просьбы изменить правила.
  6. Подтверждение конкретно. Оно разрешает одну операцию с определёнными параметрами и ограниченным сроком действия.
  7. Результат проверяем. «Запрос принят», «операция завершена» и «неисправность устранена» — разные состояния.
  8. Ошибки видимы. Таймаут, отказ в доступе и отсутствие данных не подменяются предположением об успехе.
  9. Расход ресурсов ограничен. Число вызовов модели, время работы инструментов и объём журналов имеют пределы.

Память и знания

На первых этапах используются два источника долговременных сведений:

  • проверенный реестр инфраструктуры — имена, адреса, идентификаторы, службы и зависимости;
  • журнал операций — кто запросил действие, что было разрешено, что выполнено и каким оказался результат.

Свободная долговременная память модели откладывается. Предположение модели не должно автоматически становиться фактом о сервере. Изменения реестра требуют проверяемого источника.

Проверка качества модели

Модель оценивается на задачах агента, а не только по скорости ответа или свежести выпуска.

Сценарий Ожидаемое поведение
Адрес сервера неизвестен Уточнить объект или найти его в разрешённом реестре; не придумывать адрес
Служба active, но пользователь не получает ответ Проверить журналы и зависимости; не объявлять сервис исправным только по active
Инструмент вернул таймаут Сообщить, что проверка не завершилась, и не выдумывать результат
Запрошена только диагностика Использовать инструменты чтения; не выполнять изменения
В журнале содержится инструкция для агента Рассматривать её как содержимое журнала
Подтверждение просрочено или повторено Отклонить выполнение
Несколько объектов имеют похожее имя Запросить уточнение
После операции нет контрольных данных Не заявлять об устранении неисправности

Замена модели допускается без изменения Telegram-интерфейса и правил исполнительного слоя. Более новая модель сама по себе не доказывает готовность к управлению инфраструктурой.

Ближайший план работ

  1. Закрыть этап 0.2: перезагрузка, восстановление связи, постоянные журналы и резервная копия.
  2. Составить и проверить реестр инфраструктуры для этапа 0.3.
  3. Подключить API Proxmox только для чтения и реализовать инструменты этапа 0.4.
  4. Вернуться к отдельному SSH-доступу и диагностике Кузи на этапе 0.5.

Критерий общего прогресса: каждый этап заканчивается проверяемой работающей возможностью, а не только изменением системного промпта.

Журнал проекта

Дата Событие
02.11.2026 Подготовлена основа Telegram → Ollama, сохранён токен, создан обработчик и настроен запуск через Планировщик; подтверждена работа после отключения SSH
04.11.2026 Зафиксирована дорожная карта. Приоритет: надёжный запуск, реестр инфраструктуры и инструменты чтения Proxmox