知识库系统教程
知识库让 Memfit 能基于你的资料工作。它适合存放产品文档、团队规范、项目说明、安全资料、历史经验和需要长期复用的领域知识。
本教程按一个固定结构学习：
| 功能 | 输入 | 观察结果 |
|---|---|---|
| 你要用知识库做什么 | 你需要准备的文件、名称、构建方式或查询条件 | 你应该在页面里看到什么结果 |
先理解知识库流程
知识库不是“把文件丢进去就结束”。一个完整流程通常是：
| 功能 | 输入 | 观察结果 |
|---|---|---|
| 创建入口 | 进入 知识库 模块，点击顶部 + | 出现新建知识库弹窗 |
| 新建 / 导入 | 知识库名称、上传文件、构建模式、Tags | 生成一个可管理的知识库 |
| 上传并构建 | 文档文件、构建模式、可选高级参数 | 出现构建状态、Data Card、处理日志 |
| 查看结果 | 实体、知识、向量视图 | 可以看到结构化抽取结果和数据明细 |
| 关系图谱 | 选择实体、深度、图谱导出方式 | 看到实体关系网络 |
| 在 Agent 使用 | 挂载知识库并提出任务 | Agent 基于你的资料回答或执行分析 |
提示
最简单的使用方式：进入知识库模块 → 新建知识库 → 上传文件 → 等待构建完成 → 在 Agent 中引用这个知识库提问。
1. 进入知识库模块
知识库入口在 Agent 工作台左侧模块区。进入后，你可以管理已有知识库，也可以新建或导入知识库。
| 功能 | 输入 | 观察结果 |
|---|---|---|
| 打开知识库 | 点击左侧 知识库 模块 | 看到知识库管理页 |
| 新建知识库 | 点击顶部 + | 打开新增知识库弹窗 |
| 导入知识库 | 点击导入入口 | 可以导入已有知识库或文件资料 |
| 搜索知识库 | 输入关键字 | 列表只显示匹配的知识库 |
观察时重点看：
- 左侧是否已经切换到知识库模块。
- 顶部
+是否可用于新建知识库。 - 当前页是知识库列表还是某个知识库详情页。
2. 新建知识库
新建知识库时，重点不是把字段填满，而是让名称、文件和构建模式足够清晰。
| 功能 | 输入 | 观察结果 |
|---|---|---|
| 命名知识库 | 清晰名称，例如“项目 A 安全规范”“产品使用手册” | 后续列表和 Agent 引用时容易识别 |
| 上传文件 | 拖入文件，或粘贴多个文件路径 | 文件数量被识别，等待构建 |
| 选择构建模式 | 增强知识图谱索引 或 仅构建知识索引 | 决定是否分析实体和关系 |
| 设置 Tags | 项目名、版本、资料类型 | 后续筛选和管理更方便 |
| 高级配置 | 只在需要调整分块、并发、模型时展开 | 保持默认也可以完成第一次构建 |
推荐选择：
| 场景 | 推荐模式 | 原因 |
|---|---|---|
| 只想让 AI 检索和回答文档问题 | 仅构建知识索引 | 构建更快，适合普通手册和规范 |
| 想分析实体、概念、章节、依赖关系 | 增强知识图谱索引 | 可以生成实体关系和图谱 |
| 资料很多且第一次尝试 | 先选 仅构建知识索引 | 先验证资料质量，再做结构化分析 |
推荐命名：
项目A-安全规范-2026
Memfit-用户手册
Yaklang-规则编写经验
3. 构建与日志查看
知识库创建后，Memfit 会对文件进行切片、知识抽取、实体分析和索引构建。你可以通过 Data Card 与日志判断构建状态。
| 功能 | 输入 | 观察结果 |
|---|---|---|
| 查看构建状态 | 打开知识库详情页 | 顶部显示构建中、可用或失败状态 |
| 查看 Data Card | 切换到 Data Card 区域 | 看到分块数量、知识实体分析、构建目标 |
| 查看日志 | 打开日志页签 | 看到 chunk、media type、实体分析等处理过程 |
| 判断是否完成 | 等待日志停止更新，状态变为可用 | 后续可以检索、分析或在 Agent 中使用 |
观察时重点看：
- 文件是否被识别。
- 构建是否进入处理日志。
- 是否出现失败、空文件、格式无法解析等提示。
- Data Card 中是否有分块、实体或构建目标。
如果构建失败，先检查：
- 文件路径是否正确。
- 文件是否为空或无法读取。
- 文件格式是否过于复杂。
- 是否一次上传了太多无关资料。
4. 查看实体 / 知识 / 向量结果
构建完成后，可以在结果页切换不同视图。这个页面用于确认知识库里到底生成了什么数据。
| 功能 | 输入 | 观察结果 |
|---|---|---|
| 查看实体 | 切换到 实体 视图 | 看到组织、章节、概念、事件等结构化对象 |
| 查看知识 | 切换到 知识 视图 | 看到知识片段、摘要或可检索内容 |
| 查看向量 | 切换到 向量 视图 | 看到向量化后的索引数据 |
| 搜索结果 | 输入关键词 | 表格过滤到相关实体或知识 |
| 查看详情 | 点击某行详情 | 看到来源、描述、提取结果和上下文 |
观察时重点看：
- 是否出现大量无意义实体。
- 知识片段是否能保留上下文。
- 结果是否能对应原始文档章节。
- 搜索关键词是否能找到预期内容。
如果结果太乱：
把不同主题拆成多个知识库。
给文档补充清晰标题。
减少一次上传的无关资料。
重新选择构建模式并构建。
5. 实体关系图谱分析
当知识库启用结构化分析后，可以使用关系图谱查看实体之间的连接。它适合发现概念关系、章节结构、组件依赖和知识网络。
| 功能 | 输入 | 观察结果 |
|---|---|---|
| 选择实体 | 在实体列表中勾选一个或多个实体 | 下方关系图谱出现选中节点 |
| 调整深度 | 设置图谱深度，例如 2 | 图谱显示更近或更远的关联实体 |
| 生成关系 | 点击从实体生成知识图谱 | 图谱节点和连线更新 |
| 导出图谱 | 点击 SVG 或 Code | 得到可用于报告或复查的图谱结果 |
观察时重点看：
- 中心节点是否是你关心的实体。
- 关系是否能解释文档结构或业务逻辑。
- 深度过大时是否变得难以阅读。
- 图谱是否适合放进报告或用于继续提问。
推荐做法：
先选择 1 到 3 个核心实体。
深度从 1 或 2 开始。
图谱太复杂时，减少实体数量或降低深度。
6. 在 Agent 中使用知识库
知识库最终要回到 Agent 使用。你可以在资源区挂载知识库，也可以在输入框中通过 @ 显式引用。
| 功能 | 输入 | 观察结果 |
|---|---|---|
| 挂载知识库 | 在 Agent 资源区选择目标知识库 | 当前对话可以检索该知识库 |
| 显式引用 | 在输入框使用 @知识库名称 | Agent 知道必须基于该知识库回答 |
| 限制来源 | 写明“只基于知识库回答” | 回答更容易遵守资料边界 |
| 检查证据 | 要求输出来源、章节、证据片段 | 结果更容易复核 |
推荐写法：
请只基于 @Memfit用户手册 回答：
如何创建知识库并查看构建日志？
如果知识库没有提到，请明确说“资料中未提到”。
用于分析任务：
请基于 @团队安全规范，检查 @src/auth 的权限校验逻辑。
输出风险等级、证据路径、相关规范条款和修复建议。
观察时重点看：
- Agent 是否明确使用了知识库。
- 回答是否引用了资料来源或证据。
- 如果资料不足，是否如实说明不足。
- 是否混入了知识库之外的猜测。
常见使用流程
| 步骤 | 功能 | 输入 | 观察结果 |
|---|---|---|---|
| 1 | 选择知识库模块 | 进入知识库页面 | 切换到知识库管理 |
| 2 | 新建 / 导入知识库 | 名称、文件、构建模式 | 知识库创建成功 |
| 3 | 上传文档并构建 | 文件、Tags、高级配置 | 进入构建日志和 Data Card |
| 4 | 查看日志与结果 | 日志、实体、知识、向量视图 | 确认资料已被处理 |
| 5 | 浏览结构化结果 | 搜索关键词、查看详情 | 找到实体、知识和向量数据 |
| 6 | 分析关系图谱 | 选择实体、设置深度 | 生成实体关系网络 |
| 7 | 在 Agent 中使用 | @知识库名称 + 任务 | Agent 基于资料回答或执行 |
写好知识库资料
| 功能 | 输入 | 观察结果 |
|---|---|---|
| 让资料可检索 | 清晰标题、分段、关键词 | 搜索更容易命中 |
| 保留来源 | 文档版本、来源、更新时间 | 回答更容易复核 |
| 控制主题范围 | 一个知识库放一个主题或项目 | 检索结果更集中 |
| 拆分长文档 | 使用章节标题和小段落 | 分块结果更自然 |
| 诊断质量 | 用真实问题测试 | 能发现资料缺失或构建问题 |
一个好的知识条目可以这样写：
场景：Node.js 项目依赖审计
结论：升级依赖前需要先运行测试和构建，避免锁文件变化导致部署失败。
来源：团队发布流程 2026 版
常见问题
Agent 没有引用知识库
确认知识库已经构建完成，并且当前对话已挂载知识库。提问时明确写“只基于这个知识库回答”。
检索结果不准确
优先检查资料是否过杂、标题是否清晰、分块是否合理。必要时拆成多个主题知识库。
图谱太乱
减少选中实体数量，把深度调到 1 或 2，再重新生成图谱。
导入后没有生效
新增资料后需要重新构建。构建失败时先查看日志，再检查文件路径、格式和内容。