> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vecbase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Discord

> 将 Agent 连接到 Discord 服务器

# Discord 接入指南

将 Vecbase Agent 连接到 Discord，服务器中的用户可以与 Agent 对话。

## 前置条件

* Discord 账号
* 你有管理员权限的 Discord 服务器
* 已创建 Vecbase Agent

## 第一步：创建 Discord 应用

<Steps>
  <Step title="打开 Developer Portal">
    访问 [Discord Developer Portal](https://discord.com/developers/applications) 并登录。
  </Step>

  <Step title="创建应用">
    点击 **New Application**，输入名称（如 "Vecbase 助手"）。
  </Step>

  <Step title="创建机器人">
    在左侧导航进入 **Bot**，点击 **Add Bot** → **Yes, do it!**
  </Step>

  <Step title="复制 Bot Token">
    点击 **Reset Token** 生成新 Token 并复制：

    ```
    MTI3NjU0MzIxMDk4NzY1NDMy.GH8k2w.abc123...
    ```

    <Warning>
      Token 只显示一次。丢失后需要重新生成。
    </Warning>
  </Step>

  <Step title="开启 Intents">
    在 **Privileged Gateway Intents** 中启用：

    * ✅ **Message Content Intent**（读取消息内容）
    * ✅ **Server Members Intent**（获取成员信息）
  </Step>
</Steps>

## 第二步：邀请机器人到服务器

<Steps>
  <Step title="生成邀请链接">
    进入 **OAuth2** → **URL Generator**。

    勾选 Scopes：

    * ✅ `bot`
    * ✅ `applications.commands`

    勾选 Bot Permissions：

    * ✅ Send Messages
    * ✅ Read Message History
    * ✅ Attach Files
    * ✅ Add Reactions
    * ✅ Manage Threads
  </Step>

  <Step title="邀请机器人">
    复制生成的 URL 在浏览器打开，选择服务器，点击 **Authorize**。
  </Step>
</Steps>

## 第三步：在 Vecbase 中连接

<Steps>
  <Step title="打开 Agent 设置">
    打开你的 Agent，点击右上角的 **设置**，然后选择 **通道**。
  </Step>

  <Step title="添加 Discord 通道">
    点击 **Discord** 旁边的 **添加通道**。
  </Step>

  <Step title="填写凭证">
    * **显示名称**：给通道取个名字（如 "开发服务器机器人"）
    * **Bot Token**：粘贴第一步获取的 Token
    * **Application ID**：从 Discord Developer Portal → **General Information** 复制
  </Step>

  <Step title="创建">
    点击 **创建**，状态变为 **已连接**。
  </Step>
</Steps>

## 第四步：测试

在 Discord 服务器中，在机器人有权限的频道发送消息，机器人会自动回复。

## 限制

| 限制   | 数值        |
| ---- | --------- |
| 文件上传 | 25 MB（默认） |
| 消息长度 | 2,000 字符  |