把飞书接进 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 员工端。
• 飞书审批和多维表格也可以作为流程数据来源，见 添加流程数据来源。