知识库
是什么
把你的本地文档上传到平台，经解析、分块、向量化后供 Agent 检索使用 —— 让 Agent 基于你的私有知识作答，而不是只靠模型的通用知识。典型场景：产品 FAQ 客服、内部制度问答、研究资料辅助分析。
创建流程 (四步)
创建知识库:填写名称、描述，选择检索设置。支持三种检索方式：
- 混合检索(推荐默认):向量 + 全文结合
- 向量检索:语义相似度匹配，适合口语化提问
- 全文检索:关键词精确匹配，适合术语、代码、编号类查询
- 也可点击「创建空白知识库」先建库、后续再补文件
上传文件:拖拽或选择文件，每次最多 5 个、单个不超过 10MB;支持 DOCX、PPTX、HTML、PDF、MD、CSV、XLSX、VTT、JPG、PNG、TXT
文本设置:按文件类型自定义分段长度 (默认 1024 字符)、文本预处理规则 (替换连续空格换行/删除 URL 与邮箱)、分段语义增强(启用图片内容理解 vlm),并点击「预览块」预览分块效果 —— 分块质量直接决定检索质量，值得在这一步多花时间
处理并完成:查看嵌入处理进度 (每个文件独立显示步骤与百分比),下方汇总本次的分段模式、分块长度、预处理规则与检索设置;可直接「转到文档列表页」,处理在后台继续
日常管理
知识库列表:知识库 tab 以卡片展示全部知识库 (检索方式、文档数、更新时间),顶部展示容量使用进度;卡片右上角「…」进入管理操作
文档列表(知识库详情页):按处理状态筛选、按名称搜索;展示字符数、召回次数(哪些文档真正被用到)、上传时间与状态 (如「索引中」);每个文档支持启用/禁用开关与更多操作，右上角可继续「添加文件」
知识库设置:修改知识库的名称、描述与检索设置(混合/向量/全文可随时切换，混合检索支持高级设置调整权重)
分段编辑:点进单个文档可查看最终给到大模型的分块内容，支持对具体段落再编辑、编辑关键词;「添加分段」可在文档首段插入自定义内容并配关键词
召回测试:见下节
召回测试
入口在知识库详情页右上角 (添加文件按钮左侧)。左侧输入源文本(上限 200 字符)、确认检索方式，点击「测试」:
右侧展示命中的召回块:每块显示分块序号、字符数与相关性分数(如 0.67),用于判断检索质量：
- 召回块底部标注来源文件,可确认内容出自哪份文档
- 左下「记录」列表保留历史测试 (检索方法、query、时间),方便换检索方式对同一 query 对比效果
- 建议用"用户真实会问的问题"做 query，而不是文档里的原句——原句召回分数天然偏高，测不出真实效果
在流程中使用
两个挂载位置，均由 Agent 在必要时自动检索所选知识库：
① Agentic Chat:Agent 配置页的「知识库」区，点「+ 添加知识库」挂载 (与 Skills 区相邻，参考 Skill 体系 的配置页截图)。
② Chatflow / Workflow 的 Agent 节点:节点编辑面板中打开「知识库」开关，点 + 选择要挂载的知识库：
选好后以标签形式展示 (可挂多个):
写好描述，方便 Agent 召回
Agent 依靠知识库的名称与描述判断"什么问题需要查这个库"——描述要写清覆盖的内容范围(如"投资知识库，目前包括期权的相关数据"),Agent 遇到期权类问题时才知道该来检索;描述含糊或缺失会导致该召回时不召回：
运行时的召回效果
配置完成后，用户提问命中知识库覆盖范围时，Agent 会自动检索：推理过程中展示「知识库检索」步骤 (含检索词),回答正文中以 Document +N 标记标注引用来源：
点开「知识库检索」步骤可查看请求/响应详情——请求包含目标知识库与检索词，响应展示每个命中分块的内容、相关性分数 (score) 与排名 (rank),可用于排查召回质量：
提示词中应明确"仅基于检索到的内容作答，检索不到时如实说明",避免模型编造。
注意事项
- 容量随套餐:Starter 50MB / Pro 5GB / Premium 20GB;超限后禁止新增，超限文件按上传时间从最旧开始标记为禁用 (不参与检索),删文件或升级可恢复 —— 详见 Workspace 与套餐体系
- Embedding 计费:文档向量化按 token 消耗用量额度
- 合规:面向客户的知识库内容须来自合规来源，不得包含 PII 和未公开重大信息，见 数据使用与隐私限制
- 上线前用召回测试跑一遍典型问题，确认检索质量再发布
关联阅读
- 变量与数据流设计技巧 — 检索结果如何在流程中流转