ИИ-ассистент — встроенный в панель и подключение Claude к вашей панели

Nimbopanel даёт вам два способа пользоваться ИИ. Оба выключены, пока вы их не включите, и в обоих ассистент видит только то, что разрешено видеть человеку, который им пользуется.

Встроенный ассистент

Люди задают вопросы на своём языке — «почему не приходит почта?», «сколько осталось места на диске?» — а ассистент читает данные панели, чтобы ответить.

Как включить (администратор):

1. Откройте Система → Безопасность → ИИ-ассистент в панели.
2. Выберите ИИ-провайдера (см. список ниже). Ссылка рядом с выбором ведёт туда, где этот провайдер выдаёт ключи.
3. Вставьте свой API-ключ этого провайдера. Он сохраняется на вашем сервере в файле, доступном только root, и больше никогда не показывается — ни вам, ни кому-либо ещё. При смене провайдера ключ прежнего провайдера не переносится.
4. Выберите Модель. В списке есть несколько распространённых названий для этого провайдера, а можно ввести любое название модели в точности так, как его указывает провайдер.
5. Выберите, Кто может пользоваться: администраторы, реселлеры, клиенты, пользователи команды.
6. Задайте ограничения: Вопросов на человека в день и Месячный бюджет (токены) на весь сервер. Когда бюджет исчерпан, ассистент приостанавливается до следующего месяца.
7. Отметьте Включить ассистента и сохраните.

Доступные провайдеры. Десять перечислены по названию, плюс два варианта для любого другого адреса:

Для двух вариантов Другой вы вводите API-адрес провайдера самостоятельно, так, как он указан в его документации. Адрес должен начинаться с https://. Простой http:// принимается только для этого сервера или частной сети (модельный сервер, который вы запускаете сами). Адреса с именем пользователя, строкой запроса или фрагментом, а также адреса из диапазона метаданных облака отклоняются.

Честное ограничение. Ассистент проверен на имитации провайдера, которая ведёт себя как каждый из протоколов. На реальном сервисе каждого поставщика он пока не тестировался, поэтому после включения и до того, как вы расскажете о нём клиентам, задайте ему один-два вопроса. Названия моделей меняются часто; если провайдер отвечает, что не знает модель, введите актуальное название.

Как выбрать провайдера ИИ и не раздувать счёт

• Вы платите провайдеру по факту использования — Расходы растут вместе с числом вопросов и длиной ответов. Цены часто меняются, поэтому перед решением откройте страницу цен провайдера, а в его собственной консоли ещё и задайте лимит расходов. Nimbopanel ничего не добавляет к счёту.
• Какого провайдера выбрать? — Для хороших ответов с минимумом усилий выберите облачного провайдера, например Anthropic, OpenAI или Google. Для одного ключа ко многим моделям — OpenRouter. Чтобы каждый вопрос оставался на вашем сервере, запустите там Ollama: платы за вопрос нет, но нужно достаточно памяти, а небольшие модели отвечают хуже. Провайдера можно сменить позже.
• Начните с малого — Оставьте начальные лимиты (30 вопросов на человека в день, 2 000 000 токенов в месяц на весь сервер) и сначала разрешите пользоваться только администраторам. 0 означает «без ограничений» — оставьте это на потом.
• Решите, что ИИ может читать — Отметьте «Не передавать заявки в поддержку сервису ИИ», если не хотите, чтобы сообщения клиентов отправлялись провайдеру. Каждый человек видит уведомление о конфиденциальности до своего первого вопроса.
• Попробуйте, прежде чем говорить клиентам — Задайте несколько вопросов в тестовой учётной записи и попробуйте одно предложенное изменение: при одобрении запрашивается пароль того, кто одобряет.

Что он может и чего не может

• Он читает с правами того человека, который спрашивает: ассистент клиента видит аккаунт этого клиента и больше ничего; ассистент реселлера сохраняет привилегии реселлера.
• Он не может ничего изменить сам. Для нескольких изменений (добавить или удалить DNS-запись, приостановить аккаунт или вернуть его в работу) он готовит карточку под своим ответом. Карточку составляет панель — а не ИИ, — и в ней точно сказано, что произойдёт. Ничего не происходит, пока человек не нажмёт Одобрить…, а затем Да, выполнить сейчас. Можно также нажать Отклонить. Поскольку изменение запросил ассистент, панель сначала просит подтвердить, что это вы, паролем (и кодом подтверждения, если вы используете двухэтапный вход); после этого несколько минут она не спрашивает снова.
• Если перед тем как что-то предложить, ассистент читал сообщения, написанные другими людьми (например, обращения в поддержку), карточка сообщает об этом. Одобряйте только то, о чём вы действительно просили.
• Запросы ждут 30 минут, после чего истекают. Выключение ассистента отменяет все открытые предложения.
• Он недоступен через API-токен и во вкладке «Войти как» — только в собственном сеансе человека.

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

Подключение ИИ-ассистента (MCP)

Это позволяет человеку пользоваться собственным ассистентом (например, Claude) вместе с панелью через Model Context Protocol.

1. Администратор: откройте Система → Безопасность → Подключение ИИ-ассистента (MCP), отметьте Разрешить подключение ИИ-ассистентов, выберите, каким ролям можно подключаться, и сохраните.

2. Человек (администратор, реселлер, клиент или пользователь команды) открывает Токены API → Подключить ИИ-ассистента (Claude и другие). Для каждого раздела панели выберите Нет доступа, Чтение или Чтение и изменение — выберите Чтение, если ассистент должен только смотреть, — а затем нажмите Создать токен ассистента. Токен перестаёт работать через 90 дней, если вы не укажете другое число в поле Перестаёт работать через (дней).

3. Панель показывает команду, которую нужно вставить. Для Claude Code:

   claude mcp add --transport http nimbopanel https://panel.yourdomain.com/mcp --header "Authorization: Bearer <token>"
   

   Другие MCP-клиенты используют тот же адрес с токеном в заголовке Authorization: Bearer.

Что может подключённый ассистент: читать разделы, указанные в его токене; добавлять адресную или текстовую запись для нового обычного имени. Всё остальное — удаление записи, приостановка аккаунта или возврат его в работу, почтовые записи, сам домен, записи CNAME/SRV/CAA, wildcard-записи и имена, которые ищут почтовые программы (autodiscover, autoconfig, mail, …), — становится запросом. Владелец токена видит его в разделе Токены API → Запросы ассистента и одобряет или отклоняет. Ассистент никогда не может одобрить собственный запрос.

Пока не поддерживается: клиенты, которые умеют подключаться только через вход по OAuth (точка подключения принимает токен в заголовке). Отозвать токен можно в любой момент в разделе Токены API; его открытые запросы при этом отменяются.

Полезные привычки

• Давайте каждому токену ассистента только те разделы, которые ему нужны, и предпочитайте Чтение вместо Чтение и изменение.
• Читайте каждую карточку одобрения. Что произойдёт, говорит карточка, а не сообщение ассистента.
• Не снимайте дневной лимит вопросов и месячный бюджет; расход за этот месяц можно посмотреть на той же карточке.