# 上传文档
在创建知识库后，需上传文档至知识库，平台支持知识文档、FAQ问答对、FAQ文档三种形态的文档。
- [上传知识文档]
  - [（可选）新增文档切片]：知识文档上传并解析完成后，用户可根据需要新增/编辑切片，以提升知识库的检索效率。
  
  - [（可选）重新对文档解析拆分]：如果用户对知识库内文档的解析切片效果不满意，可修改知识库模型配置、解析配置和拆分配置信息，并对知识库内文档重新解析拆分。
   
- [上传FAQ问答对]：FAQ（Frequently Asked Questions，常见问题解答） 问答对是指常见问题及其对应的答案，用于快速解决用户可能遇到的问题。
- [上传FAQ文档]：知识库支持通过上传FAQ文档来批量导入FAQ问答对。
  [（可选）新增FAQ文档切片]：FAQ文档上传并解析完成后，用户可根据需要新增/编辑切片，以提升知识库的检索效率。
  
#### 前提条件
- 已[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts0/agentarts_04_0000.html)。
- 已完成[创建知识库](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0152.html)。

- 登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考[管理团队空间成员](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0216.html)。
 
 #### 上传知识文档
1. 登录[AgentArts智能体开发平台](https://console.huaweicloud.com/versatile/#/home/overview)，在左侧导航栏"个人空间"区域，选择目标空间。
2. 在左侧导航栏中选择"开发中心 \> 组件库"。
3. 选择"知识库"页签，在"知识库"页面，单击知识库列表中所需知识库名称，进入该知识库详情页面。
4. 【可选】在"标签管理"页签，可添加文档标签（如科普、教育、科技等）用于对文档进行分类。配置标签后，可在工作流"知识检索"节点中配置按照标签检索文档。
5. 在知识库详情页面选择"知识文档"页签，单击"上传"进入文档上传页面。
6. 单击"点此上传"，在弹出的对话框中，选择要上传的文档。并可配置文档的标签。 
   ![](https://support.huaweicloud.com/usermanual-agentarts0/public_sys-resources/note_3.0-zh-cn.png)
   - 支持格式为psd、 tiff、 bmp、 gif、 csv、 tif、 ico、 md、 jpeg、 jpg、 xlsx、 pcx、 dps、 png、webp、 ofd、 docx、 et、 pptx、 txt、 pdf、 ppt、 doc、 wps、 xls的多个文档。
   
   - 以**AgentArts企业版**为例，单个文档不能大于60MB。
   
   - 单个知识库可上传的知识文档和FAQ文档总数不超过500个。
    
   
   
7. 单击"确定"，文件列表中有对应文件，即完成文件上传。 
   待文件状态为"成功"，即完成文件解析。
   图1上传文件   
   ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569424351.png)
   
   
 
 #### （可选）新增文档切片
1. 在知识库详情页面选择"知识文档"页签，单击"状态"是"成功"的文件名称，进入到文档详情页面。 
   左侧是文档基本信息和拆分配置信息，右侧是文档切片信息，如[图2]所示。
   图2文档详情   
   ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538384674.png)
   
   
2. 单击"新增切片"，参见[表1]设置切片信息。
   
    表1切片信息 
   | 参数   | 说明                                                                                                                           | 示例                                           |
   |:---|:---|:---|
   | 切片标题 | 必选参数。 用于快速了解每个切片的内容，便于在大量切片中进行查找和管理。                                                      | 1 什么是AgentArts                               |
   | 切片内容 | 必选参数。 通过切片内容，用户可以详细阅读和理解每个知识点或信息。 命名规则：长度不大于6000字符。 | 包含了"1 什么是AgentArts"及其子章节"AgentArts的使用限制"的内容。 |
      
   
   
3. 单击"确定"，新增的切片可以在切片信息中查看。
 
 #### （可选）重新对文档解析拆分
1. 在知识库详情页面，单击右上角"高级设置"。 
   ![](https://support.huaweicloud.com/usermanual-agentarts0/public_sys-resources/caution_3.0-zh-cn.png)
   - "高级设置"选项仅在当前知识库的状态是已停用时可用。
   
   - 仅**AgentArts企业版**用户可以修改精排模型。
    
   
   
2. 在弹出的对话框中，可以参见[表2](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0152.html#agentarts_05_0152__table424713918478)修改模型配置、解析配置和拆分配置信息。
   
   图3修改知识库高级设置   
   ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569424355.png)
   
   
3. 修改完成后，单击"确定"。
4. 选中需要使用新配置解析切片的文档，单击"重试"。
5. 在弹出的对话框中，单击"重试"即进行文档重新解析切片。 
   图4重试   
   ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538544614.png)
   
   
6. 选择"任务管理"页签，可查看重试任务。 
   图5任务管理   
   ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538384658.png)
   
   
 
 #### 上传FAQ问答对
1. 在知识库详情页面选择"FAQ问答对"页签，单击"创建"。
2. 在弹出的创建FAQ对话框中，参见[表2]填写FAQ回答对信息。
   
   图6FAQ回答对   
   ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569344387.png)
    表2参数说明 
   | 参数   | 说明                                                                                                                  | 示例                                                                                                                                                                                             |
   |:---|:---|:---|
   | 标准问题 | 必选参数。 用户可能提出的问题的最直接、最清晰的形式。 命名规则：长度不大于1000个字符。  | 小儿肥胖该怎样医治                                                                                                                                                                                      |
   | 答案   | 必选参数。 针对标准问题提供的详细解答。 命名规则：长度不大于10000个字符。  | 孩子一旦患上肥胖症家长要先通过运动和饮食来改变孩子的情况，要让孩子做一些他这个年龄段能做的运动，如游泳，慢跑等，要给孩子多吃一些像苹果，猕猴桃，胡萝卜等食物，禁止孩子吃高热量，高脂肪的食物，像蛋糕，干果，曲奇饼干等，严格地控制孩子的饮食，不要让他暴饮暴食，多运动对改变孩子肥胖都是有好处的，在治疗小儿肥胖期间如果情况严重，建议家长先带孩子去医院检查孩子肥胖症的原因再针对性的治疗。 |
   | 相似问题 | 可选参数。 与标准问题意思相近或相关的一系列问题。 命名规则：长度不大于1000个字符。 | 小儿肥胖的治疗需要综合考虑饮食、运动和行为改变等多方面因素。建议咨询专业的儿科医生或营养师，根据孩子的具体情况制定个性化的治疗计划。                                                                                                                             |
      
   
   
3. 单击"确定"，即完成FAQ问答对创建。 
   FAQ问答对创建完成后可以在"FAQ问答对"页签中查看。
   
   
 
 #### 上传FAQ文档
1. 在知识库详情页面选择"FAQ文档"页签，单击"上传"进入文档上传页面。
2. 单击"点此上传"，在弹出的对话框中选择符合"Excel模板"或"Word模板"要求的FAQ文档上传。 
   ![](https://support.huaweicloud.com/usermanual-agentarts0/public_sys-resources/note_3.0-zh-cn.png)
   - 支持xlsx、xls、docx、doc文件类型格式。
   
   - 以**AgentArts企业版**为例，单个文件不能大于60MB。
   
   - Excel单个文件最大支持100000条数据，文件中不允许空行，空行后的数据将被忽略。
    
   
   
3. 单击"确定"，文件列表中有对应文件，即完成文件上传。
4. 待文件状态为"成功"，即完成FAQ文档解析。
5. 选择"FAQ问答对"页签，可查看对应的问答对记录。
 
 #### （可选）新增FAQ文档切片
1. 在知识库详情页面选择"FAQ文档"页签，单击"状态"是"成功"的FAQ文件名称，进入到FAQ文档详情页面。 
   左侧是FAQ文档基本信息和拆分配置信息，右侧是FAQ文档解析后的问答对列表，如[图6]所示。
   图7FAQ文档详情   
   ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569344371.png)
   
   
2. 单击"新增切片"，参见[表3]设置切片信息。
   
    表3切片信息 
   | 参数   | 说明                                                                                                                         | 示例                                           |
   |:---|:---|:---|
   | 切片标题 | 必选参数。 用于快速了解每个切片的内容，便于在大量切片中进行查找和管理。 长度不大于1000个字符。 | 1 什么是AgentArts                               |
   | 切片内容 | 必选参数。 通过切片内容，用户可以详细阅读和理解每个知识点或信息。 长度不大于6000个字符。    | 包含了"1 什么是AgentArts"及其子章节"AgentArts的使用限制"的内容。 |
      
   
   
3. 单击"确定"。
 
#### 更多操作
在知识库详情页面，支持的其他操作请参考[表4]。
 表4相关操作 
| 操作       | 说明                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|
| 查看知识文档   | 在"知识文档"页签，单击指定名称文件，查看文档详情。 在文档详情页面，支持如下操作： - 编辑文档切片：在切片信息区域，单击右侧的"编辑"，可以修改文档切片。  - 删除文档切片：在切片信息区域，单击右侧的"删除"，可以删除文档切片。   |
| 下载知识文档   | 在"知识文档"页签，单击知识文件列表操作列"下载"，可以下载知识文档。                                                                                                                                                                                                                                                                                                                                                       |
| 删除知识文档   | 在"知识文档"页签，单击知识文件列表操作列"删除"，可以删除知识文档。                                                                                                                                                                                                                                                                                                                                                       |
| 编辑标签     | 在"知识文档"页签，单击标签列的![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538544600.png)按钮，或单击知识文件列表操作列"更多 \> 编辑标签"，可以修改标签。 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538544604.png)                                                                                                            |
| 编辑FAQ问答对 | 在"FAQ问答对"页签，单击FAQ问答对列表操作列"编辑"，可以编辑FAQ问答对。                                                                                                                                                                                                                                                                                                                                                 |
| 删除FAQ问答对 | 在"FAQ问答对"页签，单击FAQ问答对列表操作列"删除"，可以删除FAQ问答对。                                                                                                                                                                                                                                                                                                                                                 |
| 下载FAQ文档  | 在"FAQ文档"页签，单击FAQ文件列表操作列"下载"，可以下载FAQ文档。                                                                                                                                                                                                                                                                                                                                                    |
| 删除FAQ文档  | 在"FAQ文档"页签，单击FAQ文件列表操作列"删除"，可以删除FAQ文档。                                                                                                                                                                                                                                                                                                                                                    |
| 编辑文档切片   | 在"FAQ文档"页签，单击指定名称文件，进入文档详情页面，单击"编辑"，可以编辑文档切片。                                                                                                                                                                                                                                                                                                                                             |
| 删除文档切片   | 在"FAQ文档"页签，单击指定名称文件，进入文档详情页面，单击"删除"，可以删除文档切片。                                                                                                                                                                                                                                                                                                                                             |