> For the complete documentation index, see [llms.txt](https://doc.duaer.com/zh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/zh/knowledge/sources/feishu.md).

# 把飞书接进 Duaer 知识库

索引飞书知识库、云文档、多维表格和云空间文件，可选群聊消息和妙记，权限沿用飞书的分享设置；员工还可以直接在飞书里问 Duaer。
## Duaer 在飞书里读什么

Duaer 读取飞书应用能打开的知识空间和云空间文件夹，可以在「选择索引范围」里只留一部分。

- 云文档：全文。
- 多维表格：每张表的记录，每张表最多 2,000 条。
- 知识库和云空间里的文件：TXT、Markdown、CSV、TSV、JSON、PDF、Word（.docx）、Excel（.xlsx）和 PowerPoint（.pptx），不超过 20 MB。电子表格、幻灯片、思维笔记、旧版文档、其他格式和更大的文件只按标题索引，来源卡片上会按原因计数。
- 群聊消息（需要打开）：机器人所在群最近 30 天的消息，只收人发的文字，不收文件和图片，只有群成员能搜到。应用需要开通 im:message.group_msg 和 im:chat:readonly。
- 妙记（需要打开）：成员近 90 天拥有或参与的妙记，包括总结、待办、章节和文字记录，只有妙记的所有者和参与者能搜到。按 Duaer 已对应到飞书账号的成员逐一查找，每小时更新一次。应用需要开通 minutes:minutes.search:read、minutes:minutes.basic:read 和 minutes:minutes.artifacts:read；缺少权限时数据来源里会列出并给出开通链接。

每次索引最多读 5,000 项。

## 怎么接入飞书

1. 在飞书开放平台为公司建一个企业自建应用，开通知识库、云文档、云空间、多维表格和通讯录的读取权限，并把应用加到要索引的知识空间和文件夹里。
2. 在 Duaer 里新建“飞书 Tenant Token API”凭证，填入应用的 App ID 和 App Secret。建议把凭证放在团队项目里，方便其他管理员维护。
3. 所有者或管理员打开侧边栏「数据来源」，点「添加数据来源」，选「飞书」，在「添加为」里选「知识来源」，再选择这个凭证，点「连接」。连接后马上开始索引。
4. 可选：点「选择索引范围」，勾选要保留的知识空间和云空间文件夹。
5. 复制来源上的「成员登录用的重定向 URL」，加到飞书应用的「安全设置 → 重定向 URL」里。不加的话，成员关联账号时会报错 20029。
6. 问一个答案就在飞书文档里的问题，看出处能不能打开那份文档。

## 谁能搜到哪份文档

Duaer 沿用飞书的分享设置。一份文档只有它在飞书里分享给的人、部门（含下级部门）和群能搜到。设成「组织内获得链接的人可阅读」的，所有已对应到飞书的成员都能搜到；设成「互联网上获得链接的人可阅读」的，在 Duaer 里也只开放到本组织。权限里的用户组 Duaer 无法展开，不开放给任何人。

成员按邮箱对应到飞书账号。来源卡片显示「多少位成员中多少位已对应到飞书」，点「查看成员」能看到谁还没对应上。成员可以在 Duaer 员工端的「知识库」里点「关联飞书账号」自己关联，管理员也可以点「指定」，填他在飞书里的邮箱或手机号。没对应上的成员搜不到飞书的任何内容。

## 改动多久能搜到

- 改过的文档每 10 分钟重读一次。
- 每份文档谁能看，每小时重读一次，所以取消分享最晚一小时内生效。
- 打开「实时更新」后，文件一改就重新索引。还需要按来源上列出的事件，在飞书应用的「事件与回调」里订阅。
- 「立即索引」马上开始一次索引；「断开连接」会把飞书的内容全部移出知识库。

## 在飞书里问 Duaer

1. 在飞书来源上打开「在飞书里问 Duaer」，填入应用的 Verification Token 和 Encrypt Key。
2. 在飞书应用的「事件与回调」里，事件和回调都填来源上显示的请求地址，订阅「接收消息」事件、添加「卡片回传交互」回调，并开启机器人能力。
3. 员工私聊机器人，或在群里 @ 它提问。

回答带出处，只用提问的人自己能看的内容。机器人也能回答他自己的卡片、事项和关注的指标；要它做事时，它发一张卡片，点「执行」或「取消」。打开「把卡片私信给负责人」后，工作流程生成的卡片会发到负责人的飞书里，一键就能处理。

## 有哪些限制

- 每次索引最多 5,000 项，多维表格每张表最多 2,000 条，文件不超过 20 MB。
- 群聊最多 200 个，只保留最近 30 天。
- Duaer 不修改飞书里的内容。员工在员工端点「存到飞书云文档」只会新建一份归他本人的文档，见 [Duaer 员工端](/zh/organizations/employee-portal.md)。
- 飞书审批和多维表格也可以作为流程数据来源，见 [添加流程数据来源](/zh/build/process-sources.md)。
## Questions

### 为什么有的飞书文件只能按标题搜到？

它是 Duaer 不读正文的类型（比如电子表格或幻灯片）、超过 20 MB，或读取失败。来源卡片会按原因计数。

### 成员关联飞书账号时报错 20029 怎么办？

飞书应用里缺少成员登录用的重定向 URL。把来源上显示的地址加到「安全设置 → 重定向 URL」。

### 来源提示飞书应用缺少权限怎么办？

点「去开放平台开通」，开通提示里任意一个权限，再点「立即索引」。

## 相关

- [可以接进 Duaer 知识库的知识来源](https://doc.duaer.com/zh/knowledge/sources.md)
- [管理员上线清单：把 Duaer 用到全公司](https://doc.duaer.com/zh/knowledge/set-up.md)
- [把企业微信接进 Duaer 知识库](https://doc.duaer.com/zh/knowledge/sources/wecom.md)
- [把钉钉接进 Duaer 知识库](https://doc.duaer.com/zh/knowledge/sources/dingtalk.md)
- [AI 搜索怎么守住文档权限：Duaer 沿用原系统的权限](https://doc.duaer.com/zh/guides/permission-aware-ai-search.md)