飛書機器人接入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分鐘左右。

配置事件回調

配置飛書應用的事件訂閱和回調方式，使機器人能夠接收使用者訊息。

登入飛書開放平台，在右上方單擊開發人員後台並進入對應的應用，在左側導覽列單擊事件與回調。單擊事件配置頁簽，訂閱者式選擇長串連，單擊儲存。
在事件配置頁簽的已添加事件中，添加接收訊息事件並確認。
在回調配置頁簽的訂閱者式中，設定使用長串連接收回調，單擊儲存。

發布飛書應用

完成上述配置後，需要發布應用使其生效。在左側導覽列單擊版本管理與發布，單擊右上方建立新版本，填寫版本號碼和更新說明等資訊後，在頁面底部單擊儲存並確認發布。

添加並驗證機器人

您可以在群聊（建立新群聊或在已有群聊）中添加機器人，或直接私聊機器人與機器人對話，查看效果。

進入飛書群設定頁面，單擊群機器人，在機器人管理頁面，單擊右上方的添加。在搜尋文字框中輸入目標機器人名稱，並選中要添加的機器人單擊添加即可。
在飛書群中@機器人進行交流互動。也可以在飛書的搜尋欄中，輸入機器人名稱後，在功能頁搜尋到對應機器人，進行私聊互動。