Управление доступом. Ограничивающие категории (..._mute)

В этом руководстве мы разберем инструмент для управления доступом пользователей к нейросетям — ограничивающие категории. Это специальный функционал Puzzle AI, который позволяет вам включать или отключать доступ к конкретным AI-моделям для отдельных пользователей или групп.

Принцип очень прост: если пользователю назначена определенная категория (например, mj_mute), система Puzzle AI будет игнорировать все его запросы к соответствующей модели (в данном случае, к Midjourney). Это позволяет вам гибко управлять тем, кто и какими функциями может пользоваться в вашем боте.

Шаг 1. Как создать ограничивающую категорию

1. В конструкторе PuzzleBot перейдите в настройки вашего бота и откройте вкладку «Модерация».

2. Нажмите на иконку «плюс» (+) в правом верхнем углу, чтобы создать новую категорию.

3. Введите точное название категории.

Важно: Название должно строго соответствовать списку ниже

Шаг 2. Как назначить категорию пользователю

Назначить категорию можно множеством способов, в зависимости от логики работы вашего бота:

1. Вручную через диалоги в PuzzleBot

1. С помощью действия в команде. Например, в команде-ошибке textModels_error (из руководства по управлению балансом и лимитом пользователей) можно добавить действие «Добавить категорию» и указать gpt_mute.

1. При старте бота (/start) для всех новых пользователей. Например, если вы не используете конкретную модель в вашем боте.

1. Для монетизации вашего бота. Например, снимать ограничения после оплаты.

Практические кейсы и примеры использования

Вот несколько сценариев, как можно использовать ограничивающие категории:

Кейс 1. Блокировка при нулевом балансе (самый частый). Вы настраиваете команду-триггер ..._done для списания запросов. В условии, которое проверяет баланс, вы настраиваете правило: если баланс пользователя равен нулю, ему автоматически присваивается категория gpt_mute, и он больше не может использовать Gpt до пополнения баланса.

Кейс 2. Создание тарифных планов. Вы хотите сделать бесплатный и платный тарифы.

• Бесплатный тариф: При старте бота вы назначаете всем пользователям категории mj_mute, suno_mute, kling_mute, оставляя им доступ только к текстовому gpt_mute.

• Платный тариф: После того как пользователь оплачивает подписку, вы с помощью действия «Удалить категорию» снимаете с него все ограничения.

Кейс 3. Отключение неиспользуемой модели. Вы решили, что ваш бот не будет поддерживать генерацию музыки. Чтобы пользователи случайно не пытались её вызвать, вы можете при старте бота всем пользователям сразу присвоить категорию suno_mute.

Полный список ограничивающих категорий

Ниже представлен полный список официальных категорий и моделей, которые они блокируют.

Текстовые модели

---

Категория	Блокируемая модель / функция
gpt_mute	Все текстовые модели ChatGpt

Компьютерное зрение

---

Команда-триггер	Блокирует
vision_mute	Gpt Vision

Речевые модели

---

Команда-триггер	Блокирует
whisper_mute	Whisper

Фото модели

Команда-триггер	Блокирует
gpt_image_mute	Gpt image
nano_banana_mute	Nano banana
flux_2_mute	Все модели серии Flux 2
midjourney_mute	Midjourney fast

Видео модели

---

Команда-триггер	Блокирует
kling_mute	Kling
veo_mute	Veo quality
veo_fast_mute	Veo fast
higgsfield_video_mute	Higgsfield video
grok_video_mute	Grok video
sora_mute	Sora
sora_pro_mute	Sora pro

Музыкальные модели

---

Команда-триггер	Блокирует
suno_mute	Suno AI

Список всех моделей: https://puzzleai.gitbook.io/docs/pricing/spisok-ai-modelei-i-stoimost