飞书机器人接入PolarDB Agent Express - 云原生数据库 PolarDB

PolarDB Agent Express支持通过飞书机器人与AI助手交互。完成飞书应用创建、事件回调配置和用户授权后，即可在飞书中直接使用PolarDB Agent Express的智能对话能力。

流程概述

飞书机器人接入PolarDB Agent Express需要按以下步骤配置：

创建飞书应用并获取凭证。
在PolarDB Agent Express中配置飞书通道。
在飞书应用中配置事件回调，并发布应用。

创建飞书应用

登录飞书开放平台，在右上角单击开发者后台。进入后台后单击创建企业自建应用，填入应用名称、应用描述与应用图标，单击创建。
进入应用管理后台，找到机器人能力，单击添加。

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

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:contact.base:readonly",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

进入凭证与信息页面，分别复制App ID和App Secret，后续需要在PolarDB Agent Express中配置。

配置PolarDB Agent Express飞书通道

将飞书应用的凭证配置到PolarDB Agent Express中，使PolarDB Agent Express能够与飞书机器人建立连接。

登录PolarDB控制台，进入PolarDB Agent Express应用的管理页面。
在通道配置中，启用飞书通道，填入上一步获取的机器人 APP KEY和APP SECRET，单击保存。

重要
保存操作会触发PolarDB Agent Express刷新配置并重启，预计耗时2分钟左右。

配置事件回调

配置飞书应用的事件订阅和回调方式，使机器人能够接收用户消息。

登录飞书开放平台，在右上角单击开发者后台并进入对应的应用，在左侧导航栏单击事件与回调。单击事件配置页签，订阅方式选择长连接，单击保存。
在事件配置页签的已添加事件中，添加接收消息事件并确认。
在回调配置页签的订阅方式中，设置使用长连接接收回调，单击保存。

发布飞书应用

完成上述配置后，需要发布应用使其生效。在左侧导航栏单击版本管理与发布，单击右上角创建新版本，填写版本号和更新说明等信息后，在页面底部单击保存并确认发布。

添加并验证机器人

您可以在群聊（创建新群聊或在已有群聊）中添加机器人，或直接私聊机器人与机器人对话，查看效果。

进入飞书群设置页面，单击群机器人，在机器人管理页面，单击右上角的添加。在搜索文本框中输入目标机器人名称，并选中要添加的机器人单击添加即可。
在飞书群中@机器人进行交流互动。也可以在飞书的搜索栏中，输入机器人名称后，在功能页搜索到对应机器人，进行私聊互动。