Slack机器人集成
码道Agent Space具备多端IM接入能力,支持将码道Agent Space的Agent能力复用于多个IM平台,并提供统一的配置管理。
本章节将详细介绍如何将码道Agent Space接入Slack,助您快速实现功能集成与流程协同。
约束限制
| 限制类别 | 具体限制 |
|---|---|
| 功能限制 | 一个Slack机器人仅支持对接一个码道Agent Space。 |
操作流程
| 序号 | 操作平台 | 步骤 | 说明 |
|---|---|---|---|
| 1 | Slack开发者后台 | 在码道Agent Space对接Slack机器人时,请提前完成如下操作:
| |
| 2 | 码道Agent Space | 在码道Agent Space中,注册Slack机器人用以接收和回复消息。 | |
| 3 | Slack客户端 码道Agent Space | 通过Slack机器人对码道Agent Space下发任务。 |
步骤一:准备工作
- 创建Slack应用。
- 登录Slack开发者后台,单击“Create New App”,进入“Create an app”页面。
- 选择“From scratch”,输入App Name,选择工作区,单击“Create App”。
此处配置的App Name即为机器人名称。
- 启用Socket Mode,获取应用令牌。
- 进入“Socket Mode”页面,开启“Connect using Socket Mode”下的“Enable Socket Mode”。
- 输入Token Name,单击“Generate”。 请根据界面提示,拷贝应用令牌。请妥善保存Token,仅允许复制一次。在码道Agent Space中,连接Slack机器人时需要使用该令牌。图1 拷贝Token
- 获取机器人令牌。
- 进入页面,在域中,单击“Add an OAuth Scope”,并添加如下权限。
- app_mentions:read
- channels:history
- chat:write
- groups:history
- im:history
- im:read
- im:write
- mpim:history
- users:read
- 在“OAuth Tokens”中,单击“Install to All FOR AI”,单击“允许”,获取机器人令牌。 请妥善保存机器人令牌,在码道Agent Space中,连接Slack机器人时需要使用该令牌。图2 机器人令牌
- 进入页面,在域中,单击“Add an OAuth Scope”,并添加如下权限。
- 开启订阅事件。
- 进入“Event Subscriptions”页面,开启Enable Events。
- 开启后,在Subscriptions to bot events中,单击“Add Bot User Event”。
- 添加如下事件,单击“Save Changes”。
- message.im
- app_mention
- 开启用户给机器人发消息功能。
进入“App Home”页面,开启“Messages Tab”并勾选“Allow users to send Slash commands and messages from the messages tab”。
- 获取密钥。
进入“Basic Information”页面,在“App Credentials”中获取Client Secret。后续在码道Agent Space中,连接Slack机器人时需要使用Client Secret。
- 自定义斜杠命令。
进入“Slash Commands”页面,单击“Create New Command”新建图3中斜杠命令。
表3 自定义斜杠命令 命令
说明
/stop
在停止当前会话。
/help
查看可用命令。
/new
创建新会话。
新建会话时,码道Agent Space会自动保存原会话至历史列表。此后您将进入全新的对话环境,无法再返回之前的会话状态。
/models
查看和切换模型。
仅支持查看与切换码道Agent Space内置模型。
步骤二:码道Agent Space配置
- 参考开启码道Agent Space操作,进入码道Agent Space。
- 在码道Agent Space对话面板中,单击“选择项目文件夹”,选择“打开项目”,打开一个文件夹。 图4 打开一个文件夹
- 在码道Agent Space页面右上角,单击设置图标
,进入码道Agent Space设置页面。 - 选择“IM集成”,单击Slack机器人集成后的“配置”,进入“注册Slack通道”页面。
- 输入6中获取的Slack机器人凭证(Client ID/Client Secret),单击“注册”。
等待注册完成,当状态由“连接中”变为“已连接”时,说明Slack机器人注册成功。
步骤三:Slack远程控制
- 登录Slack客户端,在“代理与应用”中,单击1中添加的机器人。
- 在Slack机器人中输入想要执行的任务内容,单击“发送”提交任务。
机器人将自动接收到来自码道Agent Space的反馈信息。此外,在Slack客户端还支持使用7中自定义的斜杠命令来触发相应功能,操作更加便捷。
- 根据反馈消息确认任务需求及关键信息,完成任务的创建。
- 查看任务执行结果。
- 在Slack机器人端:Slack机器人接收到来自码道Agent Space的完成反馈,提示任务执行结束并附带产物位置。
- 在码道Agent Space侧:在码道Agent Space界面的“IM消息 > Slack消息”中,您可以实时查看任务执行过程及结果。单击会话聊天界面右上方的产物面板图标
,即可在任务产物列表中查看生成的交付件。

