> ## 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>
  必须同时打开两个开关：[服务器设置](/zh-CN/server-management/setup) 中的 **AI 服务器控制**，以及本页面上的设置。
</Note>

## 你如何与它对话

直接提及机器人。`@Vetox create a #announcements channel that only staff can post in`。

三件事 **不是** 触发器：`@everyone` 和 `@here`、机器人恰好持有的角色，以及对回复的自动提及。

<Tip>
  一旦它打开了线程，就在该线程中继续对话——你不需要重新提及它。对话保持活跃 **两小时**。
</Tip>

### 线程或回复

| 模式         | 行为               |
| ---------- | ---------------- |
| **线程**（默认） | 在你的消息上打开线程并在其中工作 |
| **回复**     | 直接在频道中回复         |

在线程模式下，**私密线程** 默认开启，因此对话仅对你和有访问权的员工可见。若私密线程无法创建，会回退到公开线程。

## 访问——启用前请阅读

<Warning>
  **访问默认拒绝。** 既非管理员又未被明确允许的成员永远不能使用 AI，无论开关如何设置。
</Warning>

访问标签页显示"有效访问"摘要。当它读作 *"未设置限制——任何人都可以使用 AI"* 时，那一行具有误导性——实际行为仍是仅管理员。

两个开关决定谁能进入：

| 需要管理员     | 白名单绕过管理员  | 谁可以使用             |
| --------- | --------- | ----------------- |
| **开**（默认） | **关**（默认） | 仅管理员。**白名单毫无作用。** |
| 开         | 开         | 管理员，加上白名单中的任何人    |
| 关         | 任意        | 管理员，加上白名单中的任何人    |

<Tip>
  要让受信任的审核员使用 AI 而不授予管理员权限，请将其添加到 **允许的用户** 并开启 **白名单绕过管理员**。仅将其添加到列表毫无效果。
</Tip>

### 每工具权限是第二道闸

被允许 *对话* AI 不授予它你的 Discord 权限。每个动作还会重新检查请求者匹配的权限。

**绕过角色** 和 **绕过用户** 跳过那些每动作检查。请谨慎授予——这允许某人通过 AI 执行他们自己无法执行的动作。

## 工具

27 个类别涵盖频道、角色、审核、消息、线程、语音、Webhook、邀请、表情、贴纸、活动、论坛、引导、投票、集成、音板、模板、组件、欢迎屏幕、虚荣 URL 等。

关闭整个类别，其中每个动作都变得不可用，即使被明确请求。展开类别以切换单个动作。

<Note>
  类别开关胜出。类别关闭时，其单个开关灰化且不相关。重新打开类别会恢复你已保存的每动作状态。
</Note>

无法撤销的动作被标记为 **破坏性**。

<Tip>
  使用顶部搜索框——有 182 个动作时，查找 "ban" 或 "webhook" 比滚动快得多。
</Tip>

### 确认不是可选的

每个破坏性动作在运行前都会被保留供你确认。没有设置能禁用此。

确认卡片精确列出已排队的内容。只有发起请求的人可以确认它，它在一小时后过期。确认时，**每次访问检查都会针对实时配置重新运行** ——因此撤销某人的访问也会使他们的待处理确认失效。

## 范围

**AI 在何处工作** ——所有频道、仅所选频道，或除所选外全部。线程继承父频道的范围。

**受保护的角色和频道** ——AI 拒绝任何针对它们的动作：不编辑、不删除、不克隆、不移动、不分配、不发帖。

<Warning>
  保护是绝对的。受保护的目标 **即使有管理员确认也无法触碰**。这是锁定你的管理员角色、规则频道和日志频道的正确位置。
</Warning>

<Tip>
  受保护的频道可以包含分类，因此保护一个分类会保护其下归档的所有内容。
</Tip>

## 人设

最多 2,000 字符设定语调和任何常驻指令—— *"简洁正式。删除频道前始终确认。将员工称为团队。"* 留空则使用中性默认。

## 一次运行是什么样的

<Steps>
  <Step title="它开始工作">
    出现输入指示器。简单问题直接回答，而无需加载完整工具集。
  </Step>

  <Step title="出现进度卡">
    只在它实际更改某物时才创建——纯查询从不显示卡片。每个动作添加一行：✅ 已完成、❌ 失败并附原因、⏳ 等待确认。
  </Step>

  <Step title="确认，若需要">
    破坏性动作显示确认卡。其中的任何东西都尚未运行。
  </Step>

  <Step title="它回报">
    绿色的变更摘要，或若你只问了一个问题则是平实答案。
  </Step>
</Steps>

<Note>
  单次请求在 **90 秒** 预算内运行最多 **8 步**。非常大的请求可能提前停止并说明——请将它们拆分为更小的。
</Note>

## 速率限制与并发

* 每人大约 **每 5 秒一次请求**，带小量突发额度
* 每人 **一次一个请求**
* 整个服务器 **一次四个**

达到每人或每服务器限制会产生简短的 "仍在工作/稍后再试" 通知，最多每 20 秒一次。

## 预算

一次运行至少需要 **30,000 令牌** 储备。低于此值，它会以预算耗尽消息拒绝，而不是启动它无法完成的工作。

<Card title="AI 用量" icon="chart-line" horizontal href="/zh-CN/moderation/ai-usage">
  跟踪花费、查看运行了哪些动作并充值。
</Card>

## 故障排查

<AccordionGroup>
  <Accordion title="机器人完全忽略我">
    沉默是每次访问失败的正常响应——按设计没有错误消息。请按顺序检查：

    1. 你 **直接提及了机器人** 吗？角色提及或回复提及不是触发器。
    2. **AI 服务器控制** 在服务器设置中打开了吗？
    3. 该频道在范围内吗？
    4. 你是管理员，或在白名单中 **且开启了白名单绕过管理员** 吗？
    5. 你连续发送了多个请求吗？请等几秒。
  </Accordion>

  <Accordion title="我把某人添加到了允许的用户但什么都没变">
    预期如此。默认下白名单是惰性的。请打开 **白名单绕过管理员**，或关闭 **需要管理员**。
  </Accordion>

  <Accordion title="它拒绝显然有工具的动作">
    要么该工具的类别在工具标签页上被关闭，要么目标在你的受保护角色或频道列表上，要么请求者缺乏该动作的底层 Discord 权限。
  </Accordion>

  <Accordion title="它在大任务中途停下">
    每次请求 8 步、90 秒。请拆分工作—— "创建这五个频道"然后 "现在为它们设置权限"。
  </Accordion>

  <Accordion title="它说预算已用完">
    低于 30,000 令牌它不会启动。请在 AI 用量页面充值或等待每月额度。
  </Accordion>

  <Accordion title="确认过期了">
    确认持续一小时。请再问一次。
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="AI 自动审核" icon="sparkles" href="/zh-CN/moderation/ai-auto-mod">
    上下文感知的内容审核。
  </Card>

  <Card title="访问控制" icon="key" href="/zh-CN/server-management/dashboard-permissions">
    谁可以在仪表板上更改什么。
  </Card>
</CardGroup>
