> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/convai-playground/character-customization/knowledge-bank.md).

# 知识库

了解如何使用知识库上传、管理并连接知识文件到你的 AI 角色，包括 RAG、上下文内检索和多模态文件。

{% embed url="<https://youtu.be/0Zac4X0flHg>" %}

## 简介

该 **知识库** 这是您存储和管理信息的地方，您的 AI 角色可在对话中访问这些信息。通过上传文档或直接添加文本，您可以为角色提供特定领域知识，使其能够给出更准确、更相关、且更具上下文感知的回复。

上传到您的知识库的所有文件都与您的 Convai 账号关联，并且可以连接到您的任意角色。这使它成为训练角色以回应公司特定、产品特定或主题特定信息的重要工具。

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FH8Quj2BAWTF18lt7oF2W%2Fimage.png?alt=media&amp;token=23b9d66f-1c88-471f-b3c7-519940f0739b" alt=""><figcaption></figcaption></figure>

***

## 检索模式：RAG 和上下文内

知识库为您的角色使用已连接知识提供两种方式。您可以在知识库标签页顶部选择模式。

* **RAG** —— 经典模式。已连接的文件会被索引，角色每次只检索与用户消息最相关的片段。最适合 **大型** 文本知识库，其中只有一小部分内容与某个特定问题相关。RAG 仅接受 **仅文本文件** (`.txt`, `.csv`).
* **上下文内** —— 整个已连接知识库会在每一轮直接放入角色上下文中（并为提高效率进行缓存）。最适合 **紧凑、高价值的** 您希望角色始终完整掌握的知识——并且它支持 **多模态** 文件（图片、PDF、音频、视频）以及文本，具体取决于所选的 LLM。

{% hint style="info" %}
上下文内知识库仅适用于 **受支持的 LLM**。启用上下文内后，角色的 LLM 会自动设置为受支持的模型。如果之后切换到不支持上下文内知识库的模型，Convai 会要求您确认——切换后会关闭上下文内并回退到 RAG（仅文本）。
{% endhint %}

***

## 支持的文件类型

您可以上传并连接的文件类型取决于检索模式；对于上下文内模式，则取决于所选的 LLM。

| 模式       | 受支持的文件                                                           |
| -------- | ---------------------------------------------------------------- |
| **RAG**  | 仅文本—— `.txt`, `.csv`                                             |
| **上下文内** | 文本（`.txt`, `.csv`), **图片**, **PDF**, **音频**, **视频** —— 受所选模型能力限制 |

并非每个上下文内模型都支持每种模态。例如，某些自托管模型只接受文本和图片。知识库标签页会显示一行 **“所选模型支持的文件类型”** ，因此在您选择文件之前，始终可以知道当前模型接受哪些类型。上传选择器和拖放仅接受这些类型。

{% hint style="warning" %}
办公文档（`.doc`, `.docx`, `.ppt`, `.pptx`, `.xls`, `.xlsx`，…） **包含** 受支持。模型无法直接读取这些文件，它们也不会为此功能提取文本。请先将它们转换为 `.txt`/`.csv` 或 PDF。
{% endhint %}

### 上下文内大小限制

上下文内知识库会将整个已连接知识库放入提示中，因此它有 **固定大小上限**。如果您已连接的文件超过限制，知识库标签页会显示超限警告，并阻止进一步上传，直到您删除一些文档，使其回到上限以下。RAG 没有此类每次提示的限制（总体存储仍取决于您的套餐）。

***

## 知识库部分

### 1. 我的文档

* 显示上传到您账号的所有文件。
* 显示信息：
  * **名称** – 文件名。
  * **类型** – 文件的模态类型（文本、图片、PDF、音频或视频）。
  * **大小** – 文件大小。
  * **状态** – 文件是否为 **可用** （可直接使用）以及是否 **已连接** 已连接到当前角色。
* 可用操作：
  * **连接** – 将文件连接到当前角色。
  * **断开连接** – 将文件与角色分离（它仍保留在您的知识库中，但处于非活动状态）。
  * **编辑** – 修改文本文件内容。
  * **下载** – 将文件保存到本地。
  * **删除** – 永久删除文件。

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2F3RLtS9TSInWqplCIy4Gp%2Fimage.png?alt=media&amp;token=a2caeb29-35bf-43a0-8b46-0fda545825b0" alt=""><figcaption></figcaption></figure>

### 2. 上传知识

* 从您的计算机上传文件。
* 在 **RAG** 模式下，仅 `.txt`/`.csv` 被接受。在 **上下文内** 模式下，选择器接受该 **所选模型** 支持的文件类型（文本、图片、PDF、音频、视频）。
* 上传后，文件会存储在您账号的知识库中，可供任何角色使用。

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FV1dQ02OaLSmNn6J1HlrJ%2Fimage.png?alt=media&amp;token=bae47828-4b0f-4b15-9243-961e9c98953e" alt=""><figcaption></figcaption></figure>

### 3. 添加知识

* 通过输入 **纯文本** 直接在编辑器中创建一个新的文本文件。
* 为文件命名并以 `.txt` 格式保存它。

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2Fpe5rc3ZHqO1NkdJ5DFys%2Fimage.png?alt=media&amp;token=76b1b3a1-8d68-412a-bf09-a91b7994985c" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
文件处理期间，其状态显示为“学习中…”。请偶尔刷新，直到状态变为 **可用**。在上下文内模式下，原始媒体（图片、音频、视频）会立即可用——无需等待索引。
{% endhint %}

***

## 在您的角色中使用知识库

### 示例

我们上传了一个名为 **员工入职指南.txt** 的文件，内容如下：

```
本文档为新员工提供逐步指导。
在入职后的前 3 天内完成 HR 文档。
参加强制性的入职培训会。
通过 IT 支持设置公司邮箱和访问凭证。
阅读行为准则和数据隐私政策。
```

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FyqqwjrKbzUuWGTTx8iG3%2Fimage.png?alt=media&amp;token=7f71e190-7173-410b-a122-b89314e436b9" alt=""><figcaption></figcaption></figure>

### 未连接文件时测试

* 打开 **聊天框**.
* 询问： *“我是新员工。我在这里的第一周应该做什么？”*
* 结果：角色会使用其通用个性和 AI 模型知识作答，而不是使用上传的文件。

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2F8WVbBCj6vzcko3bM01qE%2FScreenshot%202025-08-08%20194114.png?alt=media&amp;token=06c86da8-53a6-4efe-9f10-2955edf6e179" alt=""><figcaption></figcaption></figure>

### 连接文件后测试

* 前往 **知识库** → **我的文档**.
* 点击 **连接** 中的文件。
* 在聊天框中，点击 **重置聊天** （左上角）以开始新会话。
* 再次提出同样的问题。

**结果：** 这一次，角色的回复基于 **员工入职指南** 文件。

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FQFygTYzCWMB8Ul3visDG%2FScreenshot%202025-08-08%20194207.png?alt=media&amp;token=e88e8e27-c41e-4213-a8fc-944f80d06012" alt=""><figcaption></figcaption></figure>

***

## 最佳实践

{% hint style="info" %}
始终 **在连接新的知识文件后重置聊天会话** ，以便使用最新数据。
{% endhint %}

{% hint style="info" %}
使用 **RAG** 适用于大型文本知识库，而 **上下文内** 适用于紧凑、始终相关的知识，或者当您需要多模态文件（图片、PDF、音频、视频）时。
{% endhint %}

{% hint style="info" %}
该 **总存储大小** 上传文件的限制取决于您的 Convai 订阅套餐。有关限制，请参见 [**定价**](https://convai.com/pricing) 页面。上下文内知识库另外还有固定的每次提示大小上限。
{% endhint %}

***

## 结论

知识库是一种强大的方式，可为您的角色提供精确可靠的信息。请选择 **RAG** 以从大型文本语料库中检索最相关的段落，或选择 **上下文内** 为您的角色提供其完整知识库——包括图片、PDF、音频和视频——在每一轮都可使用。无论哪种方式，连接特定领域知识都能确保您的 AI 不仅具有人格，还具备以准确和权威的方式回答问题的专业知识。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.convai.com/api-docs/zh/convai-playground/character-customization/knowledge-bank.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.