与 Slack 集成
IBM Cloud
Slack 是一种基于云的消息传递应用程序,可帮助人们相互进行协作。
创建操作后,可以将助手与 Slack 集成。
集成后,根据对助手配置支持的事件,助手可以响应直接消息中询问的问题,或响应在直接提及该助手的通道中询问的问题。
有关如何使用 watsonx Assistant,Slack 和 Db2 创建 Slackbot 的示例和指示信息在解决方案教程 构建数据库驱动的 Slackbot 中提供。
准备工作
要将 Slack 与助理集成,您必须拥有一个 Slack 应用程序以及必要的角色和权限:
角色 | 许可权 |
---|---|
工作空间或 组织所有者 |
查看信息 发布信息 执行操作 |
要创建 slack 应用程序,请参阅 快速入门:启动工作流。
有关角色和权限的更多信息,请参阅 Slack-Getting started。
添加 Slack 集成
-
通过单击左侧菜单中的集成图标 (
),转至“集成”页面。
-
单击 Slack 磁贴上的 添加。
-
然后,再次点击 “添加”。
开始
设置 Slack 有四个步骤:
- 设置你的 Slack 机器人
- watsonx Assistant 连接到Slack
- 配置你的 Slack 机器人
- 连接您的助手
设置你的 Slack 机器人
- 访问 Slack 网站上的 Your Apps 页面,然后单击要使用的应用程序或创建一个新的应用程序。
watsonx Assistant 连接到Slack
-
在Slack应用设置页面,进入基本信息选项卡,向下滚动到应用凭证部分。
-
复制您的验证令牌并将其粘贴到 助手设置页面。
-
在 Slack 应用程序设置页面中,转到 Features > OAuth & Permissions 并向下滚动到 Bot Token Scopes 部分。
-
点击添加OAuth范围,并选择以下范围:
app_mentions:read
chat:write
im:history
im:read
im:write
-
向上滚动页面至 OAuth Tokens for Your Workspace 部分,然后单击 Install App to Workspace,再单击 Allow.
您将被重定向到 OAuth & Permissions 页面。
-
在 助手设置页面中复制并粘贴您的 Bot 用户 OAuth 访问令牌。
-
单击下一步以继续。
配置你的 Slack 机器人
-
复制生成的URL。
-
在 Slack 应用程序设置页面中,转到 Features > Event Subscriptions 并切换 Enable Events 开关
on
。 -
在 URL 下粘贴 URL。
请耐心等待,直到看到 URL 旁边出现绿色的勾号,表示验证成功。
-
向下滚动并单击 订阅机器人事件。
-
选择您想订阅的活动类型。 您必须至少选择下列其中一种类型:
-
message.im
:侦听在直接消息通道中发布的消息事件。 -
app_mention
:仅侦听提及应用程序或机器人的消息事件。选择正常字体的 app_mention 条目,而不是以粗体字体显示的 app_mention 条目。
-
-
单击保存更改。
-
在助手设置页面,单击下一步。
连接您的助手
-
在 Slack 应用程序设置页面中,转到 Features > AppHome 并单击 Edit 旁边的 App Display Name。
-
完成更改后,单击 保存。
-
将始终将我的机器人显示为在线切换到
on
。 -
转到 Show Tabs 部分,将 Messages Tab 切换为
on
。 -
选中 Allow users to send Slash commands and messages from the messages tab 复选框。
-
如果要在 Slack 应用程序中添加对显示按钮、菜单和消除歧义选项的支持,请执行以下步骤:
- 转到 Interactivity & Shortcuts 选项卡并启用该功能
- 请将您的请求 URL 粘贴到提供的文本输入字段中。
- 单击保存更改。
-
在助手设置页面,单击完成。
如果更改了认证所需的 token
字段,那么必须重新填充并验证相关字段中的所有条目。
操作注意事项
您在操作中添加的丰富回复会显示在Slack频道中,但以下情况除外:
-
连接到真人客服:此回复类型将被忽略。
-
选项:此响应类型显示用户可以选择的选项列表。
-
用户点击其中一个选项后,现有的选择就会消失,取而代之的是由用户选择产生的用户输入。 如果在单个回复中包含多个回复类型,则必须将选项回复类型放在最后,以避免因回复和用户输入混合而造成混淆。
-
如果选项显示在下拉列表中,那么每个选项值的长度必须为 75 个字符或更少。 当列表包含5个或更多选项时,将以下拉列表的形式显示。
-
与助手聊天
要开始与助手聊天,请完成以下步骤:
- 打开 Slack,然后转至与应用程序关联的工作空间。
- 单击在“应用程序”部分中创建的应用程序。
- 与助手聊天。
Slack 集成不会处理欢迎操作。 欢迎消息不会像在助手预览中那样显示在 Slack 通道中。 它不会从此处触发,因为在用户启动的操作流程中,具有 welcome
特殊条件的节点会被跳过。 Slack 会等待用户启动交谈。
当前会话在60分钟(精简版和标准版为5分钟)不活动后自动重启。 这意味着,如果用户停止与助手进行交互,那么在 60 分钟(或 5 分钟)后,先前交谈期间设置的所有上下文变量值都会设置为 null 或恢复为其缺省值。