# Slack

> 只需把 Trina AX 应用添加到你的 Slack 工作区一次，之后每个人都可以在频道或私信中向 Trina AX 提问，并使用自己的权限。

连接 Slack 后，大家不用离开 Slack 就能向 Trina AX 提问：在频道中提及 **@Trina AX**，或给它发私信。每个问题都以提问者的身份
运行，使用这个人自己的文件夹权限、AI 引擎和限额，完整的回答也会作为一次对话保存在 Trina AX 中。

只需两个简短的步骤。团队的所有者或管理员把应用添加到 Slack 一次，每个人再关联一次自己的 Slack 账号。

> **提示:** **你需要准备的**
>
> - **添加应用**（一次）：Trina AX 中团队的所有者或管理员，以及在你的 Slack 工作区中能批准应用的人（Slack 工作区的管理员或
>   所有者）。不需要复制或粘贴任何内容。
> - **关联你的账号**（每人一次）：你自己的 Slack 账号。不需要复制或粘贴任何内容。
> - **仅限没有“添加到 Slack”的服务器**：你自己的 Slack 应用中的四个值，见[下文](#如果没有添加到-slack)。

> **注意:** 本页截图使用的是一个虚构的团队和工作区“Acme”。

## 把 Trina AX 添加到 Slack（所有者或管理员）

1. **在“管理 › 已连接的应用”中打开 Slack**

   在**管理**中，选择**已连接的应用**。Slack 是其中的一项服务：添加之前在**发现**下，添加之后在**已连接**下。团队的所有者和
   管理员可以看到它。

   ![管理 › 已连接的应用：管理菜单中选中了已连接的应用，Slack 位于发现下的服务之中，排在 Google 应用之后](../../images/slack/connected-apps.webp "管理 › 已连接的应用，Slack 在发现下")

   选择 **Slack**。它的页面会显示**将 Trina AX 添加到 Slack**。

   ![添加之前 Slack 在已连接的应用中的页面：已连接的应用 › Slack、Slack 标志，以及带有添加到 Slack 按钮的将 Trina AX 添加到 Slack 卡片](../../images/slack/add-to-slack.webp "管理 › 已连接的应用 › Slack，添加之前")

2. **点击“添加到 Slack”**

   **添加到 Slack**会打开 Slack 自己的页面。在手机上也可以操作。

3. **选择工作区并允许**

   Slack 的页面右上角会显示工作区名称，并列出 Trina AX 在那里能看到和能做的事。请先确认工作区：Slack 会打开你上次使用的工作区，
   那可能不是你想要的。如有需要，在那个角落切换工作区，然后选择**允许**（Allow）。

4. **回到 Trina AX 中的 Slack 页面**

   页面会显示“已添加到 Slack。请把应用邀请到大家会使用它的频道。”这一行会显示你的工作区和应用，先是几秒钟的**正在连接**，然后是
   **已连接**。不需要复制或粘贴任何内容。Trina AX 等待 Slack 窗口时，会有 **重试** 和 **取消**；等待会在五分钟后自动结束。

   ![添加后的 Slack 页面：已添加到 Slack，然后已连接，Acme · @trina-ax，/invite @trina-ax 提示，已关联 0 人，移除 Slack 和关闭按钮](../../images/slack/connected.webp "已添加并已连接")

只有 Slack 工作区的管理员或所有者才能添加应用。其他人操作后回来会看到“需要 Slack 工作区管理员来添加。请让管理员操作。”，
应用也会再次从工作区中移除。

### 把应用邀请到频道

Slack 只会把应用所在频道的消息告诉 Trina AX。在每个大家会提问的频道中，输入：

```
/invite @trina-ax
```

私信不需要邀请。

## 关联账号并提问（所有人）

每个人把自己的 Slack 账号关联到自己的 Trina AX 账号，只需一次。任何人都不能替别人关联。

1. **在 Slack 中提问**

   在邀请了它的频道中提及 **@Trina AX**，或给它发私信。例如：“@Trina AX 总结一下 shared/sales 里上周的笔记”。

2. **第一次时连接你的账号**

   第一次时，Trina AX 只回复你一个人：“要在这里向 Trina AX 提问，请先连接你的 Trina AX 账号。这个链接只能用一次，10分钟内有效，
   并且只对你有效。”选择**连接 Trina AX 账号**。Trina AX 会打开（如有提示请登录），并显示两个账号。如果你的 Slack 账号和
   Trina AX 账号的邮箱相同，**关联**就会把它们关联起来。如果不同，页面会说明原因，并改为提供**使用 Slack 登录以关联**。

3. **或者从 Trina AX 中关联**

   **设置 › 连接器**中有一行 **Slack**：“使用你在……的 Slack 账号登录以完成关联。”**关联**会带你去 Slack 再回来，之后这一行会
   显示它所关联的账号。

   ![关联后的设置 › 连接器：你的 Slack 账号已关联。现在可以在 Slack 中提问了。下面是 Slack 这一行，自某个日期起关联到 Acme 中的 Olga，带有解除关联](../../images/slack/linked.webp "设置 › 连接器，Slack 已关联")

4. **再问一次**

   回到 Slack，把你的问题再问一次。从现在起，Trina AX 会马上回答。

### 回答出现在哪里

| 在哪里提问 | 你会得到什么 |
|---|---|
| **频道** | 先显示“正在处理…”，然后是只有你能看到的回答，并带有**发布到频道**。点击它，回答就会发布到话题中，并附上“……的提问”和你的名字。 |
| **私信** | 回答会出现在你这条消息的话题中。 |

- **在同一个话题中继续。** 在那个话题中再次提及应用，或在私信的话题中回复：会继续同一个对话。新话题会开始一个新对话。
- **用你的语言。** Trina AX 自己在 Slack 中显示的文字（“正在处理…”“以……的身份回答。”“在Trina AX中打开”）使用你在 Trina AX
  中的语言。回答本身则使用你为 AI 回答选择的语言。
- **完整的回答也在 Trina AX 中。** 较长的回答在 Slack 中会被缩短，并附上查看其余内容的链接。“正在处理…”还会写明它以哪个账号的
  身份回答，这样你就能确认那是你的。
- **发布之前。** 如果回答用到了团队中不是所有人都能看到的地方，例如某个小组的文件夹或你自己的文件夹，**发布到频道**会先请你确认，
  并提供**仍然发布**和**取消**。在与其他组织共享的频道中，回答永远不会被发布。

## 如果没有“添加到 Slack”

**添加到 Slack**只出现在由 Trina 托管服务为你提供服务器的地方：托管的团队，或者你自己安装、并已在托管服务中登记的服务器。
在其他地方，**管理 › 已连接的应用**中的 Slack 页面会改为显示**连接 Slack 应用**：分四步，用我们的清单（manifest）创建团队自己的
Slack 应用，并粘贴它的密钥。只有团队的所有者可以做这一步，因为需要粘贴应用的密钥；管理员会看到“只有团队所有者可以在这里连接
Slack。”请在团队的 `https://` 地址打开这个页面：大家的**使用 Slack 登录**链接会回到那里。

![连接 Slack 应用：1 在 Slack 中创建应用，2 安装到工作区，3 创建应用令牌并复制应用凭据，4 粘贴并开启，以及 Bot User OAuth Token、App-Level Token、Client ID 和 Client Secret 四个输入框](../../images/connect/slack-own-app.webp "连接 Slack 应用")

> **提示:** **你需要准备的，全部来自你的 Slack 应用设置页 api.slack.com/apps**
>
> | Trina AX 中的输入框 | 在 Slack 中的位置 | 样子 |
> |---|---|---|
> | **Bot User OAuth Token** | **Install App**（或 **OAuth & Permissions**），在 **Install to Workspace** 之后 | `xoxb-…` |
> | **App-Level Token** | **Basic Information › App-Level Tokens › Generate Token and Scopes**，范围为 `connections:write` | `xapp-…` |
> | **Client ID** | **Basic Information › App Credentials** | 带一个点的数字 |
> | **Client Secret** | **Basic Information › App Credentials**，点 **Show** | 字母和数字 |

1. **在 Slack 中创建应用**

   选择**在 Slack 中创建应用**。Slack 会打开“Create an app”，所有内容都已按我们的清单填好。选择你的工作区，然后选择
   **Create**。这会创建一个只属于你工作区的应用。

2. **安装到工作区**

   选择**安装到工作区**（Slack 的 **Install App** 页面），然后选择 **Install to Workspace** 和 **Allow**。复制以 `xoxb-`
   开头的 **Bot User OAuth Token**。

3. **创建应用令牌并复制应用凭据**

   选择**创建应用令牌并复制应用凭据**（Slack 的 **Basic Information** 页面）。在 **App-Level Tokens** 下选择
   **Generate Token and Scopes**，随便起个名字，添加范围 `connections:write`，然后选择 **Generate**。复制以 `xapp-` 开头的令牌。
   在同一页面的 **App Credentials** 下，复制 **Client ID** 和 **Client Secret**（先选择 **Show**）。

4. **粘贴并开启**

   把四个值粘贴到对应的输入框中，选择**检查并开启**。Trina AX 会向 Slack 核对它们。如果 Slack 拒绝某个值，会在那个输入框下
   说明，并给出修正它的 Slack 页面。

然后像上面那样把应用邀请到频道。面向运维人员的详细说明：
[设置团队自己的应用](https://github.com/trina-app/trina-ax/blob/main/docs/SLACK.md#setting-up-the-teams-own-app-the-owner)（英文）。

| 你看到的 | 该怎么做 |
|---|---|
| “这不是机器人令牌。”或“Slack 不接受此令牌。” | 从 **Install App** 用 Slack 的复制按钮重新复制 **Bot User OAuth Token**（`xoxb-`）。 |
| “Slack 不接受此应用令牌。” | 新建一个带有范围 `connections:write` 的 App-Level Token 并粘贴。 |
| “这两个令牌属于不同的 Slack 应用。” | 两个令牌必须来自同一个 Slack 应用。 |
| “这不是 Client ID。”或“这不是 Client Secret。” | 从 **Basic Information › App Credentials** 重新复制；这两个输入框可能填反了。 |
| “请开启 Slack app settings › Socket Mode。” | 清单会开启它；如果有人关掉了，请在 Slack 中重新开启。 |
| **使用 Slack 登录**失败，并出现重定向错误 | 页面是在团队 `https://` 地址以外的地址保存的。请在团队的地址打开页面，再保存一次。 |

如果团队自己的 Slack 应用已经设置好，你也会看到这四个步骤。要切换的话，所有者先把它移除（**更换令牌**，然后**移除 Slack**），
再点击**添加到 Slack**。管理员可以关闭和开启团队自己的应用，但只有所有者可以更改或移除它。如果在“管理 › 已连接的应用”中
根本看不到 Slack，说明你不是团队的所有者或管理员：请找他们。

## 移除或重新连接

**管理 › 已连接的应用**中的 Slack 页面始终会说明当前状态，列表中它的那一行会显示同样的状态：**开**、**正在连接**、**关**或需要你处理的事。如果 Slack 几分钟都没有回应，页面会显示
**无响应**，并说明该怎么做。如果应用在
Slack 中被移除，这一行会显示**重新连接**，页面会再次提供**添加到 Slack**，如果你不想再用，也可以选择**移除 Slack**。

![应用在 Slack 中被移除后的 Slack 页面：应用已从 Slack 中移除。请重新添加到 Slack。下方是添加到 Slack 按钮和移除 Slack](../../images/slack/removed.webp "应用在 Slack 中被移除之后")

| 发生了什么 | 该怎么做 |
|---|---|
| **有人在 Slack 中移除了应用** | Slack 页面会显示“应用已从 Slack 中移除。请重新添加到 Slack。”再次点击**添加到 Slack**。每个人的关联都会保留：只要添加到同一个工作区，就没有人需要重新关联。如果你不想再用，请改为点击**移除 Slack**：Slack 会回到**发现**下，所有人的账号关联都会被删除。 |
| **想暂时关闭** | 点击**关闭**。Trina AX 会停止在 Slack 中回答；关联保留。点击**开启**即可恢复。 |
| **想彻底移除** | 点击**移除 Slack**并确认。应用会从你的 Slack 工作区中移除，所有人的账号关联都会被删除。如果以后再次添加，每个人都需要重新关联。 |

任何人都可以随时在**设置 › 连接器**的 Slack 这一行中，对自己的 Slack 账号点击**解除关联**。

## 常见问题

### 谁可以把 Trina AX 添加到 Slack？

团队的所有者或管理员在 Trina AX 中点击**添加到 Slack**，在 Slack 中还需要工作区的管理员或所有者允许。管理员还可以关闭和开启它、
重新添加以及移除它。设置团队自己的 Slack 应用（粘贴它的密钥）只能由团队的所有者完成。成员永远看不到“管理”；他们在
**设置 › 连接器**中关联自己的 Slack 账号。

### 每个人都需要登录吗？

是的，一次。在一个人关联自己的 Slack 账号之前，Trina AX 只会给他发送连接用的链接。Trina AX 账号被停用或删除的人会立即被解除关联。

### Trina AX 在 Slack 中能看到什么？

在邀请了它的频道中提及 @Trina AX 的消息，以及发给它的私信。你在话题中提问时，AI 也会读取这个话题。你要求时，它可以读取邀请了
这个应用、而且你也在其中的频道或话题。其中来自其他应用的消息（例如表单或监控通知）会连同详细内容一起读取。它不会读取文件，
也不能读取没有邀请这个应用的频道。为了关联账号并说明是谁提的问，它会读取工作区中成员的名字和邮箱地址。在频道中，回答在提问者发布之前只对提问者本人可见。

### 回答使用谁的权限？

提问者的：他的文件夹权限、AI 引擎和限额。和任何对话一样，这个回答会计入他的用量。

### 可以连接多个工作区吗？

不可以，每个团队只能连接一个工作区。已经连接到另一个团队的工作区会被拒绝：“此 Slack 工作区已连接到另一个团队。请在那里移除，
或在 Slack 中移除应用，然后重试。”共享频道中其他组织的人以及机器人都不会得到回答。

完整说明：[Slack 连接器](https://github.com/trina-app/trina-ax/blob/main/docs/SLACK.md)（英文）。
