> ## 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** у [налаштуванні сервера](/uk/server-management/setup) і налаштування на цій сторінці.
</Note>

## Як до нього звертатися

Згадайте бота напряму. `@Vetox створи канал #announcements, де писати може лише персонал`.

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

<Tip>
  Коли він відкрив тред — далі пишіть у тому треді, повторно згадувати не треба. Розмова живе **дві години**.
</Tip>

### Thread чи Reply

| Режим                         | Поведінка                                        |
| ----------------------------- | ------------------------------------------------ |
| **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>

### Per-tool permission — другий рівень

Дозвіл *говорити* з AI не наділяє його вашими правами Discord. Кожна дія додатково перевіряє відповідне право самого прохача.

**Bypass roles** і **Bypass users** оминають ці перевірки за діями. Роздавайте обережно — це дозволяє людині виконати через AI дії, яких вона сама виконати не змогла б.

## Інструменти

27 категорій — канали, ролі, модерація, повідомлення, треди, голос, вебхуки, інвайти, емодзі, стікери, події, форуми, onboarding, опитування, інтеграції, soundboard, шаблони, віджет, welcome screen, vanity URL тощо.

Вимкніть цілу категорію — і всі дії всередині стануть недоступними, навіть на прямий запит. Розгорніть категорію, щоб керувати окремими діями.

<Note>
  Категорія перекриває окремі перемикачі. Коли категорія вимкнена, її внутрішні перемикачі неактивні й не мають значення. Повторне ввімкнення категорії відновлює той стан по діях, який ви зберігали.
</Note>

Незворотні дії позначені як **Destructive**.

<Tip>
  Використовуйте пошук угорі — з 182 діями знайти «ban» чи «webhook» значно швидше, ніж гортати.
</Tip>

### Підтвердження — не опційне

Кожна destructive-дія чекає вашого підтвердження перед виконанням. Налаштування, щоб це вимкнути, немає.

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

## Область дії

**Де AI працює** — усі канали, лише вибрані або всі, крім вибраних. Треди успадковують область батьківського каналу.

**Захищені ролі та канали** — AI відмовляється діяти проти них: не редагує, не видаляє, не клонує, не рухає, не призначає, не публікує в них.

<Warning>
  Захист абсолютний. Захищену ціль не можна чіпати **навіть із адмінським підтвердженням**. Це правильне місце, щоб заблокувати роль Admin, канал правил і log-канали.
</Warning>

<Tip>
  Захищені канали можуть включати категорії — захистивши категорію, ви захистите все, що в ній.
</Tip>

## Персона

До 2000 символів, які задають тон і сталі інструкції — *«Будь стислим і формальним. Завжди підтверджуй перед видаленням каналів. До staff звертайся як до команди.»* Залиште порожнім для нейтрального дефолту.

## Як виглядає виконання

<Steps>
  <Step title="Він починає працювати">
    З'являється індикатор «набирає». На прості запитання відповідає одразу, без завантаження повного тулсету.
  </Step>

  <Step title="З'являється прогрес-картка">
    Створюється лише коли щось справді змінюється — чистий lookup її не показує. Кожна дія додає рядок: ✅ виконано, ❌ невдало з причиною, ⏳ чекає підтвердження.
  </Step>

  <Step title="Підтвердження, якщо потрібно">
    Destructive-дії викликають картку підтвердження. Ніщо в ній ще не виконане.
  </Step>

  <Step title="Він звітує">
    Зелене зведення про зміни — або звичайна відповідь, якщо ви лише запитували.
  </Step>
</Steps>

<Note>
  Один запит виконує до **8 кроків** у межах **90 секунд**. Дуже великі запити можуть завершитися раніше з повідомленням — розбивайте на менші.
</Note>

## Ліміти та паралельність

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

Досягнення ліміту дає коротке повідомлення «ще працюю / спробуйте за мить», не частіше ніж раз на 20 секунд.

## Бюджет

Для запуску потрібно мінімум **30 000 токенів** у запасі. Нижче цього рівня він відмовляється з повідомленням про вичерпаний бюджет, а не починає роботу, яку не зможе завершити.

<Card title="AI Usage" icon="chart-line" horizontal href="/uk/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, а нічого не змінилось">
    Так і має бути. З дефолтами allowlists неактивні. Увімкніть **Allowlist bypasses Administrator** або вимкніть **Require Administrator**.
  </Accordion>

  <Accordion title="Він відмовляється від дії, для якої явно є інструмент">
    Або категорія інструмента вимкнена на вкладці Tools, або ціль у списку захищених ролей чи каналів, або в прохача бракує відповідного права 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="/uk/moderation/ai-auto-mod">
    Контекстно-свідома модерація вмісту.
  </Card>

  <Card title="Access Control" icon="key" href="/uk/server-management/dashboard-permissions">
    Хто що може змінювати на панелі.
  </Card>
</CardGroup>
