跳到主要内容

对接飞书机器人

概述

通过对接飞书机器人,用户可在飞书端直接向 ChatBI 发起智能问数,提升数据获取效率。

操作步骤

创建飞书机器人

在飞书开放平台创建企业自建应用,获取机器人对接所需的 App ID、App Secret 等凭据。

  1. 访问 飞书开放平台,点击「开发者后台」进入管理页面后点击「创建企业自建应用」。

  2. 填写应用信息后完成创建。

  3. 在应用详情页,点击「添加应用能力」,选择「机器人」能力并添加。

  4. 进入「权限管理 」页面,为应用开通以下 3 个权限:「读取用户发给机器人的单聊消息」「以应用的身份发消息」「获取用户 user ID」。

    开通完成后,权限列表状态将更新为「已开通」。

  5. 进入「事件与回调」,完成以下配置。

    • 订阅方式:选择「使用长连接接收事件」,点击「保存」。

    • 消息接收事件:点击「添加事件」,搜索「接收消息」,勾选「接收消息 v2.0」,点击「添加」。

  6. 进入「版本管理与发布」,点击「创建版本」。在可用范围设置中选择「全部成员」并确认,完成版本发布。

    发布完成后,应用状态将更新为「已发布」。

  7. 进入「凭证与基础信息」,记录「App ID」和「App Secret」,智能体管理后台配置飞书机器人 时需要用到。

智能体管理后台配置飞书机器人

在 ChatBI 智能体管理中将飞书机器人与主题绑定,实现飞书端智能问数。

  1. 登录 Data Agent(原 ChatBI 后台),进入「智能体管理 > 智能体详情配置 > 基础信息 > 第三方机器人」页面,点击「添加飞书机器人」。

  2. 填写机器人名称、App ID 和 App Secret,测试连接通过后点击「添加」。

    添加完成后,页面将显示已添加的机器人信息。

观远管理中心关联飞书账户

只有关联了飞书账号的用户,才可以在飞书客户端使用飞书机器人,飞书账号如何关联可参考 关联飞书账号

飞书客户端问数

配置完成后,关联了飞书账号的 BI 用户可在飞书中与机器人私聊,发起智能问数。

  1. 在飞书客户端搜索机器人名称,进入私聊窗口。

  2. 输入问题,机器人将返回对应的查询结果。

注意
  • 用户的 BI 账号需已关联飞书账号。
  • 用户需拥有对应智能体的使用权限,否则无法返回查询结果。

效果展示

说明

目前飞书客户端支持返回 单柱图、单条图、单线图、饼图、多线图、簇状图、堆积图、分组堆积图、百分比堆积图、簇状 + 折线图、堆积 + 折线图、堆积 + 符号图、表格 这 14 种图表类型。

下面举几个常见图表类型的示例。

单线图

单柱图

单条图

饼图