# 知识库

> 知识库用于统一管理需要参与问答检索的企业文档，并将其切片、向量化后供RAG应用调用。

## 处理流程
<CardGroup cols="4">
  <Card title="1. 新建知识库" data-icon="book-open">
    <strong>初始化</strong>
    <ul>
      <li>填写名称与描述</li>
      <li>设置公开范围（如需要）</li>
    </ul>
  </Card>

  <Card title="2. 上传文档" data-icon="book-open">
    <strong>解析入库</strong>
    <ul>
      <li>等待解析（含 OCR）完成</li>
      <li>可预览文档元信息</li>
    </ul>
  </Card>

  <Card title="3. 切片精修" data-icon="book-open">
    <strong>质量优化</strong>
    <ul>
      <li>查看/编辑切片，新增空白切片/图片</li>
      <li>实时预览修改效果</li>
    </ul>
  </Card>

  <Card title="4. 向量化并使用" data-icon="book-open">
    <strong>检索就绪</strong>
    <ul>
      <li>提交后等待向量化完成</li>
      <li>RAG 应用即可检索并回答</li>
    </ul>
  </Card>
</CardGroup>

## 功能清单
<CardGroup cols="2">
  <Card title="知识库管理" data-icon="book-open">
    <strong>创建与维护</strong>
    <ul>
      <li>新建 / 编辑 / 删除知识库</li>
      <li>支持公开/私有的可见性管理</li>
    </ul>
  </Card>

  <Card title="文档管理" data-icon="book-open">
    <strong>文件全生命周期</strong>
    <ul>
      <li>上传、替换、删除、预览</li>
      <li>默认启用 OCR 解析（图片/PDF）</li>
    </ul>
  </Card>

  <Card title="切片管理" data-icon="book-open">
    <strong>可视化与精修</strong>
    <ul>
      <li>查看切片、编辑切片、新增空白切片/图片、删除切片</li>
      <li>切片修改效果可实时预览</li>
    </ul>
  </Card>

  <Card title="向量化与检索" data-icon="book-open">
    <strong>检索就绪</strong>
    <ul>
      <li>提交后自动向量化</li>
      <li>状态完成后即可被 RAG 应用检索</li>
    </ul>
  </Card>
</CardGroup>


## 快速上手
我不想创建知识库，想直接使用现有的公开知识库库来创建自己的RAG应用。

步骤一：
<Tip type="success">
  进入知识库菜单，查看所有公开的知识库。
  ![](/kg1.png)
  记住知识库的名称，
</Tip>

<Tip type="warn">
  当前公开知识库你仅可以查看，无法编辑别人的知识库、也不能在别人创建的公开知识库中添加你自己的文档。
</Tip>

步骤二：
<Tip type="success">
  点击知识库后可以查看到别人/自己的知识库中的文档，以及文档的切片信息。
  ![](/kg2.png)  
  ![](/kg3.png)
</Tip>

## 创建知识库
用自己的文档创建私有或公开的知识库。  
<Tip type="success">
  点击 创建知识库 按钮，开始创建空的知识库集合。
  ![](/kgc1.png)
  点击 下一步 
</Tip>

## 上传文档
步骤一：
<Tip type="success">
  进入上传文件组件。
  ![](/kgc2.png) 
</Tip> 

步骤二：
<Tip type="success">
  请选择符合上传要求的文件。
  ![](/kgc3.png)  
  等待几分钟的解析时间。
  ![](/kgc4.png)  
  解析完成后可以看到文档进入知识库列表 ,对解析效果不好的情况可以更改解析配置，重新解析。  
  ![](/kgc5.png)
</Tip>

## 切片精修
工程领域的文档数据集不够标准，直接采用默认的解析效果，可能文件段落信息不完整，导致切片质量不佳，需要进行手动精修。

步骤一：
<Tip type="success">
  文档列表页面点 切片 按钮，进入切片列表。
  ![](/kgc6.png)
</Tip>

步骤二：
<Tip type="success">
  当前列表的可操作功能：删除切片、编辑切片、新增空白切片。
  ![](/kgc7.png)
</Tip>

步骤三：
<Tip type="success">
  点击编辑切片，可以修改切片内容。编辑器采用Markdown编辑器，支持实时预览。
  ![](/kgc8.png)
  支持新增切片，剪切切片内容到其他切片的方式来调整段落完整性。
</Tip>

## 切片精修-图片处理方法
步骤一：
<Tip type="success">
  原始文档中的图片回被转化为标识符，当图片转化信息不全的时候使用解析图片功能替换掉效果不好的图片。
  ![](/kgc9.png)
  当前表格由于文档中旋转了90度，导致解析出来效果不便于阅读，需要人工替换。
</Tip>

步骤二：
<Tip type="success">
  准备需要替换的图片。手动复制出来。
  ![](/item.png)  
</Tip>

步骤三：
<Tip type="success">
  通过点击解析图片按钮，上传单独复制出来的图片，可以重新解析图片。
  ![](/kgc10.png)
  解析成功后，图片标识符将会出现在鼠标光标位置，手动删除掉旧的图片标识符就处理完成
</Tip>



## 最佳实践
- 文档尽量结构化、标题清晰，有利于生成高质量切片
- 对长文档酌情拆分章节上传；减少无意义页眉页脚
- 关键表格建议转为文本或 CSV，便于检索

## 常见问题
- 文档解析失败：检查文件是否加密、体积是否过大；必要时转为 PDF 再上传
- 检索不到内容：确认向量化完成；调整应用的 TopK 与相似度阈值
- 文件上传失败：支持docx,doc,pdf。默认将docx/doc文件转化为pdf后使用ocr模型解析，解析时间很长导致集团网络认为超时，实际上已提交到服务器中，等待几分钟后刷新页面有出现文件，则表示上传成功，如果刷新后仍然不出文件则表示此次上传任务失败，检查文件或重新上传。
