必须先在飞书开放平台开通权限并发布应用，再在火山方舟配置飞书文档知识源；若跳过权限开通或误选“非结构化数据”，将导致文档无法抓取、同步失败且不可修改。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在火山引擎中把飞书文档作为知识源接入知识库，必须先完成飞书开放平台侧的权限开通与应用发布，再在火山方舟中配置知识库数据源类型为“飞书文档”，否则系统无法读取文档内容，后续所有解析、索引、问答均会失败。
开通飞书企业自建应用并申请必要权限
登录飞书开放平台 → 使用SSO账号进入你的机器人应用 → 左侧菜单点击「开发配置」→「权限管理」→ 点击「开通权限」。
勾选以下两项权限（其他权限无需开启）：
• 查看云文档内容（docs:document.content:read）
• 查看云空间中文件元数据（drive:drive.metadata:readonly）
权限申请说明填写：“用于火山方舟知识库自动同步飞书文档文本内容，支撑AI问答服务”。提交后等待审批——内部应用通常1分钟内通过。审批通过后必须发布新版本才能生效：点击顶部「创建版本」→ 填写版本号和更新说明 → 选择权限范围（个人/团队/全公司）→ 提交发布。
【App ID 和 App Secret 必须复制保存，后续火山方舟配置时需手动填入】
在火山方舟中创建飞书类型知识库
登录火山引擎控制台 → 进入「火山方舟」→ 左侧菜单点击「知识库」→ 右上角点击「创建知识库」。
填写知识库名称（如“飞书产品手册”）和描述 → 在「数据类型」下拉框中必须选择「结构化数据」 → 点击「确定创建」。
⚠️ 注意：这里选“非结构化数据”会导致飞书文档链接无法被识别和抓取，系统不会报错但后续始终显示“无文档可解析”，且该选项创建后不可修改，只能删除重建。
绑定飞书应用凭证并同步文档
进入刚创建的知识库详情页 → 点击「同步外部内容」→ 选择「飞书文档」→ 弹出配置窗口。
第一步：粘贴你在飞书开放平台复制的App ID和App Secret；
第二步：输入目标飞书文档的公开可访问URL（必须是已发布、未设查看权限限制的文档）；
第三步：点击「测试连接」确认凭证有效 → 点击「保存并同步」。
系统开始抓取文档纯文本内容（图片、附件、评论不纳入索引），状态变为「同步中」。首次同步约需30–90秒，完成后状态变更为「就绪」，即可用于配置问答模型。
