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

# Slack

> 将 Agent 连接到 Slack 工作区

# Slack 接入指南

将 Vecbase Agent 连接到 Slack，团队可以在频道和私聊中与 Agent 对话。

## 前置条件

* 你有管理员权限的 Slack 工作区
* 已创建 Vecbase Agent

## 第一步：创建 Slack 应用

<Steps>
  <Step title="打开 Slack API">
    访问 [Slack API](https://api.slack.com/apps)，点击 **Create New App** → **From scratch**。
  </Step>

  <Step title="填写信息">
    * **App Name**：如 "Vecbase 助手"
    * **Workspace**：选择你的工作区
  </Step>

  <Step title="启用 Socket Mode">
    进入 **Socket Mode**，开启。

    创建 **App-Level Token**，Scope 选 `connections:write`。

    复制 Token（以 `xapp-` 开头）：

    ```
    xapp-1-A07XXXXXXXX-1234567890123-abcdef...
    ```
  </Step>
</Steps>

## 第二步：配置权限

<Steps>
  <Step title="添加 Bot Scopes">
    进入 **OAuth & Permissions** → **Bot Token Scopes**，添加：

    | Scope              | 用途     |
    | ------------------ | ------ |
    | `chat:write`       | 发送消息   |
    | `channels:read`    | 读取频道列表 |
    | `channels:history` | 读取频道消息 |
    | `users:read`       | 获取用户信息 |
    | `files:read`       | 读取文件   |
    | `files:write`      | 上传文件   |
    | `reactions:write`  | 添加表情回应 |
  </Step>

  <Step title="订阅事件">
    进入 **Event Subscriptions** → 开启。

    订阅 Bot Events：

    * `message.channels` — 公共频道消息
    * `message.groups` — 私有频道消息
    * `message.im` — 私聊消息
    * `app_mention` — 被 @提及
  </Step>

  <Step title="安装到工作区">
    进入 **Install App** → **Install to Workspace** → **Allow**。

    复制 **Bot User OAuth Token**（以 `xoxb-` 开头）：

    ```
    xoxb-1234567890-1234567890123-AbCdEfGhIjKlMnOpQrStUv
    ```
  </Step>
</Steps>

## 第三步：在 Vecbase 中连接

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

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

  <Step title="填写凭证">
    * **显示名称**：给通道取个名字（如 "团队工作区"）
    * **App Token**：`xapp-...`（Socket Mode Token）
    * **Bot Token**：`xoxb-...`（OAuth Token）
  </Step>

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

## 第四步：测试

在频道中邀请机器人（`/invite @机器人名`），然后发送消息。

私聊直接在侧边栏找到机器人发消息。

<Tip>
  在频道中使用 `@机器人名` 提及机器人。默认情况下，机器人只在被提及时才在群组频道中回复。
</Tip>

## 限制

| 限制   | 数值             |
| ---- | -------------- |
| 文件上传 | 1 GB（取决于工作区套餐） |
| 消息长度 | 40,000 字符      |