自定义聊天机器人
本指南介绍如何在不离开 Control Center 的情况下,重塑提供方一侧的机器人应用。
开始之前
标题为“开始之前”的部分- 在工作区中拥有
owner或admin角色 - 一个 已连接 的提供方。只有在工作区连接之后,自定义机器人 这一行才会出现
- 一个 Control Center 能够管理的应用。对 Slack 来说,这意味着连接中持有一个应用配置刷新令牌(
xoxe-…);如果没有,这一行会说明情况并保持禁用 - 工作区自己的 Slack 应用。使用 Control Center 共享 Slack 应用的工作区不会出现自定义机器人这一行:共享应用的名称、描述和命令对所有人都相同(共享应用还是自有应用)
你可以更改的内容
标题为“你可以更改的内容”的部分| 字段 | 含义 | 限制 |
|---|---|---|
| 应用名称 | 提供方列出该应用时使用的名称 | 1–35 个字符 |
| 机器人名称(成员在 @ 后输入的内容) | 成员在 @ 后输入的内容 |
1–80 个字符 |
| 简短描述 | 提供方显示的一行文字 | 不超过 140 个字符 |
| 机器人对自己能力的介绍 | 显示在与机器人的私信上方 | 不超过 300 个字符 |
| 斜杠命令 | 成员调用的命令,不带斜杠 | 转为小写、仅允许 a–z 0–9 _ -、超过 32 个字符会被截断 |
| 私信 | 机器人是否提供私信/智能体体验 | 开启或关闭 |
Control Center 会在调用提供方之前校验这四个文本字段,因此你得到的是“the app name must be between 1 and 35 characters”,而不是从一台你看不见的服务器返回的、含义不明的 invalid_manifest。命令不会被拒绝,而是会被规范化:开头的斜杠会被去掉,其余部分转为小写,a–z 0–9 _ - 之外的字符会被丢弃,如果结果为空则回退为 cc。
编辑机器人
标题为“编辑机器人”的部分- 前往 设置 → 工作区 → 集成,向下滚动到 聊天桥接 卡片
- 在提供方区块上,点击 自定义机器人
- 对话框会以从提供方读回的应用_实时_值打开——所以你的起点,是别人可能在 Slack 自己的界面中做过的改动
- 按需修改并保存
读取这些实时值会在 Slack 一侧产生一次令牌轮换,这正是这一行需要刻意点击、而不是在页面加载时自动执行的原因。
写入操作会把你的改动叠加到应用的当前定义之上。任何 Control Center 没有建模的内容——你在 Slack 中额外添加的第二条斜杠命令、一个工作流步骤、一项无关的设置——都会原样保留。权限范围和事件只会被合并进来,绝不会被减去。
保存之后,Control Center 会重新读取机器人的身份,使设置中的名称与聊天应用中的名称一致。
权限变更后重新安装
标题为“权限变更后重新安装”的部分当某次保存改动了权限时,对话框会保持打开并显示“Slack 更改了应用权限。请重新安装应用使其生效”, 同时提供一个 重新安装应用 按钮,用于打开该应用在 Slack 中的团队安装页面。 在 Slack 中,对应的是 Install App → Reinstall to Workspace。
重命名斜杠命令
标题为“重命名斜杠命令”的部分更改 斜杠命令 并保存。之后桥接在编写说明时会使用它最后一次被调用时所使用的命令,因此帮助文本和关联说明会跟随重命名,而不会指向一条已不存在的命令。
重命名不会破坏已有的桥接话题:话题以对话为键,而不是以命令为键。
Control Center 不会更改的内容
标题为“Control Center 不会更改的内容”的部分- 结构性设置。 传输方式(Socket Mode)、必需的权限范围和事件订阅都是强制断言的,不对外开放。一个能从设置界面被配置到彻底沉默的应用,是一张支持工单,而不是一项特性
- 机器人的图标。 只有提供方自己的应用设置才能更改它,对话框中也如此说明
- 提供方自身的功能迁移。 已经采用 Slack 旧版助理形态的应用会保持原样;这个对话框编辑的是一段描述,它不会迁移应用
故障排查
标题为“故障排查”的部分完全没有“自定义机器人”这一行
标题为“完全没有“自定义机器人”这一行”的部分工作区尚未连接。只有当提供方区块显示实时连接之后,这一行才会出现。参见 设置 Slack 集成。
“自定义机器人”这一行处于禁用状态
标题为““自定义机器人”这一行处于禁用状态”的部分该连接没有应用管理凭据——这一行的副标题会显示 “Control Center 需要应用配置 token 才能编辑机器人。请重新连接并提供该 token。”对 Slack 来说,请在 api.slack.com/apps 上生成一对应用配置令牌, 并带上填写好的刷新令牌重新连接。对于手工构建或通过 在 Slack 中创建 创建的应用, 这是预期情况,因为 Slack 从不会报告它创建的是哪个应用。
“Control Center 不知道要编辑哪个应用”
标题为““Control Center 不知道要编辑哪个应用””的部分存储的连接不携带应用 id——通常是在应用 id 被记录之前手工连接的应用。请重新连接工作区,或从 Control Center 创建该应用。
机器人的新名称尚未出现在聊天中
标题为“机器人的新名称尚未出现在聊天中”的部分提供方会短暂缓存应用元数据。如果过了一分钟名称仍然是旧的,请检查这次保存是否要求你重新安装该应用。