坑一：只上传不切分
把整份 PDF 或 Word 上传，检索命中后返回整篇，用户仍要自己找段落。模型拿到整篇也容易抓错重点。正确做法是按条款、步骤或问答对切分，一条只回答一个问题，并保留原文链接便于核对，切分粒度要试过再定。
坑二：没有责任人
知识库上线时人人参与，之后无人维护。制度改了、产品换了，条目仍是旧版。应给每条目标注负责人与复审日期，到期提醒；责任人调岗时要交接，否则条目会在半年内集体过期，且很难追溯到源头，只能重建。
坑三：新旧并存
旧版没有下架，与新版一起被检索到，答案取决于排序，用户无法判断该信哪条。应按生效日期过滤，旧版归档但不参与检索；确需保留对比时，明确标注哪一版有效，并写清替代关系，避免同一问题两种答案。
坑四：权限粗放
权限要么全开放、要么全封闭。全开放会让敏感内容进入问答，全封闭则一线查不到常用条目，最后绕过系统私下询问。应按岗位与业务范围做最小可见，并在组装阶段过滤，而不是在显示阶段隐藏，否则仍会泄露。
坑五与坑六：数量与评测
只看上传了多少文件、多少访问量，不看答案是否正确。数量指标容易做好看，却与业务价值无关。应建立固定问题集，定期抽测答对率、出处正确率与转人工比例，用这些指标决定下一步投入，也便于对外说明。
适用与不适用
适合谁
- 已经建过知识库但使用率低的团队
- 正准备把散落文档集中上云的企业
- 需要向管理层解释知识库价值的负责人
不适合谁
- 文档数量极少、口头沟通为主的团队
- 不愿指定条目责任人、也不想做复审的项目
典型场景
某零售企业的知识库上线一年，访问量不低但客服仍反复询问。抽查发现八成条目是整份文件，检索返回后还要人工翻阅；且三十多条政策存在新旧两版。改为条目化、按生效日期过滤并指定责任人后，转人工比例才下降。
可执行步骤
- 抽查检索结果，统计返回整篇与返回条目的比例，找出问题最集中的领域
- 列出同主题多版本并存的条目，确定有效版本，其余归档不参与检索，并写明替代关系。
- 为高频条目指定责任人与复审日期，写入岗位职责，到期自动提醒，复审结果留档。
- 按岗位梳理权限，改为组装阶段过滤，并保存过滤日志供审计，抽查发现问题即回收。
常见坑
- 整份文档入库，检索命中后返回几十页内容，用户放弃使用，转而私下问老员工，系统形同虚设，投入也白费。
- 没有责任人，制度更新后条目长期不改，答复与现行规定冲突，一线被客户投诉后才被发现，追责也难。
- 旧版未归档，同一问题两次回答不同，用户不知道该信哪次，客服只能逐条人工核对，效率反而更低。
- 只汇报上传数量与访问量，管理层看不到答案质量，投入持续但问题未解决，最终项目被叫停，前期白做。
自检与验收清单
- 条目是否按问题或条款切分，粒度经过验证，并保留原文链接。
- 是否标注责任人与复审日期，并有人交接，到期提醒。
- 旧版是否归档且默认不参与检索，并标注替代关系。
- 权限是否在组装阶段过滤并留日志，可供审计使用
- 是否用问题集抽测答案质量与出处，并按月汇总。
常见问题
文件太多，必须全部条目化吗？
不必。先做高频问题涉及的文档，通常占查询量的大部分；低频文档可以保留原文检索，但要标注适用范围。全面条目化成本很高，容易半途而废，按查询分布分批推进更现实。
没有专人维护怎么办？
可以先按领域指定兼任责任人，把复审写进岗位职责与季度考核，而不是靠自觉。条目量控制在可维护范围内，宁可少而准；无人维护时继续扩张，只会让过期内容更多、更难清理。
怎么证明知识库有用？
用固定问题集定期抽测，记录答对率、出处正确率与转人工比例，并与上线前的人工处理耗时对比。这些指标比访问量更能说明问题；若长期没有改善，应检查条目质量与切分，而不是继续加文档。