必须将文件上传至知识库并完成向量化入库才能让AI模型调用私有文档，仅存入对象存储无效；需开通知识库服务、创建实例、上传解析文档、绑定至模型接入点，并通过调试或API验证引用来源。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在火山引擎中让AI模型真正理解并调用你私有的PDF、Word、Excel等文档内容，必须将文件上传至知识库并完成向量化入库，而不是仅存进对象存储或网盘。
确认知识库服务已开通
登录火山引擎控制台 → 进入「方舟平台」→ 选择地域（如 cn-beijing）→ 左侧导航栏点击「知识库」。若页面提示“未开通服务”，需先点击「立即开通」按钮，等待系统自动完成初始化（通常30秒内）。【未开通知识库服务前，所有上传操作都会失败并返回404】
开通后页面右上角会显示「新建知识库」按钮，此时才可进行后续操作。
创建专属知识库实例
点击「新建知识库」→ 填写知识库名称（建议含业务标识，如“电商客服-产品手册-v1”）→ 选择向量模型（默认推荐 deepseek-r1-embedding，兼容性与精度兼顾）→ 设置分块策略：选「按段落切分」（保留语义完整性），禁用「按固定字数切分」（易切断表格/代码/公式）。
注意：知识库一旦创建，向量模型不可更改，如需换模型只能新建实例并重新上传文档。
上传文档并触发自动解析
进入刚创建的知识库详情页 → 点击「上传文档」→ 支持单次最多20个文件，总大小不超过200MB → 接受格式包括：.pdf、.docx、.xlsx、.txt、.md、.pptx。
上传完成后，状态栏会显示「解析中」→ 约10～90秒后变为「就绪」。若卡在「解析中」超2分钟，大概率是PDF含扫描图或加密保护，需先转为可复制文本再重传。
绑定知识库到模型接入点
回到「方舟平台」→ 进入「模型服务」→ 找到你的推理接入点（如 deepseek-r1-chat）→ 点击「编辑配置」→ 在「增强能力」区域勾选「启用知识库检索」→ 下拉选择刚建好的知识库名称 → 保存配置。
这一步不做，模型即使收到提问也不会去查你传的文档。保存后无需重启接入点，变更实时生效。
验证文档是否真正可用
方法一：使用调试终端直接测试
进入知识库详情页 → 点击右上角「调试」→ 输入问题（如“退货流程第三步是什么？”）→ 查看返回结果中是否含引用标记【来源：xxx.pdf, P12】。
方法二：构造API请求验证
向你的模型接入点发送POST请求，在messages数组末尾添加一条user消息，内容为明确指向文档的问题；同时在请求体中加入参数："retrieval": {"enable": true, "top_k": 3}。若响应中出现来自你上传文件的原文片段，说明入库成功。
若两次都无引用来源，说明文档未被正确切块或嵌入——此时不要重传，先去知识库「文档管理」页检查该文件状态是否为「就绪」，不是则点击右侧「重新解析」。
