知识库搜索评估 - 使用说明（面向业务）

这是一款面向飞书知识库的“智能搜索与评估”工具。您只需用自然语言提出问题，系统会自动到您的知识库中检索相关文档，下载并解析内容，按相关度给予评分与摘要，并可选生成一份结构化的智能分析报告，帮助您更快定位关键资料与结论。

你能获得什么

• 智能搜索与聚合：自动优化关键词，可选择“多轮搜索评估”逐步扩展检索范围。
• 自动下载与解析：在权限允许范围内获取知识库文档内容，并进行统一解析展示。
• 相关性评估：为每份文档给出1-5分相关度评分，生成中文摘要、要点与评估理由。
• 推荐与报告：自动挑选高分文档作为“推荐”，可选一键生成专业的中文报告（Markdown 结构）。
• 实时进度反馈：全程展示“搜索→下载→解析→评估→报告”的进度与阶段状态。

开始使用（无需技术背景）

1. 登录系统。
   
2. 点击“进入知识助手”。
   
3. 直接用自然语言描述你的问题或目标，例如：“我们门店食品安全培训的标准流程有哪些要点？”
   
4. 可在设置中调整：
   • 单轮最大评估文档数（范围建议 5-50）：越大越全面，越小越高效。
   • 是否生成报告：关闭可加速并节省模型资源，开启可获得完整分析。
   • 启用多轮搜索评估：自动迭代关键词，建议最大轮次 2-5。

5) 发送后，等待处理完成；如有需要，可中止本次查询。

提示：问题越清晰，结果越准确。可补充范围限定（如“仅看2023年后的人事制度”）。

查询编写小技巧

• 目标明确：说明“要解决什么”“使用场景是什么”。
• 关键词合适：混合使用常用简称与全称更容易命中企业内部文档。
• 聚焦范围：若结果过多，可缩小时间、地域或业务线范围再检索。

结果长什么样

• 智能报告（可选）：包含“执行摘要、主要发现、详细分析、推荐建议、结论”等结构化内容，便于转述与汇报。

  

  

• 搜索结果：展示命中的文档列表与已使用的关键词。

• 下载与解析：显示成功与失败数；失败会给出中文原因（如“权限不足/无法下载”）。

  

• 相关性评估：每份文档包含“评分（1-5）+ 摘要 + 要点 + 评估理由”，并标注是否推荐，可点击查看原文进入知识库查看原文件内容。

  

能力边界与限制

• 权限边界：仅能访问您当前账号有权限查看的文档；无权或受限文件将被跳过。
• 文档类型：对常见知识库页面与文档支持较好；极少数格式可能解析不完整。
• 内容长度：特别长的文档会被截断处理（目前设置为超过6w字则阶段取前面部分），可能影响评估完整度（不影响原文）。
• 时长限制：单次查询通常在数分钟内完成；超时则会终止，建议减少文档数或关闭报告生成后重试。
• 网络与额度：偶发网络波动或模型额度限制会导致失败，可稍后重试。

提升成功率与质量的建议

• 尽可能说明你的目的、需求，让模型了解以生成更贴切的关键词
• 对于专业主题，补充若干行业术语或关键节点词汇。
• 若结果偏多或不准，尝试：启用多轮、减小或增大单轮文档数、重写问题更聚焦。

常见问题（中文提示）

• “未授权访问/需要登录”：请先完成登录；若在飞书客户端内，会自动尝试免登，若免登失败则会尝试弹出窗口获取授权，请运行弹窗。
• “没有找到相关内容”：尝试补充上下文或更换关键词；也可开启多轮并提高文档数，如果仍然没有改善，请整理输入与模型生成关键词信息进行反馈。
• “下载失败/无法解析”：多为权限或格式问题；可更换关键词或联系项目同学协助。
• “报告过长/不够聚焦”：可关闭报告生成，先查看高分文档的要点与摘要，或缩小问题范围后再试。

数据与安全

• 仅在您授权范围内检索与读取，不越权访问。
• 查询与临时解析内容仅用于本次处理，不做长期保存；请在下载/记录要点后自行妥善存档。

状态与范围

• 当前为 Beta 版本，能力与呈现将持续优化。
• 主要面向飞书知识库检索与文档评估场景，后续将逐步增强格式支持与分析指标。