> ## 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 서버 컨트롤

> 요청에 따라 서버 관리 작업을 수행하는 AI 어시스턴트, 접근 제어, 보호 리소스, 도구 제한 포함. Black 등급.

<Info>
  **Black 등급 전용.** 하위 등급에서는 페이지가 플랜 뷰로 대체됩니다.
</Info>

Vetox를 멘션하고 자연스러운 언어로 어떤 언어로든 작업을 설명하세요. 봇이 계획을 세우고, 실행하며, 수행한 것을 보고합니다 — **27개 카테고리, 182개 동작**을 지원합니다.

<Note>
  두 스위치가 모두 켜져 있어야 합니다: [서버 설정](/ko/server-management/setup)의 **AI Server Control**과 이 페이지의 설정.
</Note>

## 대화하는 방법

봇을 직접 멘션합니다. `@Vetox 스태프만 게시할 수 있는 #announcements 채널을 만들어줘`.

세 가지는 트리거가 **아닙니다**: `@everyone`과 `@here`, 봇이 우연히 보유한 역할, 답장 시 자동 핑.

<Tip>
  스레드가 열린 후에는 그 스레드에서 계속 대화하세요 — 다시 멘션할 필요가 없습니다. 대화는 **2시간** 동안 유지됩니다.
</Tip>

### 스레드 또는 답장

| 모드             | 동작                    |
| -------------- | --------------------- |
| **Thread**(기본) | 메시지에 스레드를 열어 그 안에서 작업 |
| **Reply**      | 채널에 직접 답장             |

스레드 모드에서 **Private thread**는 기본 켜짐이므로 대화는 본인과 접근 권한이 있는 스태프에게만 표시됩니다. 비공개 스레드를 만들 수 없으면 공개 스레드로 폴백됩니다.

## 접근 — 활성화 전에 반드시 읽으세요

<Warning>
  **접근은 기본 거부입니다.** Administrator도 아니고 명시적으로 허용되지도 않은 멤버는 스위치 설정과 관계없이 AI를 사용할 수 없습니다.
</Warning>

Access 탭에 "Effective access" 요약이 표시됩니다. \_"No restrictions set — anyone can use the AI"\_라고 표시될 때 그 문장은 오해의 소지가 있습니다 — 실제 동작은 여전히 Administrator 전용입니다.

두 스위치가 접근을 결정합니다:

| Require Administrator | Allowlist bypasses Administrator | 사용 가능 대상                                   |
| --------------------- | -------------------------------- | ------------------------------------------ |
| **On**(기본)            | **Off**(기본)                      | Administrator만. **허용 목록은 아무 역할을 하지 않습니다.** |
| On                    | On                               | Administrator와 허용 목록의 모든 사람                |
| Off                   | 어느 쪽이든                           | Administrator와 허용 목록의 모든 사람                |

<Tip>
  신뢰받는 조정자가 Administrator 없이 AI를 사용하게 하려면 **Allowed users**에 추가하고 **Allowlist bypasses Administrator**를 켜세요. 목록에만 추가하는 것은 효과가 없습니다.
</Tip>

### 도구별 권한이 두 번째 관문입니다

AI와 \_대화\_할 수 있다는 것이 Discord 권한을 부여하지는 않습니다. 모든 동작은 요청자에 대해 상응하는 권한도 재검사합니다.

**Bypass roles**와 **Bypass users**는 도구별 검사를 건너뜁니다. 신중하게 부여하세요 — 이는 사용자가 스스로 수행할 수 없는 동작을 AI를 통해 수행하게 해줍니다.

## 도구

채널, 역할, 조정, 메시징, 스레드, 음성, 웹훅, 초대, 이모지, 스티커, 이벤트, 포럼, 온보딩, 투표, 통합, 사운드보드, 템플릿, 위젯, 환영 화면, vanity URL 등 27개 카테고리를 포함합니다.

카테고리 전체를 끄면 그 안의 모든 동작이 명시적으로 요청되어도 사용할 수 없게 됩니다. 카테고리를 확장해 개별 동작을 전환할 수 있습니다.

<Note>
  카테고리 스위치가 우선합니다. 카테고리가 꺼져 있으면 그 안의 개별 스위치는 회색으로 표시되며 무의미해집니다. 카테고리를 다시 켜면 저장했던 동작별 상태가 복원됩니다.
</Note>

되돌릴 수 없는 동작에는 **Destructive** 표시가 있습니다.

<Tip>
  상단 검색창을 사용하세요 — 182개 동작 중에서 "ban"이나 "webhook"을 찾는 데 스크롤보다 훨씬 빠릅니다.
</Tip>

### 확인은 선택 사항이 아닙니다

모든 파괴적인 동작은 실행 전에 확인을 위해 보류됩니다. 이를 비활성화하는 설정은 없습니다.

확인 카드는 대기 중인 항목을 정확히 나열합니다. 요청한 사람만 확인할 수 있으며 1시간 후 만료됩니다. 확인 시점에 **모든 접근 검사가 실시간 구성으로 재실행됩니다** — 따라서 누군가의 접근을 취소하면 그의 대기 중 확인도 무효화됩니다.

## 범위

**AI가 작동하는 곳** — 모든 채널, 선택된 채널만, 또는 선택된 채널 제외 전체. 스레드는 부모 채널의 범위를 상속합니다.

**보호 역할과 채널** — AI는 이들을 대상으로 하는 모든 동작을 거부합니다: 편집, 삭제, 복제, 이동, 할당, 게시 불가.

<Warning>
  보호는 절대적입니다. 보호된 대상은 **관리자 확인이 있어도** 건드릴 수 없습니다. 이곳이 Admin 역할, 규칙 채널, 로그 채널을 잠그기에 적합한 위치입니다.
</Warning>

<Tip>
  보호 채널은 카테고리를 포함할 수 있으므로 하나의 카테고리를 보호하면 그 안의 모든 것이 보호됩니다.
</Tip>

## 페르소나

톤과 상시 지시 사항을 설정하는 최대 2,000자 — *"간결하고 격식 있게. 채널을 삭제하기 전에 항상 확인. 스태프를 팀이라고 부를 것."* 비워두면 중립적인 기본값이 사용됩니다.

## 실행이 진행되는 모습

<Steps>
  <Step title="작동 시작">
    입력 표시가 나타납니다. 간단한 질문은 전체 도구셋을 로드하지 않고 직접 답변됩니다.
  </Step>

  <Step title="진행 카드 표시">
    실제로 무언가를 변경할 때만 생성됩니다 — 순수 조회는 카드를 표시하지 않습니다. 각 동작마다 줄이 추가됩니다: ✅ 완료, ❌ 실패와 이유, ⏳ 확인 대기.
  </Step>

  <Step title="필요한 경우 확인">
    파괴적인 동작은 확인 카드를 표시합니다. 그 안의 내용은 아직 실행되지 않았습니다.
  </Step>

  <Step title="결과 보고">
    변경 사항의 녹색 요약, 또는 질문만 했다면 일반 답변.
  </Step>
</Steps>

<Note>
  단일 요청은 **90초** 예산 내에서 최대 **8단계**를 실행합니다. 매우 큰 요청은 조기 중지될 수 있으며 이를 알려줍니다 — 더 작은 요청으로 나누세요.
</Note>

## 속도 제한과 동시성

* 사람당 대략 **5초에 한 요청**, 소량의 버스트 허용
* 사람당 **동시 요청 1개**
* 서버 전체 **동시 4개**

사람별 또는 서버별 한도에 도달하면 짧은 "작동 중 / 잠시 후 재시도" 안내가 20초에 한 번 이하로 표시됩니다.

## 예산

실행에는 최소 **30,000 토큰** 잔량이 필요합니다. 그 이하이면 완료할 수 없는 작업을 시작하는 대신 예산 소진 메시지로 거절합니다.

<Card title="AI 사용량" icon="chart-line" horizontal href="/ko/moderation/ai-usage">
  지출 추적, 실행된 동작 확인, 충전.
</Card>

## 문제 해결

<AccordionGroup>
  <Accordion title="봇이 저를 완전히 무시해요">
    설계상 모든 접근 실패에 대한 응답은 침묵입니다 — 오류 메시지가 없습니다. 다음 순서로 확인하세요:

    1. **봇을 직접 멘션**했나요? 역할 핑이나 답장 핑은 트리거가 아닙니다.
    2. 서버 설정에서 **AI Server Control**이 켜져 있나요?
    3. 채널이 범위 내에 있나요?
    4. Administrator이거나, **Allowlist bypasses Administrator가 켜진 상태에서** 허용 목록에 있나요?
    5. 여러 요청을 연속으로 보냈나요? 몇 초 기다리세요.
  </Accordion>

  <Accordion title="Allowed users에 추가했는데 아무것도 바뀌지 않았어요">
    정상입니다. 기본값에서는 허용 목록이 비활성화되어 있습니다. **Allowlist bypasses Administrator**를 켜거나 **Require Administrator**를 끄세요.
  </Accordion>

  <Accordion title="분명히 도구가 있는데 동작을 거부해요">
    Tools 탭에서 도구의 카테고리가 꺼져 있거나, 대상이 보호 역할 또는 채널 목록에 있거나, 요청자에게 해당 동작의 Discord 기본 권한이 없습니다.
  </Accordion>

  <Accordion title="큰 작업 중간에 멈췄어요">
    요청당 8단계, 90초입니다. 작업을 나누세요 — "다섯 채널을 만들어" 그다음 "이제 이 채널에 권한을 설정해".
  </Accordion>

  <Accordion title="예산이 소진되었다고 해요">
    30,000 토큰 미만에서는 시작하지 않습니다. AI 사용량 페이지에서 충전하거나 월간 지급을 기다리세요.
  </Accordion>

  <Accordion title="확인이 만료됐어요">
    확인은 1시간 지속됩니다. 다시 요청하세요.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="AI 자동 조정" icon="sparkles" href="/ko/moderation/ai-auto-mod">
    맥락을 이해하는 콘텐츠 조정.
  </Card>

  <Card title="접근 제어" icon="key" href="/ko/server-management/dashboard-permissions">
    누가 대시보드에서 무엇을 변경할 수 있는지.
  </Card>
</CardGroup>