Tip
需要 AstrBot 版本 >= 4.5.0。
我们在 4.5.0 版本中重新设计了全新的知识库系统，AstrBot 将原生支持知识库功能。下文介绍的是新版知识库的使用方法。如果您使用的是之前的版本，请参考旧版知识库使用文档, 我们建议您升级到最新版以获得更好的体验。
打开服务提供商页面，点击新增服务提供商，选择 Embedding。
目前 AstrBot 支持兼容 OpenAI API 和 Gemini API 的嵌入向量服务。
点击上面的提供商卡片进入配置页面，填写配置。
Note
OpenAI Embedding API Base URL 说明
- OpenAI Embedding 会在请求时自动补上
/v1后缀。例如，您填写https://api.example.com，实际请求地址为https://api.example.com/v1。 - 如果您的 API Base URL 已经包含
/v1，无需重复添加，系统会自动处理。
Gemini Embedding API Base URL 说明
- 建议填写
https://generativelanguage.googleapis.com，无需手动添加/v1beta。
配置完成后，点击保存。
创建嵌入模型提供商时，AstrBot 会自动检测模型的向量维度。系统会通过实际请求探测模型的维度信息，无需手动填写。
Tip
如果自动检测失败，请检查 API Key 和 API Base URL 是否正确配置，以及网络是否通畅。
重排序模型可以一定程度上提高最终召回结果的精度。
和嵌入模型的配置类似，打开服务提供商页面，点击新增服务提供商，选择重排序。有关重排序模型的更多信息请参考网络。
AstrBot 支持多知识库管理。在聊天时，您可以自由指定知识库。
进入知识库页面，点击创建知识库，如下图所示：
填写相关信息。在嵌入模型下拉菜单中您将看到刚刚创建好的嵌入模型和重排序模型（重排序模型可选）。
Tip
一旦选择了一个知识库的嵌入模型，请不要再修改该提供商的模型或者向量维度信息，否则将严重影响该知识库的召回率甚至报错。
创建好知识库之后，可以为知识库上传文档。支持同时上传最多 10 个文件，单个文件大小不超过 128 MB。
在配置文件中，可以为不同的配置文件指定不同的知识库。
- 打开 PPIO 派欧云官网，并注册账户（通过此链接注册的账户将会获得 15 元人民币的代金券）。
- 进入 模型广场，点击嵌入模型
- 点击 BAAI:BGE-M3 （截止至 2025-06-02，该模型在该平台免费）。
- 找到 API 接入指南，申请 Key。
- 填写 AstrBot OpenAI Embedding 模型提供商配置：
- API Key 为刚刚申请的 PPIO 的 API Key
- embedding api base 填写
https://api.ppinfra.com/v3/openai - model 填写你选择的模型，此例子中为
baai/bge-m3。