FirstVDS: агент для управления серверами по API

FirstVDS — хостинг виртуальных серверов, у которого биллинг открыт по API. ИИ-агент забирает рутину вокруг парка VPS: собрать список машин, поменять параметры, сверить списания — без похода в панель за каждой строчкой.

Агент — программа, которая делает дело целиком, а не отвечает на вопрос. Три признака: работает в ваших сервисах, доводит до результата, работает без вас. Чат-бот подсказывает кнопку, агент нажимает сам.

Коннектор — подключение агента по выданному доступу. Ключ в привычном виде тут не выдают: API биллинга работает по логину и паролю учётной записи. В настройках профиля есть поле «Доступ к API» — там указывают IP-адреса, с которых пойдут запросы. Пока адреса нет в белом списке, запросы не пройдут. Секрет живёт в хранилище подключения.

FirstVDS — хостер виртуальных серверов: готовые VDS и VPS, серверы с собственной конфигурацией, с GPU, под Windows. Внутри работает биллинг BILLmanager, и он открыт наружу: запрос вида my.firstvds.ru/billmgr?authinfo=...&func=...&out=json возвращает JSON с данными аккаунта. У серверов видны домен, IP-адрес и внутренний ID — по нему идут все операции.

### Своя система по API: чтение и запись

Агент забирает список серверов запросом func=vds и складывает в вашу таблицу: ID, домен, IP. Дальше читает параметры машины и, если просили, пишет изменения — func=vds.edit меняет ядра, память, число адресов. Формат ответа задаёт out: json для разбора, JSONdata для чистых данных. Каждый вызов агент показывает до выполнения, а результат сверяет с ответом биллинга: «ok» или текст ошибки.

### Пересчёт чужой таблицы: найти ошибку

У вас таблица расходов, у биллинга — платежи и списания по счёту. Агент выгружает факты и сопоставляет построчно: где сумма не сходится, где услуга есть в счёте, но её нет в таблице. Сам не правит — отдаёт расхождения с ID сервера и датой. Бухгалтеру остаётся проверить спорные строки, а не перебивать месяц руками: агент уже прошёл по позициям.

### Индексация и техошибки: список правок

Агент ведёт индекс парка: какие серверы под аккаунтом, где какой IP, что заказано и что лежит в корзине. К этому добавляет технические замечания — какие машины ждут перезагрузки после смены параметров, где не закрыт вопрос по диску. Получается список правок: что сделать, на каком сервере и почему. Дальше вы решаете, что берёте сами, а что отдаёте в поддержку.

Подпись под заказом и оплата: заказ сервера с оплатой с лицевого счёта — это деньги, агент делает такое только после вашего «да». Удаление VDS тоже ваше: без статуса реселлера из API его не сделать, нужен звонок в поддержку или подтверждение по SMS.

Войдите в биллинг my.firstvds.ru или зарегистрируйтесь — без учётной записи API не работает. В настройках профиля откройте поле «Доступ к API» и внесите адреса, с которых пойдут запросы. Выдайте доступ агенту: логин (почта) и пароль уходят в хранилище подключения. Проверьте связь списком серверов — в ответе будут ID, домен и IP.

Не меняет размер диска — из клиентского аккаунта это недоступно, нужны права поддержки в VMmanager. Не удаляет серверы без подтверждения и не обходит телефонную проверку прав. Не переписывает вашу таблицу расходов: показывает расхождения, но не приводит документы в порядок сам.

Что такое агент? Программа, которая выполняет дело целиком: собрать, проверить, отдать результат.

Что такое коннектор? Подключение агента к FirstVDS по выданному доступу — логину и паролю аккаунта с белым списком IP.

Нужен ли программист? Нет: запросы к биллингу собираются в самой панели — у форм есть инструмент API с готовым вызовом.