钉钉机器人接入RDS AI助手

RDS AI助手专业版支持钉钉机器人接入,您可以在钉钉APP内通过与机器人对话的方式,使用RDS AI助手,智能管理与运维RDS实例。

流程概述

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

  1. 创建并配置钉钉机器人,完成权限配置与应用发布。

  2. 配置服务端环境并启动服务。

  3. 在钉钉群组或单聊内使用RDS AI助手。

重要

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

一、创建、配置与发布钉钉机器人

1. 创建应用

登录钉钉开放平台,在右上角单击开发者后台。进入后台后,在应用开发 > 钉钉应用中,单击创建应用,依次填入应用名称、应用描述与应用图标(可选),单击确定创建。

image

2. 添加并配置机器人

应用创建完成后,单击添加机器人。在机器人配置页面,按要求填写机器人名称、机器人图标、简介和功能描述。在消息接收模式中,选择 Stream模式,然后单击发布。

image

3. 配置权限

在左侧导航栏单击权限管理,进入权限配置页面。您需要为应用申请以下三个权限:

  • 企业内机器人发送消息权限

  • 互动卡片实例写权限

  • AI卡片流式更新权限

在权限列表中找到对应权限并单击立即开通。

image

4. 发布应用版本

在左侧导航栏单击版本管理与发布,单击右上角创建新版本。填写版本描述,根据需要选择应用可用范围,然后单击直接发布。

发布完成后,版本状态会切换成已上线。

image

二、配置服务端环境

1.下载示例代码

下载dingding-examples.zip示例代码至本地服务器。

2.安装项目依赖

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

python3 -m venv venv && source venv/bin/activate && pip install -r requirements.txt

3.查找并配置环境变量

在启动服务前,需要配置好服务相关的环境变量

1.Dingding Client ID / Client Secret

登录钉钉开放平台并进入您创建的应用后台。在左侧导航栏单击基础信息,在凭证与基础信息页面中,获取应用的 Client ID 和 Client Secret。

image

2.Aliyun AccessKey ID / AccessKey Secret

登录阿里云官网,将鼠标悬浮在右上角头像处,在弹框中单击AccessKey管理,获取AccessKey IDAccessKey Secret。

说明

建议您使用RAM用户的AccessKey以避免主账号密钥泄露带来的安全风险。

image

4.查找并配置环境变量

export ACCESS_KEY_ID="your_aliyun_access_key_id"
export ACCESS_SECRET="your_aliyun_access_key_secret"
export DINGTALK_APP_CLIENT_ID="your_dingding_client_id"
export DINGTALK_APP_CLIENT_SECRET="your_dingding_client_secret"

5.执行以下代码运行脚本

python main.py

三、在钉钉内使用RDS AI助手

群组内接入机器人

1.添加机器人

进入钉钉APP并选择需要添加机器人的群组,在群设置内单击机器人,然后选择添加机器人。在列表中搜索并添加您在步骤一中创建的机器人。

image

2.与机器人对话

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

单聊机器人

1.搜索机器人

进入钉钉APP,在顶部的搜索框中输入您在步骤一中创建的机器人名称,单击进入聊天界面。

image

2.与机器人对话

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