3.5.5 飞书同步
很多企业的产品文档、制度流程沉淀在飞书知识库里。飞书同步让 MoAI 知识库直接绑定飞书的知识空间节点：文档变更自动同步入库，走统一的切割、元数据、向量化管线，应用检索到的永远是最新版本。
前置准备：飞书应用
在飞书开放平台创建一个企业自建应用，拿到 App ID（cli_ 开头）与 App Secret，并给应用开通知识库相关权限（知识空间、节点、文档的读取权限）。企业自建应用需要发布版本后才对成员可见。
创建飞书源
进入知识库的「外部源」，点击「新建飞书源」：
| 字段 | 说明 |
|---|---|
| 名称 / 简介 | 外部源的显示信息 |
| 飞书文档节点 Token | 要同步的飞书知识空间节点标识，从飞书知识库文档的链接中获取——一个源绑定一个节点，要同步多个知识空间就建多个源 |
| 已有飞书应用连接 id | 团队此前创建过的飞书应用连接，直接选用 |
| 新建连接（名称 / AppID / AppSecret） | 没有连接时在此内联创建，填写飞书开放平台的应用凭证即可；连接创建后即与团队绑定，后续建源可直接复用 |
「应用连接」与「节点 Token」二选一绑定即可：连接解决「用哪个飞书应用的身份去拉」，节点 Token 解决「拉哪个知识空间」。
同步行为
- 源按知识空间节点拉取文档树，节点下的文档进入知识库「文件列表」，与手动上传的文档同等对待；
- 飞书侧的文档变更会按知识库默认工作流自动处理（切割 → 元数据 → 向量化），无需人工干预；
- 支持手动同步与 cron 定时同步（机制详见 3.5.2 数据接入）；
- 源停用后不再同步，已入库文档保留。
授权注意事项
飞书侧的权限模型决定了「应用能拉到什么」：
- 应用必须被授予对应文档或知识空间的访问权限——最常用的方式是在飞书文档/知识空间里把应用（机器人）添加为协作者；
- 权限不足的表现是「同步成功但文档数少于预期」或拉取报错，先检查授权范围再排查平台。
案例：产品手册从飞书到客服 Agent
- 飞书侧：产品手册维护在飞书知识库「产品文档」空间；开放平台建应用「知识库同步机器人」，加为该空间的协作者并发布；
- 建源：MoAI 知识库新建飞书源，复制飞书知识库文档链接中的节点 Token 粘贴，连接选「已有飞书应用连接」，开启每日定时同步；
- 自动维护：产品经理在飞书里更新《退款政策》——下一轮同步后 MoAI 侧文档自动更新并重新向量化；
- 服务对话：客服 Agent（见 3.8 Agent 应用）绑定该知识库，回答客户问题时用的始终是最新的手册内容。
常见问题
创建源时填错了凭证会立刻报错吗？
不一定。创建阶段对凭证的校验较宽松，凭证问题通常在首次同步时以明确错误暴露——建源后手动同步一轮验证是标准动作。
同步下来的文档不全？
按顺序排查：应用是否已发布；应用是否被添加为目标知识空间/文档的协作者；节点 Token 是否对应了正确的空间；遍历深度是否够。
删除飞书源会删掉已同步的文档吗？
不会。删除源只移除同步通道，已入库的文档全部保留，可继续被应用检索使用。
飞书侧删除了文档，知识库里会怎样？
平台提供云文档事件订阅与定时同步两种变更感知方式；是否删除本地副本以当前版本行为为准，对内容敏感的知识库建议同步后在文件列表里核对。
一个团队能同步多个飞书知识空间吗？
可以。每个飞书源绑定一个节点，多个空间建多个源即可，互不影响。