跳到主要内容

知识库

上传运维手册和 SOP,故障调查、告警收敛、结果解读、触发器生成和平台体检解读时自动检索引用。需要配置向量模型。所有版本可用。

知识库保存团队自己的运维手册、SOP 和处置经验,位于侧栏 基础数据 组。模型分析故障时先在知识库中检索,把相关片段附在提示词中。知识库保存在网关的 state/kb_store.json(RST_KB_STORE),需要纳入备份。

知识库

启用知识库

知识库需要一个向量模型(Embedding)。没有配置时,页面提示 知识库未启用,AI 功能照常运行,只是不做检索。

前提条件

  • 管理员角色。

步骤

  1. 打开 设置 中的 AI 配置,找到 知识库向量模型(Embedding)。
  2. 输入 模型 ID。端点和 key 留空时复用聊天模型的端点和 key。
  3. 选择 测试连接,向量维度 自动回填。
  4. 打开 启用,保存。

更换为维度不同的向量模型时,已有知识库的索引维度不匹配,保存会被拒绝,需要先重建知识库索引。

上传文档

前提条件

  • 管理员角色。
  • 已启用知识库。

步骤

  1. 在 文档库 标签中选择 上传文档。
  2. 输入 标题,在 正文 中粘贴 Markdown 或纯文本。建议每篇 5000 到 20000 字符。
  3. (可选)在 元数据(可选) 中添加键值对,例如 source = network-wiki,最多 6 组。元数据随片段一起保存,检索时可以看到片段的来源。
  4. 选择 提交并 embedding。

网关把正文切成约 1200 字符的片段(相邻片段重叠 150 字符),逐段向量化后入库。文档库概览 显示 文档、内容片段 和 最近入库 时间。

删除文档会移除它的全部片段,不可恢复。

检索测试

步骤

  1. 在 检索测试 标签中输入一个问题。
  2. 选择返回条数,然后选择 检索。

结果按 相似度 从高到低排列。命中不理想时,换个问法,或检查文档标题和正文是否包含现场常用的叫法。

哪些功能会引用知识库

功能检索时机
故障调查调查单个故障、导出故障调查报告
告警收敛为每个收敛事件评分和给出处置建议
对话结果解读、数据解读
触发器与监控配置生成触发器
平台体检AI 解读,结果中注明 参考了知识库

每次检索取相似度最高的几个片段,只保留相似度不低于 RST_RAG_SCORE_THRESHOLD(默认 0.75)的片段。使用多语言向量模型时,相关片段的相似度可能落在 0.4 到 0.7 之间,可以适当调低该值。

本页内容