@ 机器人，就能拿到数据答案。流程分两边：飞书开放平台建应用、给权限、发布，AskTable 这边在智能体的「频道」里填凭证并看连接状态。
开始前
- 权限：AskTable 侧项目角色需要是「所有者」或「成员」；飞书侧需要企业管理员或应用管理员，自建应用要管理员审核通过才在企业内生效。
- 前置：项目里已有数据源和配好的数据智能体，见创建并配置数据智能体。
- 先想清楚开放范围：不限范围时，任何能进群的飞书用户都能问数；要按人限制就走白名单，见控制飞书渠道用户的数据权限。
- 私有部署：主 compose 不含飞书网关，要单独加
asktable-feishu-gateway容器，见部署飞书网关。SaaS 不需要。 - 入口：左侧主导航 → 「更多」 → 打开目标智能体 → 顶部标签「频道」。
操作步骤
1
在飞书开放平台创建自建应用
进入 open.feishu.cn 的开发者后台，创建企业自建应用，填名称、图标、描述。进应用后在「凭证与基础信息」页记下两个值：
- App ID：公开标识，形如
cli_xxxxxxxx。 - App Secret：应用密钥，只在配置时使用，不要提交到代码仓库或放进截图。
2
启用机器人能力
在应用后台「添加应用能力」里开启「机器人」。少了这一步，群里
@ 不到这个应用。3
配置事件订阅，用长连接
进「事件与回调」，把订阅方式设为长连接。AskTable 通过 WebSocket 长连接收消息，不需要在飞书后台填 Webhook 地址。订阅事件「接收消息 v2.0」（
im.message.receive_v1）。如果飞书后台开了消息加密，把 Encrypt Key 和 Verification Token 一起记下来，第 6 步要填。4
开消息权限，要按人限制时再加通讯录权限
在「权限管理」 → 「API 权限」里开启两类消息权限：
要按人限制数据范围时，再加通讯录权限
contact:user.employee_id:readonly：白名单按飞书 user_id 匹配，缺这个权限消息里拿不到 user_id，用户会被直接拒且不会进「待审批」。需要显示姓名、邮箱、头像时，再按飞书官方文档补 contact:user.base:readonly。5
发布应用
在「版本管理与发布」创建版本并提交审核。审核通过后机器人才在企业内可用。建议先把应用加进测试群，不要一开始就发布到全员可见范围。
6
在 AskTable 打开「飞书」频道并填凭证
入口：左侧主导航 → 「更多」 → 打开目标智能体 → 标签「频道」。第一张卡是「飞书」，副标题说明可以把这个智能体接到飞书、通过飞书 IM 对话。打开右侧开关，展开表单。「凭证配置」四个字段：
编辑已有频道时，密钥框留空即保持原值，只改哪项就填哪项。
7
决定深度推理开关
同一张表单里有个深度推理开关，说明适合复杂任务、模型推理更长时间。默认关闭，也就是走快速模式。打开后，这个频道后续的提问都用更长的推理时间换更稳的复杂分析。这一项不进会话，保存后下一条飞书消息立即生效，不用让用户新建会话。
8
按需要填渠道偏好
渠道偏好的占位符举例是先给结论、使用简洁中文回答，上限 1024 个字符，右下角有字数计数。这段文字会注入这个频道的每一轮提问，用来统一回答风格和口径。填完点「保存」，成功后界面提示创建成功（新建）或更新成功（修改）。
9
看「运行状态」，再到飞书验证
保存后页面下方出现「运行状态」卡：连接状态显示圆点加文字，已连接表示凭证正确、长连接已建立；最后事件显示最近一次事件的时间和内容，没有就是暂无事件。右边「刷新」按钮重查，卡上还有上次检查时间。然后到飞书验证三轮：
- 私聊机器人问一句，确认有回答。
- 把机器人加进测试群，用
@机器人 你的问题再问一次。 - 换一个不同角色的成员提问，确认各自看到的是授权范围内的数据。
10
按人限制数据范围（可选）
频道保存后，「频道」标签下方才出现「人员」区块。打开启用白名单开关，再点「添加人员」，把飞书身份和 AskTable 的人员、角色对上号。新用户第一次提问会被拒，同时自动进「人员」页的「待审批」。完整步骤见控制飞书渠道用户的数据权限。
关键约束
出问题怎么判断
下一步
- 决定谁能问、谁能看到哪些数据：控制飞书渠道用户的数据权限
- 定时把分析结论推到飞书群：定时分析报告
- 私有部署补上飞书网关容器：部署飞书网关