必须开通OpenViking权限并使用PDF/Word/TXT/MD格式上传资料，扫描件需OCR处理；飞书文档须设公开权限后同步，多维表格按字段导入；本地文件需准确填写元数据标签且启用全文索引。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要把公司历史投标文档、资质文件、产品手册等业务资料导入火山引擎AI Agent系统，让Agent在处理标讯、生成简报或回答客户问题时能调用真实可信的内部信息，而不是凭空编造。
上传前必须完成的准备工作
登录火山引擎控制台，进入「HiAgent」或「Coze企业版」工作区，确认当前空间已开通 OpenViking 上下文数据库权限。没有该权限将无法建立本地索引，所有上传文件仅存为原始附件，【Agent无法读取内容，也不能用于问答】。
准备资料时，优先使用PDF、Word（.docx）、纯文本（.txt）或Markdown（.md）格式。扫描件图片（如JPG/PNG）需先经TextIn大模型加速器OCR解析后再上传，否则OpenViking无法提取文字。
通过飞书文档链接自动同步
方法一：粘贴飞书文档公开链接
在Agent工作区的「我方资料库」模块中，点击「添加资料」→ 选择「飞书文档」→ 粘贴飞书文档的分享链接（需设置为“任何人可查看”或“本企业成员可查看”）→ 点击同步。
这一步会触发 lark-cli → OpenViking 的自动链路，文档正文、标题、段落结构、表格内容全部转为向量化文本，并打上时间戳和来源标记。如果飞书文档含附件（如PDF），系统默认不递归解析，需单独上传。
方法二：批量导入飞书多维表格
打开飞书多维表格，确保列名含“文档标题”“业务类型”“适用行业”“更新日期”等字段；复制表格链接，在「我方资料库」中选择「飞书多维表格」导入方式；系统将逐行读取并为每条记录生成独立上下文节点。
直接上传本地文件
第一步：点击「我方资料库」→「上传文件」→ 选择单个或多个文件（支持拖拽）。
第二步：为每份文件手动填写元数据标签，至少包括“所属部门”“适用场景”“保密等级”。其中“适用场景”必须从下拉菜单中选择（如“投标响应”“资质证明”“产品参数”），【选错会导致Agent在标讯工作区无法命中该资料】。
第三步：勾选“启用全文索引”，点击确认上传。PDF和Word类文件会在后台由TextIn引擎解析，平均耗时15～90秒/页；纯文本和Markdown即时完成索引。
上传完成后，文件状态显示为“已就绪”即表示可被Agent调用。若长时间卡在“解析中”，说明文件含加密、损坏或超大嵌入对象（如未压缩的矢量图），需重新导出后上传。
