> 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" %}
Office 文档（`.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 %}

***

## 将知识库与你的角色一起使用

### 示例

我们上传了一个名为 **Employee Onboarding Guide.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>

### 通过连接文件进行测试

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

**结果：** 这次，角色的回复基于 **Employee Onboarding Guide** 文件中提供的具体步骤。

<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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.