知识库
知识库为角色提供专属的文档检索能力，上传 PDF、Markdown、TXT 等文件后，角色在对话中可自动检索引用相关内容，支持检索严格度、注入位置和二次精排（Rerank）等高级配置。
页面概览
页面顶部为角色名称和运行状态，右上角为「编辑配置」和「停止」按钮。
知识文档
操作按钮
| 按钮 | 功能 |
|---|---|
| 关联 | 关联已有的知识库文档 |
| 上传 | 上传新的知识文档 |
| 检索配置 | 展开/收起右侧检索配置面板 |
支持的文件格式
- Markdown (.md)
- TXT
- 其他文本格式
空状态
当没有上传任何文档时，页面中央显示：
- 云上传图标
- "暂无知识文档"
- 说明："上传 PDF、Markdown、TXT 等文件，角色将在对话中自动检索引用"
- 「上传第一个文档」按钮
检索配置
右侧面板提供知识库检索的高级配置选项。
二次精排（Rerank）
已启用后检索更准，约增加 1~2 秒
- 开关控制是否启用二次精排
- 启用后，向量检索结果会再用 Cross-Encoder 精排，更准但略慢
检索严格度
控制保留多少条检索结果。相似度分只在同一次检索内可比，跨问题不可比，所以这里用档位而非固定分数线。
三个档位可选：
| 档位 | 说明 |
|---|---|
| 宽松 | 保留更多检索结果，召回率高但可能引入不相关内容 |
| 标准 | 平衡召回率和相关性（默认推荐） |
| 严格 | 仅保留高相似度结果，精度高但可能遗漏相关内容 |
高级参数
点击「> 高级参数」可展开更多配置选项。
注入位置
检索到的片段插入到 prompt 的哪里
三个选项：
| 位置 | 说明 |
|---|---|
| 用户消息前 | 将检索片段插入到用户消息之前 |
| 用户消息后 | 将检索片段插入到用户消息之后 |
| 仅系统提示词 | 仅将检索片段注入到系统提示词中 |
二次精排（重复配置项）
向量检索后再用 Cross-Encoder 精排，更准但略慢
- 开关控制（与顶部的二次精排配置联动）
检索测试
右侧面板底部提供检索测试功能：
- 输入框："输入问题，测试知识库检索效果..."
- 搜索按钮：点击执行检索测试
使用检索测试可以在不发起正式对话的情况下，验证知识库的检索效果和配置是否合理。
知识库工作流程
- 上传文档：点击「上传」按钮，上传 PDF/Markdown/TXT 等文件
- 自动处理：系统自动对文档进行分段、向量化和索引
- 配置检索：在「检索配置」面板设置严格度、注入位置、Rerank 等参数
- 测试检索：使用「检索测试」输入问题，验证检索效果
- 对话引用：角色在对话中自动检索知识库，将相关片段注入 prompt 并引用回答
提示
初次配置知识库时，建议使用「标准」检索严格度和「用户消息前」注入位置，然后用「检索测试」验证效果。如果检索结果不够全面，切换到「宽松」；如果结果包含太多不相关内容，切换到「严格」。对于需要高精度的场景（如法律条款、技术文档），建议启用二次精排（Rerank）。