> 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" %}
文件处理期间，其状态会显示为“Learning…”。请不时刷新，直到状态变为 **Available**。In-Context 模式下的原始媒体（图像、音频、视频）可立即使用，无需等待索引。
{% 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>

### 未连接文件时进行测试

* 打开 **Chatbox**.
* 询问： *“我是一名新员工。入职的第一周我应该做些什么？”*
* 结果：角色会根据其通用个性和 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>

### 连接文件后进行测试

* 前往 **Knowledge Bank** → **My Documents**.
* 点击文件上的 **Connect** 。
* 在 Chatbox 中，点击 **Reset Chat** （左上角），以开始新会话。
* 再次提出相同的问题。

**结果：** 这一次，角色的回答将基于 **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、音频、视频）时，使用 **In-Context** 。
{% endhint %}

{% hint style="info" %}
总 **存储大小** 上传文件的限制取决于您的 Convai 订阅方案。请参阅 [**定价**](https://convai.com/pricing) 页面了解具体限制。In-Context KB 还设有固定的单提示大小上限。
{% endhint %}

***

## 总结

知识库是一种强大的方式，可为您的角色提供准确、可靠的信息。选择 **RAG** 从大型文本语料库中检索最相关的段落，或者选择 **In-Context** 在每轮对话中向角色提供完整的知识库——包括图像、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.
