> ## 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.

# Controllo del server con IA

> Un assistente AI che esegue l'amministrazione del server su richiesta, con controllo di accesso, risorse protette e restrizioni sugli strumenti. Tier Black.

<Info>
  **Solo tier Black.** Su qualsiasi tier inferiore la pagina è sostituita dalla vista dei piani.
</Info>

Menziona Vetox e descrivi l'attività in linguaggio semplice, in qualsiasi lingua. Pianifica il lavoro, lo esegue e riporta ciò che ha fatto — attraverso **182 azioni in 27 categorie**.

<Note>
  Due interruttori devono essere entrambi attivi: **AI Server Control** in [Server Setup](/it/server-management/setup), e le impostazioni in questa pagina.
</Note>

## Come gli parli

Menziona direttamente il bot. `@Vetox crea un canale #annunci in cui solo lo staff può scrivere`.

Tre cose **non** sono trigger: `@everyone` e `@here`, un ruolo che il bot possiede, e il ping automatico su una risposta.

<Tip>
  Una volta aperto un thread, continua a parlare in quel thread — non devi menzionarlo di nuovo. La conversazione resta attiva per **due ore**.
</Tip>

### Thread o risposta

| Modalità                 | Comportamento                                |
| ------------------------ | -------------------------------------------- |
| **Thread** (predefinito) | Apre un thread sul tuo messaggio e lavora lì |
| **Reply**                | Risponde direttamente nel canale             |

In modalità thread, **Private thread** è attivo di default, quindi la conversazione è visibile solo a te e allo staff con accesso. Se non può essere creato un thread privato, ricade su uno pubblico.

## Accesso — leggi questo prima di abilitare

<Warning>
  **L'accesso è negato-di-default.** Un membro che non è né Amministratore né esplicitamente consentito non può mai usare l'AI, indipendentemente da come sono impostati gli interruttori.
</Warning>

La scheda Accesso mostra un riepilogo "Effective access". Quando dice *"No restrictions set — anyone can use the AI"*, quella riga è fuorviante — il comportamento reale è comunque solo-Amministratore.

Due interruttori decidono chi può accedere:

| Richiedi Amministratore | L'allowlist bypassa Amministratore | Chi può usarla                                         |
| ----------------------- | ---------------------------------- | ------------------------------------------------------ |
| **On** (predefinito)    | **Off** (predefinito)              | Solo Amministratori. **Le allowlist non fanno nulla.** |
| On                      | On                                 | Amministratori, più chiunque sia in un'allowlist       |
| Off                     | l'uno o l'altro                    | Amministratori, più chiunque sia in un'allowlist       |

<Tip>
  Per far usare l'AI a un moderatore fidato senza dargli Amministratore, aggiungilo agli **Allowed users** e attiva **Allowlist bypasses Administrator**. Aggiungerlo solo alla lista non ha alcun effetto.
</Tip>

### Il permesso per-strumento è un secondo cancello

Poter *parlare* con l'AI non le concede i tuoi permessi Discord. Ogni azione ricontrolla anche il permesso corrispondente della persona che ha chiesto.

**Bypass roles** e **Bypass users** saltano quei controlli per-azione. Concedi questo con attenzione — permette a qualcuno di eseguire tramite l'AI azioni che non potrebbe eseguire da solo.

## Strumenti

27 categorie che coprono canali, ruoli, moderazione, messaggistica, thread, vocale, webhook, inviti, emoji, sticker, eventi, forum, onboarding, sondaggi, integrazioni, soundboard, template, il widget, la schermata di benvenuto, l'URL vanity e altro ancora.

Disattiva un'intera categoria e ogni azione al suo interno diventa non disponibile, anche se richiesta esplicitamente. Espandi una categoria per attivare le singole azioni.

<Note>
  L'interruttore della categoria vince. Con una categoria disattivata, i suoi interruttori individuali sono grigiati e irrilevanti. Riattivare la categoria ripristina qualsiasi stato per-azione tu avessi salvato.
</Note>

Le azioni che non possono essere annullate sono contrassegnate **Destructive**.

<Tip>
  Usa il campo di ricerca in alto — con 182 azioni, trovare "ban" o "webhook" è molto più veloce che scorrere.
</Tip>

### La conferma non è opzionale

Ogni azione distruttiva viene trattenuta in attesa della tua conferma prima di essere eseguita. Non c'è un'impostazione per disattivarla.

La scheda di conferma elenca esattamente cosa è in coda. Solo la persona che ha fatto la richiesta può confermarla, e scade dopo un'ora. Al momento della conferma, **ogni controllo di accesso viene rieseguito con la configurazione live** — quindi revocare l'accesso a qualcuno invalida anche le sue conferme in sospeso.

## Ambito

**Dove funziona l'AI** — tutti i canali, solo i canali selezionati, o tutti tranne quelli selezionati. I thread ereditano l'ambito del canale padre.

**Ruoli e canali protetti** — l'AI rifiuta qualsiasi azione che li interessi: nessuna modifica, cancellazione, clonazione, spostamento, assegnazione o pubblicazione.

<Warning>
  La protezione è assoluta. Un target protetto non può essere toccato **nemmeno con la conferma dell'admin**. Questo è il posto giusto per bloccare il tuo ruolo Admin, il canale delle regole e i canali di log.
</Warning>

<Tip>
  I canali protetti possono includere categorie, quindi proteggere una categoria protegge tutto ciò che vi è archiviato.
</Tip>

## Persona

Fino a 2.000 caratteri per impostare il tono e qualsiasi istruzione permanente — *"Sii conciso e formale. Conferma sempre prima di eliminare canali. Riferisciti allo staff come 'il team'."* Lascialo vuoto per un default neutro.

## Come appare un'esecuzione

<Steps>
  <Step title="Inizia a lavorare">
    Appare un indicatore di digitazione. Le domande semplici vengono risposte direttamente senza caricare tutto il set di strumenti.
  </Step>

  <Step title="Appare una scheda di avanzamento">
    Creata solo quando cambia effettivamente qualcosa — un semplice lookup non ne mostra mai una. Ogni azione aggiunge una riga: ✅ fatto, ❌ fallito con il motivo, ⏳ in attesa di conferma.
  </Step>

  <Step title="Conferma, se necessaria">
    Le azioni distruttive fanno emergere la scheda di conferma. Nulla al suo interno è stato ancora eseguito.
  </Step>

  <Step title="Ti fa il report">
    Un riepilogo verde di cosa è cambiato, o una risposta semplice se hai solo fatto una domanda.
  </Step>
</Steps>

<Note>
  Una singola richiesta esegue fino a **8 passaggi** entro un budget di **90 secondi**. Richieste molto grandi potrebbero fermarsi in anticipo e comunicarlo — dividile in più piccole.
</Note>

## Rate limit e concorrenza

* Circa **una richiesta ogni 5 secondi** per persona, con una piccola tolleranza di burst
* **Una richiesta alla volta** per persona
* **Quattro alla volta** in tutto il server

Raggiungere il limite per-persona o per-server produce un breve avviso "sto ancora lavorando / riprova tra un momento", al massimo una volta ogni 20 secondi.

## Budget

Un'esecuzione richiede almeno **30.000 token** in riserva. Sotto quella soglia declina con un messaggio di budget esaurito invece che iniziare un lavoro che non potrebbe finire.

<Card title="AI Usage" icon="chart-line" horizontal href="/it/moderation/ai-usage">
  Traccia la spesa, vedi quali azioni sono state eseguite e ricarica.
</Card>

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Il bot mi ignora completamente">
    Il silenzio è la risposta normale a ogni fallimento di accesso — non c'è un messaggio di errore, per progetto. Controlla in ordine:

    1. Hai **menzionato direttamente il bot**? Un ping del ruolo o un ping da risposta non è un trigger.
    2. **AI Server Control** è attivo in Server Setup?
    3. Il canale è nell'ambito?
    4. Sei un Amministratore, o in un'allowlist **con Allowlist bypasses Administrator attivo**?
    5. Hai inviato diverse richieste di fila? Aspetta qualche secondo.
  </Accordion>

  <Accordion title="Ho aggiunto qualcuno agli Allowed users e non è cambiato nulla">
    Previsto. Con i valori predefiniti, le allowlist sono inerti. Attiva **Allowlist bypasses Administrator**, oppure disattiva **Require Administrator**.
  </Accordion>

  <Accordion title="Rifiuta un'azione per cui ha chiaramente uno strumento">
    O la categoria dello strumento è disattivata nella scheda Tools, oppure il target è nella tua lista di ruoli o canali protetti, oppure chi richiede non ha il permesso Discord sottostante per quell'azione.
  </Accordion>

  <Accordion title="Si è fermato a metà di un grande lavoro">
    Otto passaggi e novanta secondi per richiesta. Dividi il lavoro — "crea questi cinque canali" poi "ora imposta i permessi su di essi".
  </Accordion>

  <Accordion title="Dice che il budget è esaurito">
    Sotto 30.000 token non partirà. Ricarica nella pagina AI Usage o aspetta il grant mensile.
  </Accordion>

  <Accordion title="Una conferma è scaduta">
    Le conferme durano un'ora. Chiedi di nuovo.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="AI Auto-Moderation" icon="sparkles" href="/it/moderation/ai-auto-mod">
    Moderazione dei contenuti consapevole del contesto.
  </Card>

  <Card title="Access Control" icon="key" href="/it/server-management/dashboard-permissions">
    Chi può cambiare cosa sulla dashboard.
  </Card>
</CardGroup>