在飞书中连接数据智能体

把一个智能体接到飞书群,用户就能在群里 @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,在 频道 下拉里选 飞书(下拉是「不启用 / 飞书 / Slack」三选一)。弹出的凭证对话框里填: 点 保存,飞书即成为该智能体当前生效的平台。保存后在下方 通用配置 里还能调两个开关:

​

7. 验证连接

保存后,频道 卡片里会显示连接状态:

• 绿点 已连接 → 凭证正确,WebSocket 已建立
• 黄点 连接中 → 正在握手,等几秒
• 红点 错误 → 凭证错误或飞书侧拒绝了连接,根据脱敏错误摘要核对 App ID / Secret 和应用是否已发布

状态每 5 秒自动更新。刷新 只会重新读取状态,不会主动重连;掉线重连由飞书 SDK 负责。绿点表示凭证有效且当前长连接存活,不代表 Agent 处理和回复投递一定成功。 发送一条测试消息后,查看卡片里的 最近消息。主界面会按「接收消息 → 处理中 → 已回复」展示进度;没有最新消息通常是事件订阅、应用权限或机器人入群有问题。点击「详情」后,处理失败表示 Agent 任务异常,回复失败表示飞书投递异常。

​

8. 把机器人加进飞书群

回到飞书,在目标群里:

1. 输入 @,选择 添加机器人
2. 搜索刚才发布的应用名,选中并确认
3. 在群里 @刚加进来的机器人 你的问题,例如「上个月销售额最高的 5 个产品是什么」

机器人会回复一张消息卡片,展示分析结果。

​

9. 后续步骤

• 想控制谁能问、谁能看到哪些数据 → 如何在飞书配置人员和角色权限
• 还没接好数据源 → 连接数据源
• 想给字段加业务说明、提高 AI 准确度 → 表、字段备注