# 上传文档 在创建知识库时，您可以选择本地上传知识文档，或通过对象存储服务（Object Storage Service, OBS）接入知识文档。本文将详细说明如何选择本地上传知识文档。 上传文档适用于文件数量少、单次上传的场景。 在创建知识库后，需上传文档至知识库，平台支持知识文档、FAQ问答对、FAQ文档三种形态的文档。 - [上传知识文档]：知识文档上传并解析完成后，用户可根据需要新增/编辑切片，以提升知识库的检索效率。如果用户对知识库内文档的解析切片效果不满意，可修改知识库模型配置、解析配置和拆分配置信息，并对知识库内文档重新解析拆分。 - [上传FAQ问答对]：FAQ（Frequently Asked Questions，常见问题解答）问答对是指常见问题及其对应的答案，用于快速解决用户可能遇到的问题。 知识库支持通过上传FAQ文档来批量导入FAQ问答对。FAQ文档上传并解析完成后，用户可根据需要新增/编辑切片，以提升知识库的检索效率。 #### 费用说明 文档导入过程中的向量化处理可能会产生模型调用费用，请关注配额及计费详情，具体可参考[计费说明](https://support.huaweicloud.com/price-agentarts/agentarts_08_0002.html)。 AgentArts**体验版**不计费。 AgentArts**团队标准版** /**团队高级版** /**企业专业版** /**企业旗舰版** ：AgentArts侧不计费，接入MaaS模型即服务的模型，具体计费请参考[MaaS模型即服务价格](https://support.huaweicloud.com/price-maas/price-maas-0001.html)。 **当前AgentArts团队标准版、团队高级版、企业专业版、企业旗舰版未开放，如果需要购买，请[提交工单](https://console.huaweicloud.com/ticket/#/ticketindex/createIndex)咨询购买相关事宜。** #### 选型建议 - 知识文档：适用于非结构化的长文档（如产品手册、操作指南、技术白皮书），系统会自动进行切片和向量化处理。 - FAQ问答对/文档：适用于结构化的问答数据（如Excel表格中的Q\&A），能够精准匹配用户提问，适合客服场景。 #### 前提条件 - 已[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0000.html)。 - 已完成[创建知识库](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_207.html)。 #### 上传知识文档 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 在左侧导航栏中选择"托管与运行 \> 知识库"。 3. 在"知识库"页面，单击知识库列表中所需知识库名称，进入该知识库详情页面。 4. 单击"添加知识"，"上传方式"选择"知识文档上传"。 - 知识文档上传：支持本地批量导入知识文档。 - OBS上传：可通过OBS路径批量导入文档。 - FAQ问答对：可通过导入文档上传，或在线创建问答对。 5. 在"上传文档"区域，单击"点此上传"，在弹出的对话框中，选择要上传的文档。 当上传的文档由"上传中"变为"上传成功"，表示文档已成功上传。 ![](https://support.huaweicloud.com/highcode-agentarts/public_sys-resources/note_3.0-zh-cn.png) - 支持上传常见的文档格式： - 文档/文本类：doc、docx、pdf、ofd、txt、md、wps。 - 表格/数据类：xls、xlsx、csv、et。 - 演示/幻灯片类：ppt、pptx、dps。 - 图片/设计类：jpg、jpeg、png、gif、bmp、webp、tiff、tif、psd、ico、pcx。 AgentArts支持用户根据需求，将图片类的文件直接存储，或是提取图片中的文字信息进行存储。 - 不同套餐包对文件大小限制不同，具体请参考[知识库使用限制](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_101.html)。 6. 单击"完成"。 返回知识库详情页面，文件上传后将自动进行解析，解析时间视文件大小和数量而定。如果状态长时间显示为"解析中"或"失败"，请检查文件格式是否损坏或联系技术支持工程师。 待文件状态为"成功"，即完成文件解析。 上传的知识文档，显示在知识库详情页面的"文件内容 \> 知识文档"中。 图1文件解析成功 ![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002741944659.png "点击放大") "文件内容"区域说明： - 左侧：知识库文档的类别及上传的文档列表。 - 中间：知识文档的切片信息。 - 右侧：文档详情。 7. （可选）在"知识库详情"页面右上方，单击"![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002712185716.png) \> 标签"，可添加文档标签（如科普、教育、科技等）用于对文档进行分类。 8. （可选）在"文档详情"区域，单击![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002742064623.png)，为文档设置标签，可在工作流"知识检索"节点中配置按照标签检索文档。 #### 上传OBS文档 通过OBS接入文档适用于文件数量较多、文件较大（超过本地上传限制），或数据已存储在OBS桶中的场景。 ![](https://support.huaweicloud.com/highcode-agentarts/public_sys-resources/caution_3.0-zh-cn.png) 需拥有已实名认证的华为账号，且该账号具有OBS桶的访问权限。 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 在左侧导航栏中选择"托管与运行 \> 知识库"。 3. 在"知识库"页面，单击知识库列表中所需知识库名称，进入该知识库详情页面。 4. 单击"添加知识"，"上传方式"选择"OBS上传"。 - 知识文档上传：支持本地批量导入知识文档。 - OBS上传：可通过OBS路径批量导入文档。 - FAQ问答对：可通过导入文档上传，或在线创建问答对。 5. 配置OBS信息，如[图2]所示，参数配置请参考[表1]。 ![](https://support.huaweicloud.com/highcode-agentarts/public_sys-resources/warning_3.0-zh-cn.png) OBS配置信息保存之后将无法修改。如果配置错误，需删除当前知识库并重新创建。 一个知识库仅支持接入一次OBS文件，接入后不可编辑。 图2配置OBS信息 ![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002712345672.png "点击放大") 表1OBS配置参数说明 | 参数 | 说明 | 示例 | |:---|:---|:---| | OBS桶名 | 选择存储知识文档的OBS桶。接入后不支持修改。 | test01 | | OBS路径 | 知识文档在OBS中的具体路径。接入后不支持修改。 - 接入的OBS目录下子目录层级不超过三层，如接入目录为path1，则path1最大目录层级为path1/path2/path3/path4/xxx.txt。 - 支持上传常见的文档格式： - 文档/文本类：doc、docx、pdf、ofd、txt、md、wps。 - 表格/数据类：xls、xlsx、csv、et。 - 演示/幻灯片类：ppt、pptx、dps。 - 图片/设计类：jpg、jpeg、png、gif、bmp、webp、tiff、tif、psd、ico、pcx。 AgentArts支持用户根据需求，将图片类的文件直接存储，或是提取图片中的文字信息进行存储。 - 不同套餐包对文件大小限制不同，具体请参考[知识库使用限制](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_101.html)。 | RMSLogs/ | 6. 配置完成后，单击"立即执行"。 执行时间取决于文件数量和大小，请耐心等待。如果状态显示"执行失败"，请检查OBS桶权限是否正确配置或查看执行日志。 当执行状态显示为"执行成功"，即完成OBS接入知识文档。 7. 单击"完成"。 返回知识库详情页面。 #### 上传FAQ问答对 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 在左侧导航栏中选择"托管与运行 \> 知识库"。 3. 在"知识库"页面，单击知识库列表中所需知识库名称，进入该知识库详情页面。 4. 单击"添加知识"，"上传方式"选择"FAQ问答对"。 - 知识文档上传：支持本地批量导入知识文档。 - OBS上传：可通过OBS路径批量导入文档。 - FAQ问答对：可通过导入文档上传，或在线创建问答对。 5. 选择创建方式。 - "选择创建方式"选择"文档导入"。 单击"点此上传"，在弹出的对话框中选择符合"Excel模板"或"Word模板"要求的FAQ文档上传。 当上传的文档由"上传中"变为"上传成功"，表示文档已成功上传。 ![](https://support.huaweicloud.com/highcode-agentarts/public_sys-resources/note_3.0-zh-cn.png) - 支持按照模板上传文件，文件格式仅支持xlsx、xls、docx、doc。 - 不同套餐包对文件大小限制不同，具体请参考[知识库使用限制](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_101.html)。 - Excel单个文件最大支持100,000条数据。 - FAQ文件中不允许空行，空行后的数据将被忽略。 - "选择创建方式"选择"在线创建"。 单击"添加问答对"，填写FAQ问答对信息，如[图3]所示，参数配置请参考[表2]。 图3FAQ问答对 ![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002741944663.png "点击放大") 表2参数说明 | 参数 | 说明 | 示例 | |:---|:---|:---| | 标准问题 | 必选参数。 用户可能提出的问题的最直接、最清晰的形式。 由1\~1000个字符组成。 | 小儿肥胖该怎样医治 | | 相似问题 | 可选参数。 与标准问题意思相近或相关的一系列问题。 由1\~1000个字符组成。 | 小儿肥胖的治疗需要综合考虑饮食、运动和行为改变等多方面因素。建议咨询专业的儿科医生或营养师，根据孩子的具体情况制定个性化的治疗计划。 | | 答案 | 必选参数。 针对标准问题提供的详细解答。 由1\~10000个字符组成。 | 孩子一旦患上肥胖症家长要先通过运动和饮食来改变孩子的情况，要让孩子做一些他这个年龄段能做的运动，如游泳，慢跑等，要给孩子多吃一些像苹果，猕猴桃，胡萝卜等食物，禁止孩子吃高热量，高脂肪的食物，像蛋糕，干果，曲奇饼干等，严格地控制孩子的饮食，不要让他暴饮暴食，多运动对改变孩子肥胖都是有好处的，在治疗小儿肥胖期间如果情况严重，建议家长先带孩子去医院检查孩子肥胖症的原因再针对性的治疗。 | 6. 单击"完成"。 返回知识库详情页面，文件上传后将自动进行解析，解析时间视文件大小和数量而定。如果状态长时间显示为"解析中"或"失败"，请检查文件格式是否损坏或联系技术支持工程师。 待文件状态为"成功"，即完成文件解析。 - 上传的FAQ文档，显示在知识库详情页面的"文件内容 \> FAQ文档"中。 图4文件解析成功 ![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002712185722.png "点击放大") "文件内容"区域说明： - 左侧：知识库文档的类别及上传的文档列表。 - 中间：知识文档的切片信息。 - 右侧：文档详情。 - 添加的FAQ问答对，显示在知识库详情页面的"文件内容 \> FAQ问答对"中，左侧显示问题，右侧显示问答对。 单击内容，可以修改。 图5FAQ问答对 ![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002742064627.png "点击放大") #### 常见问题 **为什么文档上传失败？** - 可能原因： - 文档格式不符合格式要求。 - 文档大小超过限制。 - 处理措施： - 支持上传常见的文档格式： - 文档/文本类：doc、docx、pdf、ofd、txt、md、wps。 - 表格/数据类：xls、xlsx、csv、et。 - 演示/幻灯片类：ppt、pptx、dps。 - 图片/设计类：jpg、jpeg、png、gif、bmp、webp、tiff、tif、psd、ico、pcx。 AgentArts支持用户根据需求，将图片类的文件直接存储，或是提取图片中的文字信息进行存储。 - 不同套餐包对文件大小限制不同，具体请参考[知识库使用限制](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_101.html)。 **为什么文档解析失败？** - 可能原因：文档格式损坏或OCR模型不可用。 - 处理措施：请确认文件格式正常，如使用了基于KooSearch的模型，请在KooSearch服务侧检查OCR模型状态并修复。 #### 相关操作 在知识库详情页面，在"文件内容 \> 知识文档"、"文件内容 \> FAQ文档"、"文件内容 \> FAQ问答对"页签，单击指定文件或问题，可以查看文档或问题详情。在文档或问题详情页面，支持的其他操作请参考[表3]。 表3相关操作 | 操作 | 说明 | |:---|:---| | 新增切片 | 单击![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002712345674.png)，新增切片。 说明： 仅知识文档、FAQ文档支持新增切片。 - **切片标题** ：用于快速了解每个切片的内容，便于在大量切片中进行查找和管理。由1\~1000个字符组成。 示例： ``` 1 什么是AgentArts ``` - **切片内容** ：通过切片内容，用户可以详细阅读和理解每个知识点或信息。由1\~6000个字符组成。 示例： ``` 包含了“1 什么是AgentArts”及其子章节“AgentArts的使用限制”的内容。 ``` | | 重新对文档解析拆分 | 单击![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002741944665.png)，在弹出的对话框中，单击"重试"即进行文档重新解析切片。重试任务在知识库详情页面的"![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002712185724.png) \> 日志"中查看。 解析时间视文件大小和数量而定。如果状态长时间显示为"解析中"或"失败"，请检查文件格式是否损坏或联系技术支持工程师。 说明： 重新解析和向量化处理，该过程会消耗计算资源，请谨慎操作。 仅知识文档支持重新解析拆分。 | | 下载知识文档 | 单击![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002742064629.png)，可以下载知识文档、FAQ文档。 说明： 仅知识文档、FAQ文档支持下载文档。 | | 删除知识文档 | 警告： 删除后数据将无法恢复，请谨慎操作。删除知识文档、FAQ文档、FAQ问答对将影响依赖该知识库的智能体回答效果。 单击![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002712345676.png)，可以删除知识文档、FAQ文档、FAQ问答对。 | | 编辑文档切片 | - 鼠标移动至待编辑的切片信息区域，单击![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002741944667.png)，可以修改知识文档、FAQ文档切片。 - 单击![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002712185726.png)，可以编辑FAQ问答对。 | | 删除文档切片 | 鼠标移动至待删除的切片信息区域，单击![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002742064631.png)，可以删除知识文档、FAQ文档切片。 | | 修改标签 | 在"文档详情"区域，单击![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002712345678.png)，可以修改标签。 说明： 仅知识文档支持标签功能。 |