文档首页/ 智能体开发平台 AgentArts/ 低代码开发/ 组件库/ 知识库/ 创建平台默认知识库/ 上传文档
更新时间：2026-04-15 GMT+08:00
查看PDF
分享

上传文档

在创建知识库时，您可以选择本地上传知识文档，或通过对象存储服务（Object Storage Service, OBS）接入知识文档。本文将详细说明如何选择本地上传知识文档。

上传文档适用于文件数量少、单次上传的场景。

在创建知识库后，需上传文档至知识库，平台支持知识文档、FAQ问答对、FAQ文档三种形态的文档。

  • 上传知识文档：
    • （可选）新增文档切片：知识文档上传并解析完成后，用户可根据需要新增/编辑切片，以提升知识库的检索效率。
    • （可选）重新对文档解析拆分：如果用户对知识库内文档的解析切片效果不满意，可修改知识库模型配置、解析配置和拆分配置信息，并对知识库内文档重新解析拆分。
  • 上传FAQ问答对：FAQ（Frequently Asked Questions，常见问题解答） 问答对是指常见问题及其对应的答案，用于快速解决用户可能遇到的问题。
  • 上传FAQ文档：知识库支持通过上传FAQ文档来批量导入FAQ问答对。

    （可选）新增FAQ文档切片：FAQ文档上传并解析完成后，用户可根据需要新增/编辑切片，以提升知识库的检索效率。

费用说明

创建知识库及上传文档会占用知识库存储容量，具体可参考计费模式。

文档导入过程中的向量化处理可能会产生模型调用费用，请关注配额及计费详情。

AgentArts基础版不计费。

选型建议

  • 知识文档：适用于非结构化的长文档（如产品手册、操作指南、技术白皮书），系统会自动进行切片和向量化处理。
  • FAQ问答对/文档：适用于结构化的问答数据（如Excel表格中的Q&A），能够精准匹配用户提问，适合客服场景。

前提条件

上传知识文档

  1. 登录AgentArts智能体开发平台。
  2. 在左侧导航栏中选择“开发中心 > 组件库”。
  3. 选择“知识库”页签，在“知识库”页面，单击知识库列表中所需知识库名称，进入该知识库详情页面。
  4. 【可选】在“标签管理”页签，可添加文档标签（如科普、教育、科技等）用于对文档进行分类。配置标签后，可在工作流“知识检索”节点中配置按照标签检索文档。
  5. 在知识库详情页面选择“知识文档”页签，单击“上传”进入文档上传页面。
  6. 单击“点此上传”，在弹出的对话框中，选择要上传的文档。并可配置文档的标签。

    • 支持格式如下：
      • 文档/文本类：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。
    • 单个文档上传限制最大60MB，文档总数量最多500个，总文档最大1GB。

  7. 单击“确定”，文件列表中有对应文件，即完成文件上传。

    文件上传后将自动进行解析，解析时间视文件大小和数量而定。如果状态长时间显示为“解析中”或“失败”，请检查文件格式是否损坏或联系技术支持工程师。

    待文件状态为“成功”，即完成文件解析。

    图1 上传文件

（可选）新增文档切片

  1. 在知识库详情页面选择“知识文档”页签，单击“状态”是“成功”的文件名称，进入到文档详情页面。

    左侧是文档基本信息和拆分配置信息，右侧是文档切片信息，如图2所示。

    图2 文档详情

  2. 单击“新增切片”，参见表1设置切片信息。

    表1 切片信息

    参数

    说明

    示例

    切片标题

    用于快速了解每个切片的内容，便于在大量切片中进行查找和管理。

    由1~1000个字符组成。

    1 什么是AgentArts

    切片内容

    通过切片内容，用户可以详细阅读和理解每个知识点或信息。

    由1~6000个字符组成。

    包含了“1 什么是AgentArts”及其子章节“AgentArts的使用限制”的内容。

  3. 单击“确定”，新增的切片可以在切片信息中查看。

（可选）重新对文档解析拆分

  1. 在知识库详情页面，单击右上角“高级设置”。

    • “高级设置”选项仅在当前知识库的状态是已停用时可用。

  2. 在弹出的对话框中，可以参见表2修改模型配置、解析配置和拆分配置信息。

    图3 修改知识库高级设置

  3. 修改完成后，单击“确定”。
  4. 选中需要使用新配置解析切片的文档，单击“重试”。
  5. 在弹出的对话框中，单击“重试”即进行文档重新解析切片。

    图4 重试

  6. 选择“任务管理”页签，可查看重试任务。

    图5 任务管理

上传FAQ问答对

  1. 在知识库详情页面选择“FAQ问答对”页签，单击“创建”。
  2. 在弹出的创建FAQ对话框中，参见表2填写FAQ回答对信息。

    图6 FAQ回答对
    表2 参数说明

    参数

    说明

    示例

    标准问题

    必选参数。

    用户可能提出的问题的最直接、最清晰的形式。

    命名规则：长度不大于1000个字符。

    小儿肥胖该怎样医治

    答案

    必选参数。

    针对标准问题提供的详细解答。

    命名规则：长度不大于10000个字符。

    孩子一旦患上肥胖症家长要先通过运动和饮食来改变孩子的情况，要让孩子做一些他这个年龄段能做的运动，如游泳，慢跑等，要给孩子多吃一些像苹果，猕猴桃，胡萝卜等食物，禁止孩子吃高热量，高脂肪的食物，像蛋糕，干果，曲奇饼干等，严格地控制孩子的饮食，不要让他暴饮暴食，多运动对改变孩子肥胖都是有好处的，在治疗小儿肥胖期间如果情况严重，建议家长先带孩子去医院检查孩子肥胖症的原因再针对性的治疗。

    相似问题

    可选参数。

    与标准问题意思相近或相关的一系列问题。

    命名规则：长度不大于1000个字符。

    小儿肥胖的治疗需要综合考虑饮食、运动和行为改变等多方面因素。建议咨询专业的儿科医生或营养师，根据孩子的具体情况制定个性化的治疗计划。

  3. 单击“确定”，即完成FAQ问答对创建。

    FAQ问答对创建完成后可以在“FAQ问答对”页签中查看。

上传FAQ文档

  1. 在知识库详情页面选择“FAQ文档”页签，单击“上传”进入文档上传页面。
  2. 单击“点此上传”，在弹出的对话框中选择符合“Excel模板”或“Word模板”要求的FAQ文档上传。

    • 支持xlsx、xls、docx、doc文件类型格式。
    • 单个文档上传限制最大60MB，文档总数量最多500个，总文档最大1GB。
    • Excel单个文件最大支持100000条数据，文件中不允许空行，空行后的数据将被忽略。

  3. 单击“确定”，文件列表中有对应文件，即完成文件上传。
  4. 待文件状态为“成功”，即完成FAQ文档解析。
  5. 选择“FAQ问答对”页签，可查看对应的问答对记录。

（可选）新增FAQ文档切片

  1. 在知识库详情页面选择“FAQ文档”页签，单击“状态”是“成功”的FAQ文件名称，进入到FAQ文档详情页面。

    左侧是FAQ文档基本信息和拆分配置信息，右侧是FAQ文档解析后的问答对列表，如图6所示。

    图7 FAQ文档详情

  2. 单击“新增切片”，参见表3设置切片信息。

    表3 切片信息

    参数

    说明

    示例

    切片标题

    必选参数。

    用于快速了解每个切片的内容，便于在大量切片中进行查找和管理。

    长度不大于1000个字符。

    1 什么是AgentArts

    切片内容

    必选参数。

    通过切片内容，用户可以详细阅读和理解每个知识点或信息。

    长度不大于6000个字符。

    包含了“1 什么是AgentArts”及其子章节“AgentArts的使用限制”的内容。

  3. 单击“确定”。

相关文档

为什么文档上传失败？
  • 可能原因：
    1. 文档大小超过限制。
    2. 文档格式不符合格式要求。
  • 处理措施：
    1. 单个文档上传限制最大60MB，文档总数量最多500个，总文档最大1GB。
    2. 文档格式：
      • 文档/文本类：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。
为什么文档解析失败？
  • 可能原因：文档格式损坏或OCR模型不可用。
  • 处理措施：请确认文件格式正常，在KooSearch服务侧检查OCR模型状态并修复。

更多操作

在知识库详情页面，支持的其他操作请参考表4。

表4 相关操作

操作

说明

查看知识文档

在“知识文档”页签，单击指定名称文件，查看文档详情。

在文档详情页面，支持如下操作：

  • 编辑文档切片：在切片信息区域，单击右侧的“编辑”，可以修改文档切片。
  • 删除文档切片：在切片信息区域，单击右侧的“删除”，可以删除文档切片。

下载知识文档

在“知识文档”页签，单击知识文件列表操作列“下载”，可以下载知识文档。

删除知识文档

在“知识文档”页签，单击知识文件列表操作列“删除”，可以删除知识文档。

编辑标签

在“知识文档”页签，单击标签列的按钮，或单击知识文件列表操作列“更多 > 编辑标签”，可以修改标签。

编辑FAQ问答对

在“FAQ问答对”页签，单击FAQ问答对列表操作列“编辑”，可以编辑FAQ问答对。

删除FAQ问答对

在“FAQ问答对”页签，单击FAQ问答对列表操作列“删除”，可以删除FAQ问答对。

下载FAQ文档

在“FAQ文档”页签，单击FAQ文件列表操作列“下载”，可以下载FAQ文档。

删除FAQ文档

在“FAQ文档”页签，单击FAQ文件列表操作列“删除”，可以删除FAQ文档。

编辑文档切片

在“FAQ文档”页签，单击指定名称文件，进入文档详情页面，单击“编辑”，可以编辑文档切片。

删除文档切片

在“FAQ文档”页签，单击指定名称文件，进入文档详情页面，单击“删除”，可以删除文档切片。
父主题： 创建平台默认知识库

相关文档