Ассистент

Ассистент — это чат в админке с облачной моделью, которую вы подключаете своим API-ключом. Спросите, у каких нод были проблемы, почему кто-то не может подключиться, кто превысил лимит устройств; попросите сделать группу, изменить тексты подписки или отключить профиль на ноде. Он смотрит данные собственными инструментами панели и готовит каждое изменение карточкой, написанной словами панели. Ничего не меняется, пока вы не нажмёте «Применить».

Он действует с правами того админа, который с ним говорит, и не более того, и доступен в версии для VPS (см. В версии для Cloudflare).

Включение#

Владелец настраивает его в ИИ → Ассистент:

1. В блоке Провайдеры нажмите Подключить у нужного провайдера, вставьте его API-ключ и нажмите Проверить и сохранить. Панель попросит ваш passkey или код, проверит ключ у провайдера и запечатает его; после этого на карточке видны только последние четыре символа.
2. На карточке подключённого провайдера выберите Модель (цена за миллион токенов указана под ней) и Бюджет в месяц, $.
3. Выше включите Ассистент включён, выберите Провайдер для чата, Насколько глубоко думать (Быстро, Обычно, Тщательно), Кто может пользоваться (Только я, Владелец и помощники, Все в панели), заполните Заметки для ассистента, укажите, как долго Хранить разговоры, и нажмите Сохранить.

У админов, которым он открыт, в углу каждой страницы появляется круглая кнопка; чат открывается и закрывается также по Ctrl+J (⌘J на Mac).

Провайдеры и куда уходят данные#

То же написано на карточке каждого встроенного провайдера. Владелец может добавить до пяти своих OpenAI-совместимых провайдеров: укажите название, базовый адрес API (например, https://example.com/v1), ID модели, ключ и при необходимости цены входных и выходных токенов. Перед сохранением панель проверяет, что модель умеет вызывать инструменты. Если провайдер отдаёт список моделей, модель можно выбрать из него. На карточке задайте месячный бюджет; провайдера можно выбрать основным или резервным.

Панель обращается к провайдеру со своего сервера; ключ шифруется и не возвращается в браузер. Для своего адреса нужен HTTPS. Чтобы подключить HTTP в локальной сети панели, отдельно разрешите локальный доступ; для локальной модели ключ может быть пустым. Link-local адреса, включая адреса метаданных облака, блокируются; адреса операторского NAT (100.64.0.0/10) считаются локальными. При выборе провайдера учитывайте его правила обработки данных. Указанные цены дают оценку расходов: нулевую цену оставляйте только для бесплатного провайдера.

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

Что он умеет#

• Читать: ноды и их состояние, людей, группы, устройства, события и алерты, доступность из страны, подписки и DNS, обновления; журнал аудита для владельца. Это инструменты чтения MCP для вашей роли.
• Менять: любое изменение из MCP, в виде плана. План приходит в чат карточкой Предлагаемое изменение с собственным описанием панели, фактами (всё, что пришло из данных, приводится как цитата) и пометками об опасности. Применить выполняет именно этот план, один раз; Отклонить отбрасывает его; план, не применённый за 10 минут, истекает.
  • План, которому нужен владелец (он меняет то, что работает на нодах, затрагивает многих людей или виден каждому человеку): когда с ассистентом говорит владелец, Одобрить и применить запрашивает passkey или код и делает и то и другое; для остальных карточка сообщает, что план ждёт владельца в ИИ → Ждут вас.
  • Установка ноды по SSH одобряется только в ИИ → Ждут вас: там владелец сверяет ключ хоста и выбирает, как панель входит на сервер.
• Его права — это ваши права: у ассистента владельца инструменты уровня «Админ», у помощника — уровня «Оператор», у админа только для чтения — только инструменты чтения.

Сама модель ничего не применяет: у неё нет для этого инструмента. Каждый вызов попадает в журнал аудита как «Ассистент <админа>» с источником Ассистент (отбирайте по нему в Настройки → Аудит).

Разобраться, что не открывается#

Спросите «у кого не подключается и что чинить?» или нажмите Разобраться с доступностью на Здоровье → Люди: чат откроется с готовым вопросом. Ассистент начинает с access_report: протоколы против нод (и групп) за сутки, кто пробовал, у кого получилось, отказы, зависания, заморозки и потери, которые различают счётчики, и кому сервер выдан, но он ни разу не подключался. К этому добавляется взгляд из страны (какие операторы видят ноду тёмной, какие порты TSPU режет, что видели пользователи kl!ck) и block_diagnosis: как именно заблокирована нода — забанен адрес, режется один порт, душится TCP, режется UDP, узнаётся один протокол, на мобильных проходят только адреса из белого списка, либо ничего не заблокировано и нода просто сломана.

Ответ — короткая картина по протоколам, нодам и группам и три–пять рекомендаций по рангу, каждая со своими доказательствами и одним планом (релей через вход, который люди видят, перенос на порт 443, другой протокол для группы, CDN-профиль, IPv6-вход, вывод заблокированного сервера из подписок). Правила фиксированы: одни и те же факты дают один и тот же ответ; где сигнала нет, ассистент так и говорит и называет проверку, которая даст ответ (например, path_probe по UDP с ноды в стране). У VLESS нет счётчика попыток, его сбои видны только по взгляду из страны и kl!ck.

Память#

• Заметки. Ассистент сохраняет то, что должен помнить («Запомнил: …» в чате, с кнопкой Забыть). ИИ → Память перечисляет их: любую можно добавить, изменить и удалить, либо нажать Забыть всё. Каждая заметка попадает в каждый разговор; не больше 100 заметок по 400 символов.
• Заметки для ассистента (заметки владельца в ИИ → Ассистент): что ассистенту каждого админа нужно знать об этой панели.
• Разговоры. Ассистент знает названия ваших недавних разговоров и может искать и читать прежние, когда вы на них ссылаетесь. ИИ → Память → Разговоры открывает разговор в чате или удаляет один или все.

Разговоры и заметки запечатаны в базе панели и закрыты для всех, кроме своего админа: их не читает никто, включая владельца. Разговоры хранятся столько, сколько указано в Хранить разговоры; заметки остаются, пока вы их не удалите. Всё, что похоже на ключ или пароль, вырезается из того, что панель отправляет провайдеру, кроме сообщения, которое вы пишете сами.

Лимиты и стоимость#

• Один ответ использует не больше 24 вызовов инструментов и 10 минут; Остановить прекращает его сразу и сохраняет уже сказанное.
• Один админ отправляет не больше 20 сообщений в минуту, а в одном разговоре одновременно пишется один ответ.
• У каждого провайдера есть Бюджет в месяц, $, заданный владельцем; он оценивается по ценам провайдера и расходу, который сообщает каждый ответ. Достигнув бюджета, ассистент останавливается до следующего месяца. ИИ → Ассистент → В этом месяце показывает стоимость по админам.

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

• Ключ запечатывается мастер-ключом панели, который владелец вводит после passkey или кода, и никогда не показывается, не попадает в логи и в журнал аудита.
• Имена, заметки и строки логов нод и людей для ассистента — данные, а не инструкции; у него нет инструмента, который выходил бы в интернет; чат не показывает картинки и HTML, ссылки на страницы админки остаются в админке, а прочие ссылки открываются отдельно.
• Даже если имя ноды или заметка уговорят модель предложить что-то, это будет лишь карточка: изменение произойдёт, когда человек прочитает её и нажмёт Применить.

Возвраты по таймеру#

Ассистент отвечает на ваши сообщения, а ещё умеет возвращаться сам. Когда он запускает или готовит что-то, что закончится позже (отладочный сбор логов ноды, замер скорости, проверки, результаты которых придут позже, выкатку или обновление ноды, реле), он заводит таймер: время чуть после конца работы и заметку, что тогда прочитать. В разговоре появляется тихая строка вроде «Вернусь с результатом в 15:41 (через 9 мин) · Отменить», во времени панели.

• В это время панель сама продолжает тот же разговор, даже с закрытым браузером: ассистент видит разговор, читает результат своими инструментами и отвечает. Ответ помечен По таймеру, а точка на кнопке чата и в списке разговоров говорит, что он пришёл, пока вас не было.
• Таймер для изменения, которое начнётся, только когда вы примените план (сбор логов, замер скорости), ждёт применения и отсчитывается от него; если вы отклоните план или он истечёт, таймер уходит вместе с ним.
• Он читает то, что может читать ваша роль, с теми же лимитами и бюджетом. Раз за ним никто не смотрит, он готовит только те изменения, которые оператор может сделать без чьего-либо одобрения: если изменению нужны права администратора или одобрение владельца, он попросит написать об этом в чате. Ничего не меняется, пока вы не нажмёте Применить на карточке плана.
• В разговоре ждут не больше 3 таймеров, у одного администратора не больше 20, каждый от 30 секунд до 24 часов вперёд. Отменить на строке убирает таймер; удаление разговора убирает и его таймеры.
• Если таймер не может сработать (ассистент выключен, бюджет месяца израсходован, провайдер не отвечает), в разговоре остаётся короткая заметка с причиной. Таймер, пропущенный, пока панель была выключена, срабатывает один раз при её запуске, если опоздал не больше чем на сутки; иначе он снимается с заметкой.
• Если вы попросите («напиши в Telegram, если что-то не так»), таймер, нашедший проблему, отправит одну строку и в ваш привязанный чат Telegram. Просьба должна быть в вашем собственном сообщении; ассистент в ответе скажет, придёт ли сообщение в Telegram.

Задачи по расписанию#

Панель может сама, по расписанию, проверять ноды и сообщать, когда что-то нашла: откройте ИИ → Задачи по расписанию. Владелец создаёт, меняет и удаляет задачи; помощники их видят и могут нажать Запустить сейчас; админы только для чтения их не видят.

Два вида#

• Проверка: список инструментов самой панели с аргументами, которые выполняются по порядку, без модели и бесплатно: fleet_digest, checks_run_now, block_diagnosis для страны, path_probe между двумя нодами и другие инструменты чтения и замеров профиля оператора. У каждого шага могут быть условия на результат инструмента; если условие выполнено, запуск нашёл проблему. Обычные условия редактор предлагает в один клик: Находка уровня «предупреждение» и выше, Нода не на связи, Число выше порога, Список не пуст. Поле — путь через точку внутри результата (totals.nodes_problem_now, nodes[].status или **.severity для поля на любой глубине). Ошибка инструмента — тоже проблема считает неответившую ноду проблемой, а не проваленным запуском.
• Ассистент: запрос вроде «Проверь ноды и скажи, если что-то не так», который ассистент получает по расписанию. Он работает с инструментами оператора: читает, делает замеры и может подготовить план, который ждёт вас карточкой; применить он ничего не может. Ответы попадают в отдельный разговор задачи, отмеченный По расписанию в ИИ → Память и в истории чата, по новой части на каждый запуск; его можно открыть и продолжить с последнего запуска. Каждый запуск ассистент заканчивает выводом: именно вывод решает, нашёл ли запуск проблему. Стоимость берётся из месячного бюджета ассистента.

Можно и попросить ассистента («проверяй ноды каждое утро и скажи, если что-то не так»): он подготовит задачу планом, который вы одобрите. Внешние агенты делают то же через MCP инструментом task_create_plan.

Когда она запускается#

• Каждые N минут или часов (проверка не чаще раза в 5 минут, задача ассистента — раза в 15), Каждый день в заданное время или Каждую неделю в заданный день и время, в часовом поясе панели (том же, что у расписания обновлений; вкладка его называет).
• При смене фиксированного смещения UTC панель пересчитывает следующий запуск включённых задач. Переход на летнее или зимнее время автоматически не учитывается: при смене местного времени задайте смещение снова.
• Каждая задача стартует на несколько минут позже своего времени, всегда с одной и той же задержкой, чтобы задачи не начинались в одну секунду.
• Одновременно идёт только один запуск задачи. Запуск, пропущенный, пока панель не работала, выполняется один раз после её старта, а не по разу за каждый пропуск; запуск, прерванный остановкой, отмечается как прерванный.
• Запустить сейчас начинает запуск сразу: не чаще раза в минуту для проверки и раза в пять минут для задачи ассистента.

Что говорит запуск#

Проблема открывает в Здоровье алерт Задача по расписанию нашла проблему с названием задачи и коротким описанием; он закрывается сам, когда следующий запуск проходит чисто. Три проваленных запуска подряд открывают Задача по расписанию не выполняется с причиной. Если у задачи включено Отправлять и в Telegram, оба уходят в чаты, привязанные для алертов. Запуски под задачей показывают последние 50 запусков (не старше 30 дней): что совпало на каждом шаге и начало результата или разговор ассистента и его стоимость.

Надёжность#

• Провайдера, который не ответил, спрашивают снова, с растущей паузой; если он так и не отвечает, запуск начинается заново на провайдере из Запасной провайдер для задач, который выбирают в ИИ → Ассистент.
• Месячный бюджет каждого провайдера соблюдается: запуск, который бы его превысил, не начинается и говорит об этом.
• Запуск проверки длится не дольше 5 минут, запуск ассистента — не дольше 10 минут на каждом провайдере; одновременно идут не больше двух проверок и одной задачи ассистента.
• В задаче нет секретов: название, аргумент или запрос, похожие на ключ, токен или ссылку с секретом, отклоняются, а запрос хранится в базе панели запечатанным, как заметки ассистента.

MCP, токены и одобрения#

Внешние агенты (Claude Code, Cursor, ваши скрипты) по-прежнему пользуются MCP и API-токенами: они переехали из «Интеграций» в ИИ → MCP и токены, а планы, которые ждут владельца, — в ИИ → Ждут вас, со значком в меню. В Интеграциях остались алерты в Telegram.

В версии для Cloudflare#

Там ассистента пока нет, как и MCP и задач по расписанию: ИИ → Ассистент и ИИ → Задачи по расписанию об этом сообщают. Они появятся вместе с MCP.

Если он не отвечает#