数据存放在哪里
所有知识库共用同一个 LanceDB 数据库,每个知识库对应其中的一张表。当 Enconvo 重建某个知识库的索引时,会在旧表旁写入一张新表,待新表准备就绪后再切换过去,因此重建期间搜索仍可正常使用。
每个知识库都有一个 ID。API 中对应的参数为
knowledge_base_id,Enconvo 会以 knowledge_base|<id> 命令形式运行该知识库。要复制知识库的 ID,请从知识库顶部打开 知识库设置,然后进入 高级。
存储占用取决于原始文件、提取出的文本、文本块数量和向量维度。请监控集合的实际磁盘使用量,而不要仅凭文档数量估算。请独立于搜索索引保存源文件和备份。
内容如何进入知识库
读取
Enconvo 会使用最适合的工具读取每种类型的条目:切分为文本块
Enconvo 会根据内容的书写语言,将文本切分为相应大小的文本块:
它会在保证文本块不超过大小限制的前提下,尽量在最自然的边界处切分,尝试顺序如下:
- 段落
- 行
- 句子
- 分句
- 单词
- 硬切分(最后手段)
向量化(Embedding)
所有知识库使用同一个嵌入模型:EmbeddingGemma 300M。你可以在 设置 → 记忆 → 嵌入模型 中选择它的运行位置:- 这台 Mac:免费,且数据不会离开你的 Mac,但在为新内容建立索引时会占用 GPU。需要配备 Apple 芯片的 Mac。
- Enconvo Cloud:使用你的 Enconvo 账户免费提供。正在建立索引或搜索的文本会发送到 Enconvo Cloud。
存储
每个文本块在知识库的表中占一行:
Enconvo 还会为
text 维护一个由短字符片段构成的全文索引,从而能够精确匹配人名、数字、代码以及中日韩词汇。
搜索如何工作
每次搜索会同时对知识库的文本块执行最多三种查找:- 按语义:使用同一个模型对查询词生成向量,并查找最接近的向量。
- 按字词:对查询中的每个词执行全文(BM25)搜索,过滤掉常见的英文停用词。
- 按标题:查找标题匹配查询词的条目,并取其中与查询最接近的文本块。
保持索引健康
Enconvo 会自动创建全文索引并整理数据表。如果某个知识库是使用旧版切分器或不同的嵌入模型建立的,Enconvo 也会根据已保存的文本自动重建其索引,无需重新读取原文件。 如需手动重建:- 整个知识库:从知识库顶部打开 知识库设置,进入 索引与搜索,点击 重建整个索引 旁的 重新索引…。重建期间搜索仍可正常工作。
- 单个条目:右键点击该条目并选择 重新索引。
关联文件夹
如果发现缺少条目,请先检查源文件夹的导入和同步状态。在 来源与捕捉 中,每个关联文件夹都会显示它是否正在同步、上次同步的时间,或提示找不到源文件夹,并提供 立即同步、重新关联… 和 自动同步。 接着分别检查条目的内容提取状态和向量索引状态:条目的 流水线 会将 内容解析 和 搜索索引 显示为两个独立阶段,能够读取到提取出的文本并不代表向量索引已经完成。修复服务提供商或文件访问错误后,请重新索引该条目。 源文件夹始终是关联文件的权威来源。请将离线驱动器恢复与文件删除区分开:当找不到源文件夹时,知识库会保留已有条目。在将一次导入视为完成之前,请先查看被跳过的文件数量。整理多个知识库
每个知识库都有各自独立的文档、索引和数据表。请按你的检索方式来划分内容:
要同时搜索多个知识库,可以通过上下文选择器将它们附加到对话中,或在智能体设置中指定关联的知识库。如果搜索时未指定知识库,则会搜索除“记忆”之外的所有知识库。
在代码中使用知识库
Knowledge Base 插件在 Local API 上提供了相应路由,方便其他插件、工作流和脚本调用。主要路由包括:
打开 设置 → API 即可查看当前安装版本中各路由的参数说明。
知识库步骤可以无缝融入工作流和自动化中,例如:
故障排除
相关内容
知识库基础
开始使用知识库
知识库 MCP
从其他 AI 客户端搜索你的知识库
记忆
搜索模型以及智能体记住的内容
工作流
自动化处理知识库任务