跳到主要内容
feedback
feedback

知识库

知识库

知识库可以帮你整理和查找资料。导入文件后,你可以搜索内容、向知识库提问,也可以让智能体根据这些资料回答问题。

你可以用它管理产品资料、使用手册、公司制度和项目文档。

最快上手

第一次使用时,按下面的顺序操作即可:

  1. 进入知识库,新建一个知识库。
  2. 填写知识库名称和用途。
  3. 打开知识库,导入文件或文件夹。
  4. 等待导入队列显示已完成
  5. 打开搜索,用资料中的关键词测试结果。
  6. 需要在智能体对话中使用时,再到设置中授权智能体。
PocketClaw 知识库列表
从左侧菜单进入知识库

新建知识库

  1. 点击左侧菜单中的知识库
  2. 点击新建知识库
  3. 填写名称、标识和用途。
  4. 点击保存
新建知识库窗口
填写名称、标识和用途

填写时注意:

  • 名称:显示在页面上,创建后可以修改。
  • 标识:用于生成目录和链接,创建后不能修改。建议使用简短的英文或拼音。
  • 用途:简单说明这里存放什么资料。例如:“产品使用说明和常见问题”。

导入资料

打开知识库,点击右上角的导入,然后选择文件或文件夹。

知识库导入菜单
选择导入单个文件或整个文件夹

支持的文件格式包括:

mdmarkdowntxthtmlpdfdocxpptxjpgjpegpng

导入文件夹时,原来的文件夹结构会保留下来。不支持的文件不会导入。同一路径下如果已有同名文件,新文件不会覆盖旧文件。

文件夹导入限制

单个文件不超过 5 MB;一次最多导入 100 个文件,总大小不超过 100 MB。

导入后,系统会自动处理资料。处理完成后,资料才可以用于搜索和问答。文件较多时,请耐心等待。

查看导入进度

点击页面右上角的导入队列,可以查看处理进度:

  • 待处理:正在排队。
  • 处理中:系统正在读取和整理资料。
  • 已完成:资料已经可以使用。
  • 失败:在任务条目中查看原因,解决问题后再重试。

不需要的任务可以取消。失败的任务可以重试或删除。

知识库导入进度面板
点击右上角的导入队列查看处理进度

浏览资料和知识页面

文档页面左侧,可以查看两类内容:

类型说明
知识页面系统整理后的内容,用于搜索和回答问题
原始资料你导入的文件,可以查看原文或下载备份

点击知识页面即可阅读。需要修改时,点击右上角的编辑。修改完成后,点击保存

浏览知识页面
左侧选择知识页面,右侧查看内容和来源

编辑知识页面

  1. 在左侧选择需要修改的知识页面。
  2. 点击右上角的编辑
  3. 选择文档编辑Markdown 模式。
  4. 修改完成后点击保存
编辑知识页面
知识页面支持文档编辑和 Markdown 两种模式
提示

修改内容时,建议保留清楚的标题和资料来源,方便以后查找。

搜索知识库

打开搜索页面,输入关键词或问题,然后点击搜索。系统会找出相关内容,并给出简短回答。

搜索适合以下场景:

  • 查找某个产品、人员或功能的信息。
  • 查看回答来自哪段原文。
  • 确认知识库中有没有某项内容。

如果没有结果,可以换一个更短、更准确的关键词再试。

搜索框也可以直接输入完整问题。例如:

根据知识库总结产品安装步骤,并列出三个最常见的问题。

对于重要信息,建议同时查看搜索结果或原始资料,确认回答是否准确。

搜索知识库
输入关键词或问题,搜索整个知识库

查看知识图谱

打开知识图谱,可以查看不同知识内容之间的关系。

  • 搜索名称,可以快速找到某个主题。
  • 按类型筛选,可以减少无关内容。
  • 点击图中的圆点,可以查看相关内容并打开对应页面。
  • 在页面中输入 [[页面名]],可以把两个知识页面连接起来。
知识图谱页面
通过知识图谱查看页面之间的关系

让智能体使用知识库

新建知识库后,智能体默认不能使用其中的资料。你需要手动授权:

  1. 打开知识库的设置页面。
  2. 找到智能体访问权限
  3. 找到需要授权的智能体,打开右侧开关。
  4. 点击开始对话,发送一条消息进行测试。
知识库设置页面
配置名称、语言、解析模型和用途
智能体访问权限
打开开关,授权智能体访问知识库

授权后,智能体就可以搜索和读取当前知识库。新权限会从下一条消息开始生效。

如果希望智能体只根据知识库回答,可以开启知识库限定模式。找不到相关资料时,智能体会直接说明没有找到,不会自行猜测。

更新或删除资料

新文件不会直接覆盖同名旧文件。需要更新资料时:

  1. 先下载原文件备份。
  2. 删除旧的原始资料。
  3. 重新导入新版本。
  4. 等待处理完成,再搜索一次,确认新资料可以使用。

删除内容时注意:

  • 删除原始资料后,由它生成的知识页面也会被删除。
  • 删除知识页面后,它不会再用于搜索和回答。重新导入资料时,系统可能再次生成该页面。
  • 删除整个知识库后,里面的所有内容都会被永久删除,无法恢复。

常见问题

导入后搜索不到内容

先查看导入队列,确认任务已经完成。如果任务失败,请查看失败原因并重试。如果任务已完成,可以换用资料中的原词搜索。

智能体不使用知识库

打开设置 → 智能体访问权限,确认对应智能体的开关已经打开。然后发送一条新消息测试。

导入解析失败

请检查文件格式和大小是否符合要求,并确认文件可以正常打开。图片、PDF 和 PPTX 等文件需要使用文档解析服务;如果解析失败,请稍后重试,或转换为 Markdown、TXT 格式后重新导入。设置页面中的导入解析模型用于后续整理和生成知识页面。

回答与原文不一致

打开搜索结果,对照知识页面和原始资料。如果知识页面有错误,可以直接编辑。如果原始文件已经过期,请删除旧文件,再导入新文件。

注意

上传前,请确认你有权使用这些资料。不要上传 API Key、密码、身份证号等敏感信息。