更新时间:2026-07-28 GMT+08:00

Slack机器人集成

码道Agent Space具备多端IM接入能力,支持将码道Agent Space的Agent能力复用于多个IM平台,并提供统一的配置管理。

本章节将详细介绍如何将码道Agent Space接入Slack,助您快速实现功能集成与流程协同。

约束限制

表1 约束与限制

限制类别

具体限制

功能限制

一个Slack机器人仅支持对接一个码道Agent Space。

操作流程

表2 码道Agent Space接入Slack操作流程

序号

操作平台

步骤

说明

1

Slack开发者后台

步骤一:准备工作

在码道Agent Space对接Slack机器人时,请提前完成如下操作:

  1. 创建Slack应用。
  2. 获取应用令牌。
  3. 获取机器人令牌。
  1. 订阅事件。
  2. 开启消息选项卡。
  3. 获取密钥。
  4. 自定义斜杠命令。

2

码道Agent Space

步骤二:码道Agent Space配置

在码道Agent Space中,注册Slack机器人用以接收和回复消息。

3

Slack客户端

码道Agent Space

步骤三:Slack远程控制

通过Slack机器人对码道Agent Space下发任务。

步骤一:准备工作

  1. 创建Slack应用。

    1. 登录Slack开发者后台,单击“Create New App”,进入“Create an app”页面。
    2. 选择“From scratch”,输入App Name,选择工作区,单击“Create App”

      此处配置的App Name即为机器人名称。

  2. 启用Socket Mode,获取应用令牌。

    1. 进入“Socket Mode”页面,开启“Connect using Socket Mode”下的“Enable Socket Mode”
    2. 输入Token Name,单击“Generate”
      请根据界面提示,拷贝应用令牌。请妥善保存Token,仅允许复制一次。在码道Agent Space中,连接Slack机器人时需要使用该令牌。
      图1 拷贝Token

  3. 获取机器人令牌。

    1. 进入OAuth & Permissions页面,在Scopes > Bot Token Scopes域中,单击“Add an OAuth Scope”,并添加如下权限。
      • app_mentions:read
      • channels:history
      • chat:write
      • groups:history
      • im:history
      • im:read
      • im:write
      • mpim:history
      • users:read
    2. “OAuth Tokens”中,单击“Install to All FOR AI”,单击“允许”,获取机器人令牌。
      请妥善保存机器人令牌,在码道Agent Space中,连接Slack机器人时需要使用该令牌。
      图2 机器人令牌

  4. 开启订阅事件。

    1. 进入“Event Subscriptions”页面,开启Enable Events。
    2. 开启后,在Subscriptions to bot events中,单击“Add Bot User Event”
    3. 添加如下事件,单击“Save Changes”
      • message.im
      • app_mention

  5. 开启用户给机器人发消息功能。

    进入“App Home”页面,开启“Messages Tab”并勾选“Allow users to send Slash commands and messages from the messages tab”

  6. 获取密钥。

    进入“Basic Information”页面,在“App Credentials”中获取Client Secret。后续在码道Agent Space中,连接Slack机器人时需要使用Client Secret。

  7. 自定义斜杠命令。

    进入“Slash Commands”页面,单击“Create New Command”新建图3中斜杠命令。

    图3 自定义斜杠命令
    表3 自定义斜杠命令

    命令

    说明

    /stop

    在停止当前会话。

    /help

    查看可用命令。

    /new

    创建新会话。

    新建会话时,码道Agent Space会自动保存原会话至历史列表。此后您将进入全新的对话环境,无法再返回之前的会话状态。

    /models

    查看和切换模型。

    仅支持查看与切换码道Agent Space内置模型。

步骤二:码道Agent Space配置

  1. 参考开启码道Agent Space操作,进入码道Agent Space。
  2. 在码道Agent Space对话面板中,单击“选择项目文件夹”,选择“打开项目”,打开一个文件夹。

    图4 打开一个文件夹

  3. 在码道Agent Space页面右上角,单击设置图标 ,进入码道Agent Space设置页面。
  4. 选择“IM集成”,单击Slack机器人集成后的“配置”,进入“注册Slack通道”页面。
  5. 输入6中获取的Slack机器人凭证(Client ID/Client Secret),单击“注册”

    其中,机器人令牌请配置为3中获取的Bot User OAuth Token,应用令牌配置为2中获取的Token,密钥配置为6中获取的Client Secret。
    图5 完成Slack机器人注册

    等待注册完成,当状态由“连接中”变为“已连接”时,说明Slack机器人注册成功。

步骤三:Slack远程控制

  1. 登录Slack客户端,在“代理与应用”中,单击1中添加的机器人。
  2. 在Slack机器人中输入想要执行的任务内容,单击“发送”提交任务。

    机器人将自动接收到来自码道Agent Space的反馈信息。此外,在Slack客户端还支持使用7中自定义的斜杠命令来触发相应功能,操作更加便捷。

  3. 根据反馈消息确认任务需求及关键信息,完成任务的创建。
  4. 查看任务执行结果。

    • 在Slack机器人端:Slack机器人接收到来自码道Agent Space的完成反馈,提示任务执行结束并附带产物位置。
    • 在码道Agent Space侧:在码道Agent Space界面的“IM消息 > Slack消息”中,您可以实时查看任务执行过程及结果。单击会话聊天界面右上方的产物面板图标 ,即可在任务产物列表中查看生成的交付件。