跳到正文
AskTable

文档反馈

当前页面控制飞书渠道用户的数据权限/permissions/feishu

0 / 5,000

反馈将发送给维护团队。

前往控制台
前往控制台

配置与管理

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

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

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

开始前

  • 权限:修改频道和人员授权需要项目负责人或项目管理员权限。
  • 前置:这个智能体已经启用飞书频道(「凭证配置」里填了 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;这种情况不会进「待审批」在飞书开放平台补权限并重新提交应用版本,再让用户重试
用户提问被拒,提示该智能体已被删除或不可用频道绑定的智能体已经被删重新绑定频道,或停用频道
「待审批」记录的联系方式显示未提供飞书没有返回邮箱和手机在飞书开放平台补通讯录用户信息读取权限并重新发布版本,再让用户提问刷新
刚改完授权,群里还是按旧范围回答这位用户的上一条消息发生在授权变更之前,复用了旧会话让他再发一条消息,系统会重建会话;授权变更时该智能体下的飞书会话会被清掉
关掉白名单后所有人都能问数启用白名单开关是关的,区块提示白名单未开启打开开关,再逐个「添加人员」
打开白名单后没人能问启用白名单开关是开的,列表为空并提示尚未授权任何人员「添加人员」补上授权
频道连接状态异常当前平台不是已连接;连接健康与消息处理、回复投递是不同状态点「刷新」重查,核对凭证与应用版本;具体消息失败见飞书接入排查

下一步

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