企业知识库搭建

企业知识库把制度、产品资料、项目文档和业务数据整理成可检索的知识来源。成员可以在工作台或对话中搜索，Agent 也可以把它作为任务上下文。

先想清楚三个问题

1. 给谁看：全公司、指定部门、指定角色，还是仅管理员？
2. 放什么：制度、产品文档、技术文档、客户资料、项目复盘？
3. 谁维护：哪个部门负责上传、审核和过期清理？

不要把所有文件都倒进一个“全员可见”的知识库。知识库的价值来自范围清楚、内容可信、有人维护。

第 1 步：创建知识库

建议按“使用场景”而不是“文件类型”划分：

知识库	内容	典型权限
公司制度	员工手册、报销、考勤、安全规范	全公司可见
产品资料	产品说明、价格政策、FAQ、销售话术	产品/销售/客服
技术文档	架构、接口、部署、故障复盘	研发/运维
客户项目	项目文档、交付物、会议纪要	项目成员
财务资料	预算、报表、税务政策	财务/管理层

创建时填写名称、描述、可见范围和默认语言。描述会用于搜索排序和 Agent 选择知识库，写清楚“这个库解决什么问题”。

第 2 步：配置权限

权限至少分三层：

• 知识库级：谁能进入这个库；
• 文档级：谁能查看、编辑、下载；
• 引用级：Agent 在对话中能引用哪些文档。

最小权限原则：

1. 默认不给“全公司可见”；
2. 敏感资料只给必要角色；
3. 外部客户资料与内部资料分开；
4. 离职和调岗时回收权限；
5. 定期检查“长期未访问但仍开放”的文档。

第 3 步：导入文档

支持的上传方式以当前版本为准，常见包括：

• 单个文件上传；
• 批量上传；
• 从企业网盘或文档系统导入；
• 通过连接器同步业务系统资料。

导入前先做一次清理：

• 删除重复文件和过期版本；
• 统一标题和命名规则；
• 去掉无关附件和大图；
• 确认没有密钥、客户隐私和未脱敏数据；
• 给文档打标签，便于筛选。

第 4 步：解析与索引

文档上传后需要解析和索引，才能被搜索和引用。影响效果的因素：

因素	建议
文件格式	优先 PDF、DOCX、Markdown、HTML 等可解析文本
扫描件	先做 OCR；纯图片 PDF 的检索效果通常较差
分块大小	制度/产品文档按章节分块；技术文档按标题层级分块
元数据	标题、部门、版本、生效日期、标签要完整
更新频率	高频文档设置定期同步；过期文档及时归档

刚上传的文档可能不会立即出现在搜索结果中，等待索引完成后重试。

第 5 步：验证搜索

用真实问题测试，而不是只搜文件名：

• “出差住宿标准是多少？”
• “退款审批需要谁签字？”
• “这个接口的限流是多少？”
• “上季度差评的主要原因是什么？”

检查：

• 能搜到正确文档，而不是只匹配关键词。
• 搜索结果有来源、标题和片段。
• 权限外成员搜不到敏感文档。
• Agent 引用时能给出处，而不是编造答案。
• 过期文档不会排在最新文档前面。

第 6 步：维护

知识库不是一次性项目。建议建立固定节奏：

频率	动作
每周	处理上传失败、解析失败和重复文档
每月	检查高频搜索无结果的问题，补充内容
每季度	清理过期文档，复核权限
每次制度/产品变更	更新对应文档，标注版本和生效日期

指定每个知识库的负责人。没有负责人的知识库很快会变成过期资料的集合。

安全与合规

• 不要在知识库中存放明文密钥、数据库连接串和未脱敏客户数据。
• 对外部导入的资料确认版权和使用范围。
• 知识库的访问日志和导出行为应纳入企业审计。
• 成员离职或调岗时，及时回收知识库权限。
• 涉及个人信息、财务和法务资料时，遵循企业数据分类分级要求。

常见问题

问题	处理
上传成功但搜不到	等待索引；检查文件是否可解析；确认搜索范围包含该库
搜索结果不相关	优化标题、标签和分块；补充描述；清理重复文档
Agent 引用了过期文档	归档旧版本；在文档标题和元数据中标注生效日期
成员看不到知识库	检查知识库级和文档级权限；确认成员角色
导入大文件失败	拆分文件；压缩图片；检查上传大小限制

下一步

• 连接业务系统
• 成员第一个任务
• 安全操作确认