飞书机器人接入RDS AI助手

RDS AI助手专业版支持飞书机器人接入,您可以在飞书APP内使用RDS AI助手,智能管理与运维RDS实例。

流程概述

飞书机器人接入RDS AI助手需要按以下步骤配置:

  1. 创建飞书机器人,并配置机器人权限和加密策略。

  2. 使用示例代码配置服务端环境并启动服务。

  3. 配置飞书机器人的事件与回调,并发布飞书机器人。

  4. 在飞书群组或单聊内使用RDS AI助手。

重要

RDS AI助手专业版支持将飞书机器人接入RDS AI助手,配置飞书机器人前请先购买RDS AI助手专业版。

一、创建并配置飞书机器人

1.创建应用

登录飞书开放平台,在右上角单击开发者后台。进入后台后单击创建企业自建应用,填入应用名称应用描述应用图标,单击创建。

image

2.批量配置机器人权限

在左侧导航栏单击权限管理,进入页签后单击批量导入/导出权限,将以下JSON格式权限描述代码复制进导入页签中,单击下一步,确认新增权限,单击申请开通

{
  "scopes": {
    "tenant": [
      "cardkit:card:write",
      "im:chat:readonly",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:send_as_bot"
    ],
    "user": []
  }
}

image

3.配置加密策略

单击左侧导航栏事件与回调,单击加密策略进入相关页签。单击Encrypt Key区域内的刷新按钮重置Encrypt Key。

image

二、配置服务端环境

  1. 下载lark-samples 2.zip示例代码至本地服务器。

  2. 解压该文件并进入解压后的目录中,运行以下代码创建虚拟环境并安装项目依赖。

    python3 -m venv venv && source venv/bin/activate && pip install -r requirements.txt
  3. 查找App ID/App Secret、Encrypt Key/Verification Token、AccessKey ID/AccessKey Secret。

    3.1 App ID/App Secret

    在飞书开放平台左侧导航栏单击凭证与基础信息,在应用凭证中获取App ID、App Secret

    image

    3.2 Encrypt Key/Verification Token

    在飞书开放平台左侧导航栏单击事件与回调,在加密策略中获取Encrypt Key、Verification Token

    image

    3.3 AccessKey ID/AccessKey Secret

    登录阿里云官网,将鼠标悬浮在右上角头像处,在弹框中单击AccessKey,获取AccessKey ID、AccessKey Secret。建议您使用RAM用户的AccessKey避免安全风险。

    image

  4. 运行以下命令将上一步查找的参数填入环境变量中。

    export LARK_APP_ID="your_lark_app_id"
    export LARK_APP_SECRET="your_lark_app_secret"
    export LARK_APP_ENCRYPT_KEY="your_lark_encrypt_key"
    export LARK_APP_VERIFICATION_TOKEN="your_lark_verification_token"
    export ACCESS_KEY_ID="your_aliyun_access_key_id"
    export ACCESS_SECRET="your_aliyun_access_key_secret"
  5. 执行以下代码运行脚本。

    python main.py

三、配置事件与发布机器人

1.配置事件

登录飞书开放平台,在右上角单击开发者后台并进入对应的应用,在左侧导航栏单击事件与回调。单击事件配置页签,订阅方式选择长连接,并添加相关事件(如图所示)。

image

2.配置回调

事件与回调页面中,单击回调配置,订阅方式选择长连接,并订阅相关回调(如图所示)。

image

3.发布机器人

在左侧导航栏单击版本管理与发布,单击右上角创建版本并发布。发布完成后版本状态会切换成已发布。

image

四、使用飞书机器人

群组内接入机器人

1.群组内添加机器人

进入飞书APP并选择需要添加机器人的群组,在设置内单击添加机器人,搜索第一步中创建的机器人名称并添加。

image

2.与机器人对话

在群组引入机器人后,“@”机器人名称,即可进行问答。

image

单聊机器人

1.搜索机器人

进入飞书APP,搜索第一步中创建的机器人名称

image

2.与机器人对话

在对话框中输入需要咨询的问题,单击发送即可。

image