#飞书机器人

Data Agent 支持接入飞书机器人。接入后，用户可以在飞书私聊或群聊中直接向机器人提问，机器人会调用 Data Agent 的智能问答能力，并把结果回复到飞书。

#可以做什么

• 在飞书私聊中向机器人提问。
• 在飞书群聊中向机器人提问，机器人会回复对应消息。
• 复用 Data Agent 中已有的用户、角色和空间权限。
• 自动记录飞书来源的问答会话，便于后续追踪。
• 支持返回文字、数据结果、图表或报告卡片等内容。

#基本流程

飞书机器人收到用户消息后，会按以下流程处理：

1. 判断消息是否需要处理，例如只处理用户发送的文本消息。
2. 识别飞书用户，并找到对应的 Data Agent 用户。
3. 根据用户权限和所属空间调用 Data Agent 智能问答。
4. 保存本次问答会话和消息记录。
5. 将回答发送回飞书私聊或群聊。

#用户绑定

机器人需要知道“当前飞书用户对应哪个 Data Agent 用户”，才能按正确权限回答问题。

系统会优先查找已有绑定关系。如果没有绑定，会尝试根据飞书通讯录信息自动匹配 Data Agent 用户，例如：

• 邮箱
• 企业邮箱
• 手机号
• 姓名
• 英文名
• 昵称

其中邮箱、企业邮箱和手机号更可靠；姓名、英文名和昵称只有在能唯一匹配到一个用户时才会自动绑定。

如果无法确认用户身份，机器人会提示用户完成绑定。绑定完成后，用户再次向机器人提问即可正常使用。

#权限规则

飞书机器人不会绕过 Data Agent 的权限体系。

用户通过飞书提问时，系统会使用该用户在 Data Agent 中已有的：

• 用户身份
• 角色权限
• 所属空间

因此，用户在网页端不能访问的数据，通过飞书机器人同样不能访问。

#会话记录

飞书机器人会为用户维护独立会话：

• 私聊中，同一用户会复用自己的私聊会话。
• 群聊中，同一用户在不同群聊会分别建立会话。
• 群聊中，不同用户不会共享同一个问答会话。

这些会话会被标记为飞书来源，方便在系统中区分网页端对话和飞书机器人对话。

飞书机器人会保留最近活跃的会话。超过 12 小时没有新消息的会话会被自动清理；用户再次提问时，系统会重新建立会话。

#回复方式

机器人会根据聊天场景选择回复方式：

• 私聊：直接发送新消息。
• 群聊：回复用户发出的那条消息。

如果回答中包含数据查询结果，机器人可能会继续发送数据卡片、图表卡片或报告卡片。

#常见问题

#机器人没有回复

请检查：

• 飞书应用是否已启用机器人能力。
• 飞书应用配置是否完整。
• 机器人是否已经被添加到对应群聊。
• 用户发送的是否是文本消息。
• 群聊中是否发送了 @all 或 @所有人，这类消息会被忽略。

#用户收到绑定提示

说明系统还不能确认该飞书用户对应哪个 Data Agent 用户。

请检查：

• Data Agent 中是否存在该用户。
• 用户邮箱、手机号或姓名是否与飞书通讯录一致。
• 是否已经完成飞书账号绑定。

#用户能提问但查不到数据

请检查：

• 用户是否属于正确空间。
• 用户角色是否拥有对应数据权限。
• 网页端使用同一账号是否能查到同样的数据。

#群聊里部分人可以用，部分人不能用

通常是用户绑定或权限不同导致的。请分别检查这些用户在 Data Agent 中的账号、角色和空间配置。