AstrBot 知识库
TIP
需要 AstrBot 版本 >= 4.5.0。
我们在 4.5.0 版本中重新设计了全新的知识库系统，AstrBot 将原生支持知识库功能。下文介绍的是新版知识库的使用方法。如果您使用的是之前的版本，请参考旧版知识库使用文档，我们建议您升级到最新版以获得更好的体验。
配置嵌入模型
打开 模型提供商（/providers），切换到 嵌入 标签，点击 新增，选择所需的提供商类型。
目前 AstrBot 支持兼容 OpenAI API 和 Gemini API 的嵌入向量服务。
在左侧选择提供商，在右侧填写 API 地址、API Key、模型名称等配置。
配置完成后，点击保存。
配置重排序模型（可选）
重排序模型可以一定程度上提高最终召回结果的精度。
和嵌入模型的配置类似，打开 模型提供商，切换到 重排序 标签，点击 新增，选择所需的提供商类型并保存配置。
创建知识库
AstrBot 支持多知识库管理。在聊天时，您可以自由指定知识库。
打开侧边栏的 知识库（/knowledge-base），点击 创建知识库。
填写名称等信息，在 嵌入模型 中选择刚创建的嵌入模型；如需重排序，在单独的 重排序模型（可选） 中选择模型，然后点击 创建。
TIP
一旦选择了一个知识库的嵌入模型，请不要再修改该提供商的模型或者向量维度信息，否则将严重影响该知识库的召回率甚至报错。
上传文件
创建好知识库之后，可以为知识库上传文档。支持同时上传最多 10 个文件，单个文件大小不超过 128 MB。
使用知识库
打开 配置文件，选择要修改的配置文件，在 AI 配置 → 能力 → 知识库 中选择要使用的知识库，点击右下角的 保存配置。不同配置文件可以使用不同的知识库。
附录：高性价比的嵌入模型申请
硅基流动
截止至 2026 年 5 月 3 日，BAAI/bge-m3 模型在该平台免费。