> ## Documentation Index
> Fetch the complete documentation index at: https://octop.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 知识库：在对话中检索你的文件

> 把文档放进知识库，专家在对话里可以检索相关段落，并在回复下方展示引用来源。

**知识库**是一组会被 Octop 检索的文件。对话时不必把全文贴进输入框：专家会找出相关段落，并在回复下方列出可点击的来源文档。

从侧边栏的**设置**分组打开：

```text theme={null}
知识库
```

该入口带 **BETA** 标记。管理员先为整个实例打开功能，之后你就可以创建知识库，并在对话中使用。

## 打开功能

如果你是管理员，打开**知识库**，再进入**知识库设置**。

**1. 启用知识库**

打开**启用知识库**开关。该开关对整个实例生效。

**2. 选择索引方式**

选**本地 ONNX**，在本机为文档建立索引；或选**在线 Embedding**，使用你已在**管理 → 模型**中配置好的嵌入模型。

**3. 如需本地模型，先下载再保存**

选择**本地 ONNX**时，先下载模型再保存。中文文档可从推荐模型入手，例如 `BAAI/bge-small-zh-v1.5`。更换向量模型或 OCR 设置会重建全部知识库索引。

**4. 可选 OCR**

需要图片或扫描 PDF 时，打开**图片与扫描件 OCR**。选**本地 ONNX**（RapidOCR，保存时自动安装组件和默认中英文模型），或**在线视觉模型**（图片和扫描页会发给所选提供商）。

功能未启用或模型未就绪时，其他用户会看到请联系管理员的提示。

## 创建并放入文档

**1. 创建知识库**

点击**创建知识库**，填写名称，可选填写描述与图标。打开**共享**，让本实例其他用户可以阅读。打开**默认启用**后，*你自己的*新对话会自动带上该库；其他人看到共享库后仍需在对话中手动勾选。

**2. 添加文档**

点击**上传文档**或把文件拖到本页。支持文本（md / txt / rst / html / json / yaml 等）、表格（csv / tsv / xls / xlsx / xlsm）、pdf / docx / pptx。开启 OCR 后还支持 png / jpg / webp 图片及扫描 PDF。也可以点**新建文件**写 markdown 或纯文本，或点**新建文件夹**整理文件。

**3. 等到状态变为「就绪」**

Octop 会为每个文件建立索引，并显示上传进度。状态从**等待**或**索引中**变为**就绪**。在页面内保存编辑会重新索引该文件。

**4. 在对话中使用**

在输入框打开**知识库**，勾选本轮要用的库。专家用到文档时，回复下方会列出源文件；点击可按原排版预览，也可下载原文。

## 共享与限额

* 只有所有者（或管理员）可以编辑知识库。
* 共享知识库对本实例所有已登录用户可读。
* 每人最多创建 **20** 个知识库。每个库有**文档数量上限**（默认 **100**，`0` 表示不限制）。
* 单次上传受服务器文件大小上限限制（默认 **100** MB）。

## 下一步

> [card] [知识库 API](https://octop.mintlify.site/zh/api/knowledge.md)
>
> 通过 HTTP 创建知识库并上传文档。

> [card] [对话 API](https://octop.mintlify.site/zh/api/chat.md)
>
> 了解对话回复如何带上知识库引用。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.