> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 知识库：让回答依据你的文件

长文档不必每次都贴进输入框。放进**知识库**之后，专家会找出相关段落，并在回复下方列出可以点开的来源。

从侧栏**设置**分组打开**知识库**。页面带有 **BETA** 标记。


![知识库](/images/ui-knowledge.png "知识库")

## 用一份你手头的文档试一次

如果页面提示联系管理员，先请管理员按下一节打开功能。已经启用时，直接做这四步：


### 创建知识库

点**创建知识库**，填写名称。需要的话补上描述和图标。容量不够默认的 **100** 份时，改**文档数量上限**；填 `0` 表示这一库不限制。打开**是否共享**，本实例其他人可以阅读。打开**是否默认启用**后，只有你自己的新对话会自动带上它，其他人仍要在对话里手动勾选。

### 放入文件

点**上传文档**，或把文件拖到页面上。支持文本（md / txt / rst / html / json / yaml 等）、表格（csv / tsv / xls / xlsx / xlsm）以及 pdf / docx / pptx。也可以点**新建文件**写 Markdown 或纯文本，或点**新建文件夹**整理。之后要调整位置时，打开文件或文件夹的菜单，点**移动到…**。文件夹会连同里面的内容一起移动。不能把文件夹移到它自己里面。

### 等到状态变成「就绪」

每个文件会从**待索引**或**索引中**变成**就绪**。页面上能看到上传进度。在页面里改完再保存，会重新索引这一份。

### 在对话里提问

在输入框打开**知识库**，勾选这一轮要用的库，然后提问，例如「这份手册里，报销需要哪些附件？」专家用到文档时，回复下方会列出来源。点开来源可以按原排版预览，也可以下载原文。

## 页面提示联系管理员时

管理员打开**知识库**，再进**知识库设置**。


### 启用知识库

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

### 选择索引方式

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

### 本地模型要先下载再保存

选**本地 ONNX**时，先下载模型再保存。模型文件已经在本机时，可以离线加载。中文文档可以从推荐模型开始，例如 `BAAI/bge-small-zh-v1.5`。更换向量模型或 OCR 设置会重建全部知识库索引。

### 需要时再开 OCR

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

开启 OCR 后，还可以上传 png / jpg / webp 以及扫描版 PDF。

## 谁能改、能放多少

- 只有所有者或管理员可以编辑知识库。
- 共享后，本实例所有已登录用户都可以阅读和选用。
- 每人最多创建 **20** 个知识库。每个库的文档上限默认 **100**，最大 **10000**，填 `0` 表示不限制。
- 单次上传受服务器文件大小上限约束，默认 **100** MB。

## 下一步


[**用程序上传**](/api/knowledge.md)

通过 HTTP 创建知识库并上传文档

[**在回复里看引用**](/api/chat.md)

对话接口如何带上知识库来源
