开始前
- 权限：项目角色需要是「所有者」或「成员」。
- 前置：这个智能体已经启用飞书频道（「凭证配置」里填了 App ID 和 App Secret 并保存）。频道没启用时，「频道」标签下不会出现「人员」区块。
- 飞书侧：白名单按 user_id 匹配，飞书应用必须开通
contact:user.employee_id:readonly，否则消息在识别身份这一步就被拒。 - 入口：左侧主导航 → 「更多」→ 打开目标智能体 → 顶部标签「频道」。
操作步骤
1
确认飞书频道已启用
「频道」标签下是「飞书」卡片，副标题说明把智能体接到飞书、通过飞书 IM 对话。打开开关后填「凭证配置」：App ID 和 App Secret 新建时必填，Encrypt Key 和 Verification Token 选填。修改已有配置时，密钥框留空表示保持不变。填完点「保存」。
2
决定是否打开深度推理
同一张表单里有一个深度推理开关，说明写着适合复杂任务、模型推理更长时间，默认关闭，也就是快速模式。打开后，这个频道后续的提问都会用更长的推理时间换更稳的复杂分析。保存后下一条飞书消息就生效。
3
填渠道偏好
「渠道偏好」文本框用来写这个频道的回答偏好（比如先给结论、用简洁中文回答），最多 1024 个字符，右下角有字数计数。这段偏好会注入这个频道的每一轮提问。
4
打开白名单
频道保存后，页面下方才出现「人员」区块。顶部是启用白名单开关，开关下方的提示随状态切换：关闭时说明任何能进群的飞书用户都能问数，打开后说明只有白名单内的人可以访问；开关关闭时，下面的列表整体置灰、不可操作，并提示白名单未开启、所有人都可访问。
5
把人和角色加进白名单
点「添加人员」打开「添加人员到智能体白名单」，选好人员和角色，点「授权」。角色不选时下拉显示「不选择任何角色」，并提示不选角色时用户默认使用该数据智能体的访问范围、可访问它已配置的全部数据范围；授权完成后，列表的角色列对这种记录会标注不指定角色即全权。角色带必填变量时，弹窗会要求把 dept_id 这类变量填完才能提交。
6
在「待审批」里建档
新用户在飞书里第一次提问会被拒，同时自动进「人员」页的「待审批」标签页。每条记录左边是头像、姓名（拿不到时显示 user_id）、状态徽标和「飞书」标签，下面一行是 user_id；右侧三列是联系方式、申请访问和最近申请，最右边是「拒绝」和「建档 / 关联」（已建档的显示「分配权限」）。点「建档 / 关联」打开「为「张三」建档」弹窗：顶部「飞书账号信息」区显示头像、姓名、邮箱、手机和 user_id；下面选「新建人员档案」（姓名、邮箱、手机会预填）或「关联到已有人员」（按姓名搜索已有档案）。点「建档」完成。
7
分配角色
建档完成后接着弹出分配权限的对话框，标题形如「为「张三」分配 门店经营分析师 的权限」；选好角色后点「授权」，暂时不配就点「稍后分配」。到这一步，这个飞书用户再提问就会按角色的规则放行。
8
撤销或清空
- 只撤销某个智能体的访问：在该智能体「频道」 → 「人员」区块里，点这条记录右侧的删除图标，确认按钮是「移除」。
- 彻底清除这个人：人员详情页 → 「危险操作」 → 「删除人员」，确认后相关绑定和授权会一并清除；之后再问数会重新走「待审批」。
关键约束
出问题怎么判断
下一步
- 先把策略和角色建好，再回来分配：/permissions
- 创建并配置数据智能体：/agent/overview
- 飞书频道的完整接入步骤（应用、事件订阅、权限发布）：/integrations/feishu