必须开通TRAE或云搜索的知识库模块才能导入本地文档；上传仅支持PDF/MD/TXT（≤10MB），文件名禁用特殊字符；上传后需状态变为“就绪”才进入向量索引；验证需用原文短语查询并检查状态、OCR和文本存在性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要把本地文档导入火山引擎知识库，必须先确认你使用的是支持文档集功能的企业版服务，并且已开通TRAE或云搜索服务中的知识库模块；单靠TOS对象存储上传的文件不会自动进入AI可检索的知识库索引范围。
确认知识库服务已启用
登录火山引擎控制台 → 进入「产品服务」→ 搜索并进入「TRAE 企业版」或「云搜索服务」→ 查看左侧菜单是否包含「企业文档集」或「知识库管理」。若无此入口，需联系企业管理员开通对应权限包，【未开通服务时所有上传操作均无效】。
TRAE企业版中「企业文档集」路径为：企业配置 → 企业文档集；云搜索服务中路径为：知识库 → 文档集管理。
上传本地文件到TRAE企业文档集
第一步：点击右上角「+ 新增文档集」→ 输入名称（如“2026销售政策”）与描述（建议注明更新日期和来源）。
第二步：设置可见范围——选「所有人员可见」或「部分人员可见」；若选后者，必须手动勾选具体部门/成员，否则保存后该文档集对任何人不可见。
第三步：在「上传文件」区域点击「添加文件 → 本地文件」→ 选择本地文档（仅支持 .pdf、.md、.txt；单个 ≤10 MB）→ 点击「保存」。
【注意：文件名不能含中文括号、竖线、星号等特殊字符，否则上传后无法被正确解析】。上传成功后，状态显示为「处理中」，约1–3分钟后变为「就绪」，此时文档内容才进入向量化索引流程。
用云搜索服务构建知识库文档集
方法一：直接上传（适合少量文件）
进入「知识库 → 文档集管理」→ 「新建文档集」→ 填写基础信息 → 在「数据源」处选择「本地文件」→ 点击「上传」→ 选择 PDF/TXT/MD 文件（同样≤10 MB）→ 提交。
方法二：绑定TOS桶（适合批量、高频更新）
提前在TOS中创建公共读桶 → 将文档上传至该桶 → 返回云搜索知识库页面 → 新建文档集时选择「对象存储（TOS）」作为数据源 → 填写桶名、前缀（如 uploads/kb/）、AK/SK（需授予 tos:object:GetObject 权限）→ 启动同步任务。
方法三：API接入（适合自动化集成）
调用云搜索 OpenAPI 的 CreateDocumentSet 接口，body 中传入 data_source.type = "local" 或 "tos"，并附带文件 Base64 内容或 TOS 路径；请求头需带 X-Region 和 Authorization 签名。
验证文档是否真正可用
进入TRAE客户端或云搜索测试面板 → 输入与文档中明确出现的短语（如“Q3返点比例不低于18%”）→ 查看返回结果是否包含原文片段及高亮定位。
若返回空或提示“暂无相关文档”，检查三项：① 文档集状态是否为「就绪」而非「处理失败」；② 文档是否被OCR识别失败（PDF扫描件需先转文字）；③ 查询词是否在文档原始文本中真实存在（复制粘贴比手打更可靠）。
