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

# Controle de Servidor por IA

> Um assistente de IA que executa a administração do servidor sob demanda, com controle de acesso, recursos protegidos e restrições de ferramentas. Tier Black.

<Info>
  **Apenas tier Black.** Em qualquer tier inferior a página é substituída pela visão de planos.
</Info>

Mencione o Vetox e descreva a tarefa em linguagem comum, em qualquer idioma. Ele planeja o trabalho, executa e relata o que fez — em **182 ações em 27 categorias**.

<Note>
  Dois interruptores precisam estar ligados: **AI Server Control** em [Server Setup](/pt/server-management/setup) e as configurações desta página.
</Note>

## Como você conversa com ele

Mencione o bot diretamente. `@Vetox crie um canal #anúncios em que só a staff pode postar`.

Três coisas **não** são gatilhos: `@everyone` e `@here`, um cargo que por acaso o bot tem e o ping automático de uma resposta.

<Tip>
  Depois que ele abre uma thread, continue conversando na thread — não precisa mencionar de novo. A conversa fica ativa por **duas horas**.
</Tip>

### Thread ou reply

| Modo                | Comportamento                                 |
| ------------------- | --------------------------------------------- |
| **Thread** (padrão) | Abre uma thread na sua mensagem e trabalha lá |
| **Reply**           | Responde diretamente no canal                 |

Em modo thread, **Private thread** vem ligado por padrão, então a conversa é visível apenas para você e para a staff com acesso. Se uma thread privada não pode ser criada, ele cai para uma pública.

## Acesso — leia isto antes de habilitar

<Warning>
  **O acesso é negar por padrão.** Um membro que não é Administrator nem está explicitamente autorizado nunca consegue usar a IA, não importa como os interruptores estão.
</Warning>

A aba Access mostra um resumo "Effective access". Quando ele diz *"No restrictions set — anyone can use the AI"*, essa linha é enganosa — o comportamento real continua sendo apenas Administrator.

Dois interruptores decidem quem entra:

| Require Administrator | Allowlist bypasses Administrator | Quem pode usar                                           |
| --------------------- | -------------------------------- | -------------------------------------------------------- |
| **Ligado** (padrão)   | **Desligado** (padrão)           | Apenas Administrators. **As allowlists não fazem nada.** |
| Ligado                | Ligado                           | Administrators, mais quem estiver em uma allowlist       |
| Desligado             | qualquer                         | Administrators, mais quem estiver em uma allowlist       |

<Tip>
  Para deixar um moderador confiável usar a IA sem dar Administrator, adicione-o em **Allowed users** e ligue **Allowlist bypasses Administrator**. Só adicionar à lista não tem efeito.
</Tip>

### Permissão por ferramenta é uma segunda barreira

Estar autorizado a *falar* com a IA não concede a ela suas permissões do Discord. Toda ação também revisa a permissão correspondente da pessoa que pediu.

**Bypass roles** e **Bypass users** pulam essas checagens por ação. Conceda com cuidado — permite alguém executar ações via IA que essa pessoa não conseguiria executar sozinha.

## Ferramentas

27 categorias cobrindo canais, cargos, moderação, mensagens, threads, voz, webhooks, convites, emojis, adesivos, eventos, fóruns, onboarding, enquetes, integrações, soundboard, templates, o widget, a tela de boas-vindas, a vanity URL e mais.

Desligue uma categoria inteira e toda ação dentro dela fica indisponível, mesmo se pedida explicitamente. Expanda uma categoria para alternar ações individuais.

<Note>
  O interruptor da categoria vence. Com a categoria desligada, seus interruptores individuais ficam apagados e irrelevantes. Ligar a categoria de volta restaura o estado por ação que estava salvo.
</Note>

Ações que não podem ser desfeitas são marcadas como **Destructive**.

<Tip>
  Use a caixa de busca no topo — com 182 ações, achar "ban" ou "webhook" é muito mais rápido do que rolar.
</Tip>

### Confirmação não é opcional

Toda ação destrutiva fica retida esperando sua confirmação antes de rodar. Não há configuração para desabilitar isso.

O card de confirmação lista exatamente o que está na fila. Apenas quem fez o pedido pode confirmar, e ele expira após uma hora. Na confirmação, **toda verificação de acesso é rodada de novo contra a configuração ao vivo** — então revogar o acesso de alguém invalida também as confirmações pendentes dessa pessoa.

## Escopo

**Onde a IA trabalha** — todos os canais, apenas selecionados ou todos exceto os selecionados. Threads herdam o escopo do canal pai.

**Cargos e canais protegidos** — a IA recusa qualquer ação que atinja estes: não edita, não deleta, não clona, não move, não atribui e não posta.

<Warning>
  A proteção é absoluta. Um alvo protegido não pode ser tocado **nem com confirmação de admin**. É aqui que se protege seu cargo de Admin, seu canal de regras e seus canais de log.
</Warning>

<Tip>
  Canais protegidos podem incluir categorias, então proteger uma categoria protege tudo que está dentro dela.
</Tip>

## Persona

Até 2.000 caracteres definindo o tom e quaisquer instruções permanentes — *"Seja conciso e formal. Sempre confirme antes de deletar canais. Refira-se à staff como time."* Deixe em branco para um padrão neutro.

## Como se parece uma execução

<Steps>
  <Step title="Ele começa a trabalhar">
    Um indicador de digitação aparece. Perguntas simples são respondidas diretamente sem carregar todo o conjunto de ferramentas.
  </Step>

  <Step title="Um card de progresso aparece">
    Criado apenas quando algo é realmente alterado — uma consulta pura nunca mostra um. Cada ação adiciona uma linha: ✅ feito, ❌ falhou com o motivo, ⏳ aguardando confirmação.
  </Step>

  <Step title="Confirmação, se necessária">
    Ações destrutivas apresentam o card de confirmação. Nada nele foi executado ainda.
  </Step>

  <Step title="Ele relata">
    Um resumo verde do que mudou, ou uma resposta em texto se você só fez uma pergunta.
  </Step>
</Steps>

<Note>
  Uma única solicitação executa até **8 etapas** dentro de um orçamento de **90 segundos**. Solicitações muito grandes podem parar cedo e avisar — quebre em menores.
</Note>

## Limites de taxa e concorrência

* Aproximadamente **uma solicitação a cada 5 segundos** por pessoa, com uma pequena tolerância de rajada
* **Uma solicitação por vez** por pessoa
* **Quatro por vez** no servidor inteiro

Bater no limite por pessoa ou por servidor gera um aviso curto "ainda trabalhando / tente em um instante", no máximo uma vez a cada 20 segundos.

## Orçamento

Uma execução precisa de pelo menos **30.000 tokens** em reserva. Abaixo disso ela recusa com uma mensagem de orçamento esgotado em vez de começar um trabalho que não termina.

<Card title="AI Usage" icon="chart-line" horizontal href="/pt/moderation/ai-usage">
  Acompanhe o gasto, veja quais ações rodaram e recarregue.
</Card>

## Solução de problemas

<AccordionGroup>
  <Accordion title="O bot me ignora completamente">
    Silêncio é a resposta normal a toda falha de acesso — por design, não há mensagem de erro. Verifique na ordem:

    1. Você **mencionou o bot diretamente**? Ping de cargo ou de reply não é gatilho.
    2. **AI Server Control** está ligado em Server Setup?
    3. O canal está no escopo?
    4. Você é Administrator, ou está em uma allowlist **com Allowlist bypasses Administrator ligado**?
    5. Enviou várias solicitações seguidas? Espere alguns segundos.
  </Accordion>

  <Accordion title="Adicionei alguém em Allowed users e nada mudou">
    Esperado. Nos padrões, as allowlists são inertes. Ligue **Allowlist bypasses Administrator**, ou desligue **Require Administrator**.
  </Accordion>

  <Accordion title="Ele recusa uma ação para a qual tem ferramenta">
    Ou a categoria dela está desligada na aba Tools, ou o alvo está nas suas listas de cargos ou canais protegidos, ou quem pediu não tem a permissão subjacente do Discord para aquela ação.
  </Accordion>

  <Accordion title="Ele parou no meio de um trabalho grande">
    Oito etapas e noventa segundos por solicitação. Divida o trabalho — "crie estes cinco canais" e depois "agora defina permissões neles".
  </Accordion>

  <Accordion title="Ele diz que o orçamento acabou">
    Abaixo de 30.000 tokens ele não começa. Recarregue na página AI Usage ou aguarde a concessão mensal.
  </Accordion>

  <Accordion title="Uma confirmação expirou">
    As confirmações duram uma hora. Peça de novo.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="AI Auto-Moderation" icon="sparkles" href="/pt/moderation/ai-auto-mod">
    Moderação de conteúdo consciente de contexto.
  </Card>

  <Card title="Controle de acesso" icon="key" href="/pt/server-management/dashboard-permissions">
    Quem pode mudar o quê no painel.
  </Card>
</CardGroup>
