ИИ-агенты. Управление модулем

Эта статья — продолжение ИИ-агенты. Быстрый старт. Здесь собраны операции над самим модулем: провайдеры ИИ, переустановка и удаление. У модуля нет собственного сервиса, который можно запустить или остановить: запускаются и останавливаются отдельные рабочие места, см. раздел «Запуск, остановка и перезапуск». Сами места разобраны в статье ИИ-агенты. Рабочие места и доступ, ключи провайдеров — в статье ИИ-агенты. API-ключи провайдеров.

Для работы вам нужен сервер с BeAdmin — у наших партнёров такой VPS готов сразу после заказа.

Проверено временем: более 15 лет на рынке хостинга. Ваш VPS с BeAdmin готов к работе из коробки.

• Германия
• Нидерланды
• Швеция
• Швейцария
• Испания
• США

Выбрать сервер

Европейская стабильность и простота. Запускайте BeAdmin вместе с VPS в один клик.

• Германия
• Нидерланды
• Швеция
• Эстония
• Румыния
• Швейцария
• Испания
• Великобритания
• США

Зарегистрироваться

Провайдеры

Провайдер — это ИИ‑агент, который модуль запускает в рабочих местах: например, Claude Code или Codex. Провайдеры устанавливаются, обновляются и удаляются в настройках модуля. Операции с провайдерами выполняются по одной: пока идёт установка, обновление или удаление одного провайдера, остальные ждут, потому что запуски менеджера пакетов не должны пересекаться.

Установка провайдера

Провайдер устанавливается из подписанного репозитория его разработчика, обычно это занимает пару минут. Пошаговый пример для Claude Code есть в быстром старте. Чтобы агент заработал, провайдеру нужен API‑ключ — как его задать, описано в статье ИИ-агенты. API-ключи провайдеров.

Без лицензии доступен один провайдер. Чтобы установить ещё одного, вам нужно докупить слот провайдера в лицензии (подробнее в статье Как оформить лицензию) или сначала удалить установленного: пока свободных слотов нет, установить нового не получится.

Обновление агента

Агент каждого провайдера обновляется отдельно, на его карточке в настройках модуля, и только по вашей команде: автообновление агентов отключено, чтобы версию задавали вы. Запущенные места при обновлении не перезапускаются, и их сессии не прерываются. Если обновление изменило настройки запуска мест, например предел ресурсов, они вступят в силу после перезапуска места.

Удаление провайдера

Панель удаляет пакет провайдера с сервера, а данные его агента — историю, сессии и всё, что он сохранил, — из всех рабочих мест. Сами места, код и сессии tmux остаются, агенты других провайдеров продолжают работать.

⚠️ Удаление провайдера останавливает его агента

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

Общий ключ провайдера при удалении стирается, а ключи рабочих мест остаются; подробности — в таблице статьи про ключи. Поэтому после повторной установки провайдера общий ключ вам нужно задать заново.

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

Блокировка провайдера по лимиту

Если лимит провайдеров в лицензии стал меньше числа установленных — например, лицензия закончилась или слоты убрали, — лишние провайдеры получают состояние «Превышен лимит лицензии». Блокируются самые новые провайдеры, самые старые продолжают работать.

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

Чтобы снять блокировку, вам нужно либо докупить слоты провайдеров, либо удалить лишних провайдеров. После этого блокировка снимается сама. Панель сверяет лимит при изменении лицензии и после удаления провайдера, а в остальных случаях раз в сутки, поэтому блокировка и её снятие могут наступить не мгновенно. По тем же правилам блокируются рабочие места — см. раздел «Заблокированное место».

Переустановка модуля

Переустановка заново применяет настройки модуля поверх текущих. Она нужна, если модуль работает некорректно и вы хотите прогнать установку заново, ничего не теряя. Файлы рабочих мест и SSH‑ключи сохраняются, провайдеры и ключи не затрагиваются, а запущенные сессии tmux и задачи в них не прерываются: места продолжают работать.

Как и после обновления агента, изменённые настройки запуска мест вступают в силу в запущенном месте только после его перезапуска.

Удаление модуля

Удаление модуля удаляет установленных провайдеров вместе с данными их агентов (история, сессии), настройки модуля и прерывает все сессии tmux. Что станет с рабочими местами, зависит от опции «Удалить файлы рабочих мест»:

• Опция не отмечена. Места, их код, остальные файлы и SSH‑ключи остаются на сервере. При повторной установке панель возвращает их, а нового места не создаёт — см. быстрый старт. Данные агентов вернуть не получится.
• Опция отмечена. Вместе с модулем удаляются домашние каталоги всех мест и сами места.

‼️ Удаление файлов рабочих мест необратимо

Если вы отметите «Удалить файлы рабочих мест», будут удалены домашние каталоги всех мест вместе с кодом и SSH‑ключами, а сами места исчезнут. Восстановить их нельзя. Если файлы могут понадобиться, сначала скопируйте их на свой компьютер.

Общие ключи всех провайдеров удаляются при любом удалении модуля, а ключи мест — только вместе с местами: подробности в таблице статьи про ключи. Пакеты, которые модуль поставил для работы мест (tmux, git, curl и другие), остаются на сервере: ими могут пользоваться и другие программы.

Что дальше

• ИИ-агенты. Быстрый старт — установка модуля, первое подключение и запуск агента.
• ИИ-агенты. Рабочие места и доступ — создание, запуск, остановка и удаление мест, SSH‑ключи, лимиты.
• ИИ-агенты. API-ключи провайдеров — общий ключ и ключ рабочего места, что происходит с ключами при удалении.