@bot 用自然语言查数据。整个流程分两边:飞书开放平台(建应用、给权限)和 AskTable(填凭证、加进群)。
前置条件
- 飞书企业有 管理员权限(自建应用需要管理员审批后才能用)
- 已经在 AskTable 中创建好一个智能体,并且配好了数据源和技能。如果还没有,先去 数据智能体 列表新建一个
1. 在飞书开放平台创建自建应用
进入 open.feishu.cn → 开发者后台 → 创建企业自建应用。 填好应用名称、图标、描述后保存。进入应用后,在 凭证与基础信息 页面找到下面两个值,先记下来:2. 启用机器人能力
在应用后台左侧 添加应用能力 → 开启 机器人。机器人能力是飞书群里能@ 到你的应用的前提。
3. 配置事件订阅
进入 事件与回调 → 事件配置。AskTable 采用 长连接 模式接收事件,不需要 在飞书后台填 Webhook URL,飞书会通过 WebSocket 把消息推到 AskTable 内置的网关。 需要订阅的事件:- 接收消息 v2.0 (
im.message.receive_v1) —— 让机器人收到群里和私聊里的消息
4. 配置 API 权限
在 权限管理 → API 权限 中开启下面两个权限,这是「能在群里问数」的最小集:5. 发布并审核应用
在 版本管理与发布 中创建一个版本,提交审核。飞书管理员审核通过后,应用才会在企业内生效。6. 在 AskTable 中填入凭证
回到 AskTable,进入对应数据智能体的详情页,切到顶部的 频道 Tab,把 飞书 开关打开。展开的表单填:
点 保存。
7. 验证连接
保存成功后,下方会出现 运行状态 面板:- 连接状态 显示绿点 已连接 → 凭证正确,WebSocket 已建立
- 黄点 连接中 → 正在握手,等几秒
- 红点 错误 → 凭证错误或飞书侧拒绝了连接,点 刷新 重试,仍然失败的话回去核对 App ID / Secret 和应用是否已发布
8. 把机器人加进飞书群
回到飞书,在目标群里:- 输入
@,选择 添加机器人 - 搜索刚才发布的应用名,选中并确认
- 在群里
@刚加进来的机器人 你的问题,例如「上个月销售额最高的 5 个产品是什么」
9. 后续步骤
- 想控制谁能问、谁能看到哪些数据 → 如何在飞书配置人员和角色权限
- 还没接好数据源 → 连接数据源
- 想给字段加业务说明、提高 AI 准确度 → 表、字段备注