> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asktable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 在飞书中连接数据智能体

> 从飞书开放平台建应用、配置权限,到 AskTable 中填入凭证,把数据智能体接入飞书群,完成端到端的群内问数。

把一个智能体接到飞书群,用户就能在群里 `@bot` 用自然语言查数据。整个流程分两边:**飞书开放平台**(建应用、给权限)和 **AskTable**(填凭证、加进群)。

## 前置条件

* 飞书企业有 **管理员权限**(自建应用需要管理员审批后才能用)
* 已经在 AskTable 中创建好一个智能体,并且配好了数据源和技能。如果还没有,先去 **数据智能体** 列表新建一个

## 1. 在飞书开放平台创建自建应用

进入 [open.feishu.cn](https://open.feishu.cn) → **开发者后台** → **创建企业自建应用**。

填好应用名称、图标、描述后保存。进入应用后,在 **凭证与基础信息** 页面找到下面两个值,先记下来:

| 字段             | 说明                     |
| -------------- | ---------------------- |
| **App ID**     | 形如 `cli_xxxxxxxx`,公开标识 |
| **App Secret** | 应用密钥,只显示一次,泄露要立刻重置     |

## 2. 启用机器人能力

在应用后台左侧 **添加应用能力** → 开启 **机器人**。机器人能力是飞书群里能 `@` 到你的应用的前提。

## 3. 配置事件订阅

进入 **事件与回调** → **事件配置**。AskTable 采用 **长连接** 模式接收事件,**不需要** 在飞书后台填 Webhook URL,飞书会通过 WebSocket 把消息推到 AskTable 内置的网关。

需要订阅的事件:

* **接收消息 v2.0** (`im.message.receive_v1`) —— 让机器人收到群里和私聊里的消息

## 4. 配置 API 权限

在 **权限管理** → **API 权限** 中开启下面两个权限,这是「能在群里问数」的最小集:

| 权限                                 | 作用               |
| ---------------------------------- | ---------------- |
| `im:message`                       | 获取与发送单聊、群组消息     |
| `im:message.group_at_msg:readonly` | 获取群组中用户 @机器人 的消息 |

<Tip>
  **要做权限管控?**

  如果还想按人 / 按部门控制不同用户能问到的数据,需要再开通 3 个通讯录权限。具体见 [如何在飞书配置人员和角色权限](/how-to/feishu-permissions)。
</Tip>

## 5. 发布并审核应用

在 **版本管理与发布** 中创建一个版本,提交审核。飞书管理员审核通过后,应用才会在企业内生效。

## 6. 在 AskTable 中填入凭证

回到 AskTable,进入对应数据智能体的详情页,切到顶部的 **频道** Tab,把 **飞书** 开关打开。展开的表单填:

| 字段                     | 必填 | 说明                                            |
| ---------------------- | -- | --------------------------------------------- |
| **App ID**             | 是  | 第 1 步记下的值                                     |
| **App Secret**         | 是  | 第 1 步记下的值                                     |
| **Encrypt Key**        | 否  | 仅当你在飞书后台的「事件与回调 > 加密策略」开启了消息加密时才填,且要和飞书后台保持一致 |
| **Verification Token** | 否  | 同上,通常不用                                       |

点 **保存**。

## 7. 验证连接

保存成功后,下方会出现 **运行状态** 面板:

* **连接状态** 显示绿点 **已连接** → 凭证正确,WebSocket 已建立
* 黄点 **连接中** → 正在握手,等几秒
* 红点 **错误** → 凭证错误或飞书侧拒绝了连接,点 **刷新** 重试,仍然失败的话回去核对 App ID / Secret 和应用是否已发布

<Tip>
  **频道是否启用**

  只要 **飞书** 开关是开的,即便没人在群里说话,连接状态也应该长期保持「已连接」。如果出现频繁掉线,通常是 App Secret 被你在飞书后台重置过但 AskTable 这边没更新。
</Tip>

## 8. 把机器人加进飞书群

回到飞书,在目标群里:

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

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

## 9. 后续步骤

* 想控制谁能问、谁能看到哪些数据 → [如何在飞书配置人员和角色权限](/how-to/feishu-permissions)
* 还没接好数据源 → [连接数据源](/concepts/data/connect)
* 想给字段加业务说明、提高 AI 准确度 → [表、字段备注](/concepts/data/annotations)