> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ИИ-управление сервером

> AI-ассистент, выполняющий администрирование сервера по запросу, с управлением доступом, защищёнными ресурсами и ограничениями по инструментам. Тариф Black.

<Info>
  **Только Black-тариф.** На любом более низком тарифе страница заменяется представлением тарифов.
</Info>

Упомяните Vetox и опишите задачу простым языком на любом языке. Он планирует работу, выполняет её и отчитывается о сделанном — по **182 действиям в 27 категориях**.

<Note>
  Должны быть включены оба переключателя: **AI Server Control** в [Настройке сервера](/ru/server-management/setup) и настройки на этой странице.
</Note>

## Как с ним разговаривать

Упомяните бота напрямую. `@Vetox create a #announcements channel that only staff can post in`.

Три вещи **не** являются триггером: `@everyone` и `@here`, роль, которую бот случайно имеет, и автоматический пинг при ответе.

<Tip>
  Как только он открыл ветку, продолжайте в ней — заново упоминать его не нужно. Разговор остаётся живым **два часа**.
</Tip>

### Ветка или ответ

| Режим                     | Поведение                                         |
| ------------------------- | ------------------------------------------------- |
| **Thread** (по умолчанию) | Открывает ветку на вашем сообщении и работает там |
| **Reply**                 | Отвечает напрямую в канале                        |

В режиме thread по умолчанию включён **Private thread**, так что разговор видят только вы и персонал с доступом. Если частную ветку создать не удаётся, происходит откат к публичной.

## Доступ — прочитайте до включения

<Warning>
  **Доступ — deny-by-default.** Участник, не являющийся Administrator и не разрешённый явно, никогда не сможет использовать AI, как бы ни были выставлены переключатели.
</Warning>

Вкладка Access показывает сводку «Effective access». Когда там написано *«No restrictions set — anyone can use the AI»*, эта строка вводит в заблуждение — реальное поведение всё равно «только Administrator».

Два переключателя решают, кто попадёт внутрь:

| Require Administrator  | Allowlist bypasses Administrator | Кто может использовать                              |
| ---------------------- | -------------------------------- | --------------------------------------------------- |
| **Вкл** (по умолчанию) | **Выкл** (по умолчанию)          | Только Administrator. **Allowlist ничего не даёт.** |
| Вкл                    | Вкл                              | Administrator и все из allowlist                    |
| Выкл                   | любой                            | Administrator и все из allowlist                    |

<Tip>
  Чтобы разрешить доверенному модератору использовать AI без Administrator, добавьте его в **Allowed users** и включите **Allowlist bypasses Administrator**. Добавление в список без этого ничего не даёт.
</Tip>

### Разрешение на инструмент — второй барьер

Право *разговаривать* с AI не даёт ему ваших разрешений Discord. Каждое действие также заново проверяет соответствующее разрешение у того, кто попросил.

**Bypass roles** и **Bypass users** пропускают эти per-action проверки. Выдавайте это осторожно — это позволяет кому-то выполнять через AI действия, которые он сам выполнить не смог бы.

## Инструменты

27 категорий, охватывающих каналы, роли, модерацию, сообщения, ветки, голос, вебхуки, инвайты, эмодзи, стикеры, ивенты, форумы, онбординг, опросы, интеграции, soundboard, шаблоны, виджет, экран приветствия, vanity URL и другое.

Отключите категорию целиком — и любое действие в ней становится недоступным, даже если о нём прямо просят. Раскройте категорию, чтобы включать отдельные действия.

<Note>
  Переключатель категории главный. При выключенной категории её отдельные переключатели затенены и не имеют значения. Включение категории обратно восстанавливает сохранённое состояние per-action.
</Note>

Необратимые действия помечены **Destructive**.

<Tip>
  Используйте поле поиска сверху — среди 182 действий найти «ban» или «webhook» гораздо быстрее, чем скроллить.
</Tip>

### Подтверждение не опционально

Каждое destructive-действие удерживается до подтверждения. Настройки отключить это нет.

Карточка подтверждения перечисляет ровно то, что в очереди. Подтвердить может только тот, кто сделал запрос, и она истекает через час. При подтверждении **все проверки доступа заново прогоняются по актуальной конфигурации** — так что отзыв доступа у кого-то также аннулирует его ожидающие подтверждения.

## Область

**Где работает AI** — все каналы, только выбранные или все, кроме выбранных. Ветки наследуют область родительского канала.

**Protected roles and channels** — AI отказывается от любого действия, направленного на них: не редактирует, не удаляет, не клонирует, не перемещает, не назначает и не публикует.

<Warning>
  Защита абсолютна. Защищённую цель нельзя тронуть **даже с админским подтверждением**. Это правильное место, чтобы закрыть роль Admin, канал правил и лог-каналы.
</Warning>

<Tip>
  В защищённые каналы можно включать категории, поэтому защита одной категории защищает всё, что в ней.
</Tip>

## Персона

До 2000 символов, задающих тон и постоянные инструкции — *«Be concise and formal. Always confirm before deleting channels. Refer to staff as the team.»* Оставьте пустым для нейтральных значений по умолчанию.

## Как выглядит запуск

<Steps>
  <Step title="Он начинает работать">
    Появляется индикатор набора. Простые вопросы отвечаются напрямую, без загрузки полного набора инструментов.
  </Step>

  <Step title="Появляется карточка прогресса">
    Создаётся только когда что-то реально меняется — чистый лукап её не показывает. Каждое действие добавляет строку: ✅ готово, ❌ ошибка с причиной, ⏳ ждёт подтверждения.
  </Step>

  <Step title="Подтверждение, если нужно">
    Destructive-действия выводят карточку подтверждения. Ничего из неё ещё не выполнено.
  </Step>

  <Step title="Он отчитывается">
    Зелёная сводка того, что изменилось, или обычный ответ, если вы только задавали вопрос.
  </Step>
</Steps>

<Note>
  Один запрос выполняет до **8 шагов** в **90-секундном** бюджете. Очень большие запросы могут остановиться раньше и сообщить об этом — разбивайте их на меньшие.
</Note>

## Rate limit и параллелизм

* Примерно **один запрос каждые 5 секунд** на человека, с небольшим burst-запасом
* **Один запрос за раз** на человека
* **Четыре за раз** на весь сервер

Достижение лимита на человека или на сервер выводит короткое уведомление «still working / try again in a moment» не чаще раза в 20 секунд.

## Бюджет

Для запуска нужно минимум **30 000 токенов** в резерве. Ниже он отклоняет запрос с сообщением о нехватке бюджета, а не начинает работу, которую не сможет закончить.

<Card title="AI Usage" icon="chart-line" horizontal href="/ru/moderation/ai-usage">
  Отслеживайте расход, смотрите, какие действия запускались, и пополняйте.
</Card>

## Решение проблем

<AccordionGroup>
  <Accordion title="Бот меня полностью игнорирует">
    Молчание — нормальный ответ на каждый провал доступа: сообщения об ошибке нет по замыслу. Проверьте по порядку:

    1. Вы **упомянули бота напрямую**? Пинг роли или ответ — не триггер.
    2. **AI Server Control** включён в Настройке сервера?
    3. Канал в области?
    4. Вы Administrator или в allowlist **с включённым Allowlist bypasses Administrator**?
    5. Вы отправили несколько запросов подряд? Подождите пару секунд.
  </Accordion>

  <Accordion title="Добавил в Allowed users, и ничего не изменилось">
    Ожидаемо. При настройках по умолчанию allowlist пассивен. Включите **Allowlist bypasses Administrator** или отключите **Require Administrator**.
  </Accordion>

  <Accordion title="Отказывается выполнить действие, для которого явно есть инструмент">
    Либо категория инструмента выключена во вкладке Tools, либо цель в списке protected roles или channels, либо у запросившего нет соответствующего разрешения Discord.
  </Accordion>

  <Accordion title="Остановился посреди большой задачи">
    Восемь шагов и девяносто секунд на запрос. Разделяйте работу — «создай пять каналов», затем «теперь настрой на них разрешения».
  </Accordion>

  <Accordion title="Говорит, что бюджет исчерпан">
    Ниже 30 000 токенов он не запустится. Пополните на странице AI Usage или дождитесь ежемесячного лимита.
  </Accordion>

  <Accordion title="Подтверждение истекло">
    Подтверждения живут час. Спросите заново.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="AI Auto-Moderation" icon="sparkles" href="/ru/moderation/ai-auto-mod">
    Контекстно-осознанная модерация содержимого.
  </Card>

  <Card title="Управление доступом" icon="key" href="/ru/server-management/dashboard-permissions">
    Кто и что может менять в панели.
  </Card>
</CardGroup>
