# 控制飞书渠道用户的数据权限

配置飞书用户的身份与角色，控制数据访问范围并排查权限问题。

飞书频道启用后，可联系机器人的用户默认可以提问。需要限制访问时，应启用智能体白名单，并为飞书用户配置人员档案和角色。

## 开始前

- 权限：修改频道和人员授权需要项目负责人或项目管理员权限。
- 前置：这个智能体已经启用飞书频道（「凭证配置」里填了 App ID 和 App Secret 并保存）。频道没启用时，「频道」标签下不会出现「人员权限」区块。
- 飞书侧：白名单按 user\_id 匹配，飞书应用必须开通 `contact:user.employee_id:readonly`，白名单开启而无法取得 user\_id 时，消息会在身份识别阶段被拒，且不会进入待审批。
- 入口：左侧主导航 → 「更多」→ 打开目标智能体 → 顶部标签「频道」。

## 操作步骤

**确认飞书频道已启用**

在「频道」标签的「平台」下拉中选择「飞书」。首次启用时填写凭证：App ID 和 App Secret 新建时必填，Encrypt Key 和 Verification Token 选填。编辑已有凭证时，表单会回填保存的配置，必填项仍不能留空；保存会更新整组凭证。填完点「保存」，保存成功后才启用飞书；取消会保留原来的平台。

**决定是否打开深度推理**

「通用配置」里有一个深度推理开关，说明写着适合复杂任务、模型推理更长时间，默认关闭，也就是快速模式。打开后，这个频道后续的提问都会用更长的推理时间换更稳的复杂分析。开关即时保存，对后续提问生效。

**填渠道偏好**

「渠道偏好」文本框用来写这个频道的回答偏好（比如先给结论、用简洁中文回答），最多 1024 个字符，右下角有字数计数。离开输入框后保存，这段偏好会用于这个频道的每一轮提问。

**打开白名单**

频道保存后，页面下方才出现「人员权限」区块。顶部是启用白名单开关，开关下方的提示随状态切换：关闭时说明能联系该机器人的飞书用户都能问数，打开后说明只有白名单内的人可以访问；开关关闭时，下面的列表整体置灰、不可操作，并提示白名单未开启、所有人都可访问。

**把人和角色加进白名单**

点「添加人员」打开「添加人员到智能体白名单」，选好人员和角色，点「授权」。角色不选时下拉显示「不选择任何角色」，并提示不选角色时用户默认使用该数据智能体的访问范围、可访问它已配置的全部数据范围；授权完成后，列表的角色列对这种记录会标注不指定角色即全权。角色带必填变量时，弹窗会要求把 dept\_id 这类变量填完才能提交。

**在「待审批」里建档**

白名单开启时，能识别身份但尚未建档或授权的用户提问会被拒，并进入「人员」页的「待审批」标签页。每条记录左边是头像、姓名（拿不到时显示 user\_id）、状态徽标和「飞书」标签，下面一行是 user\_id；右侧三列是联系方式、申请访问和最近申请，最右边是「拒绝」和「建档 / 关联」（已建档的显示「分配权限」）。

点「建档 / 关联」打开「为「张三」建档」弹窗：顶部「飞书账号信息」区显示头像、姓名、邮箱、手机和 user\_id；下面选「新建人员档案」（姓名、邮箱、手机会预填）或「关联到已有人员」（按姓名搜索已有档案）。点「建档」完成。

**分配角色**

建档完成后接着弹出分配权限的对话框，标题形如「为「张三」分配 门店经营分析师 的权限」；选好角色后点「授权」，暂时不配就点「稍后分配」。到这一步，这个飞书用户再提问就会按角色的规则放行。

**撤销或清空**

- 只撤销某个智能体的访问：在该智能体「频道」 → 「人员权限」区块里，点这条记录右侧的删除图标，确认按钮是「移除」。
- 彻底清除这个人：人员详情页 → 「危险操作」 → 「删除人员」，确认后相关绑定和授权会一并清除；白名单开启时，之后再问数会重新走「待审批」。

## 关键约束

| 项目                             | 值或默认                     | 在哪里改                  |
| ------------------------------ | ------------------------ | --------------------- |
| 启用白名单                          | 默认关闭；关闭时能联系该机器人的飞书用户都可问数 | 智能体详情 → 「频道」 → 「人员权限」 |
| 深度推理                           | 默认关闭（即快速模式）              | 智能体详情 → 「频道」 →「通用配置」  |
| 渠道偏好                           | 最多 1024 个字符，默认空          | 智能体详情 → 「频道」 →「通用配置」  |
| App ID、App Secret              | 新建频道时必填                  | 「频道」 →「凭证配置」          |
| Encrypt Key、Verification Token | 选填                       | 「频道」 →「凭证配置」          |
| 人员与角色的对应                       | 每个人员一条授权，可各带一组角色变量       | 「人员权限」区块 → 「添加人员」     |
| 不指定角色时                         | 等于全权，按智能体自身的数据范围         | 「添加人员」弹窗里把角色留空        |
| 停用频道                           | 停止接收新消息，保留飞书凭证与平台配置      | 「频道」 →「平台」选择「不启用」     |

## 出问题怎么判断

| 现象                                                  | 判定条件                                   | 处理                                                                               |
| --------------------------------------------------- | -------------------------------------- | -------------------------------------------------------------------------------- |
| 用户提问被拒，提示没有权限访问、信息已提交待管理员审批                         | 这个飞书 user\_id 在 AskTable 里还没有人员档案和渠道绑定 | 到「人员」 → 「待审批」点「建档 / 关联」，建档后接着「分配权限」                                              |
| 用户提问被拒，提示未被授权访问此 Agent                              | 档案已建，但这个智能体的白名单里没有他                    | 在该智能体「频道」 → 「人员权限」 → 「添加人员」补上                                                    |
| 用户提问被拒，提示飞书应用未开通 contact:user.employee\_id:readonly | 飞书应用缺该权限，消息里拿不到 user\_id；这种情况不会进「待审批」  | 在飞书开放平台补权限并重新提交应用版本，再让用户重试                                                       |
| 用户提问被拒，提示该智能体已被删除或不可用                               | 频道绑定的智能体已经被删                           | 重新绑定频道，或停用频道                                                                     |
| 「待审批」记录的联系方式显示未提供                                   | 飞书没有返回邮箱和手机                            | 在飞书开放平台补通讯录用户信息读取权限并重新发布版本，再让用户提问刷新                                              |
| 刚改完授权，群里还是按旧范围回答                                    | 这位用户的上一条消息发生在授权变更之前，复用了旧会话             | 让他再发一条消息，系统会重建会话；授权变更时该智能体下的飞书会话会被清掉                                             |
| 关掉白名单后所有人都能问数                                       | 启用白名单开关是关的，区块提示白名单未开启                  | 打开开关，再逐个「添加人员」                                                                   |
| 打开白名单后没人能问                                          | 启用白名单开关是开的，列表为空并提示尚未授权任何人员             | 「添加人员」补上授权                                                                       |
| 频道连接状态异常                                            | 当前平台不是已连接；连接健康与消息处理、回复投递是不同状态          | 点「刷新」重查，核对凭证与应用版本；具体消息失败见[飞书接入排查](https://docs.asktable.com/integrations/feishu) |

## 下一步

- 先把策略和角色建好，再回来分配：/permissions
- 创建并配置数据智能体：/agent/overview
- 飞书频道的完整接入步骤（应用、事件订阅、权限发布）：/integrations/feishu