知识库管理说明
功能概述
知识库管理用于统一维护平台可复用的业务知识。知识库发布后，可以在大模型智能体、话术流程等功能中选择使用，让 AI 在通话或测试过程中基于已维护的问答内容进行检索和回答。
知识库由两层内容组成：
- 知识库：用于归类一组知识，包含知识库名称、知识类型、发布状态、版本和待更新数量。
- 知识存储：知识库中的具体内容，每条知识包含问题、答案和可选的热点问题关联。
当前建议优先使用「问答知识」。平台中可以看到「话术知识」类型，但这块暂时不作为推荐使用方式；如无明确配置要求，新建知识库时请选择「问答知识」。 
页面结构
进入「知识库管理」页面后，页面左侧是知识库分类，右侧是当前分类下的知识库列表和操作区。
左侧分类包括：
- 问答知识：当前推荐使用的知识类型，适合 FAQ、产品说明、服务规则、常见异议处理等场景。
- 话术知识：平台保留的知识类型，暂时不建议作为新知识库的默认选择。
右侧列表支持卡片和表格两种查看方式。列表中展示知识库名称、知识类型、发布状态、版本、待更新数量和创建时间。
新增知识库
- 进入「知识库管理」页面。
- 在左侧选择知识库分类，或直接点击「新增知识库」。
- 填写知识库名称。
- 选择知识类型。
- 点击「确定」保存。
知识类型在新建时选择。当前建议选择「问答知识」，用于维护一问一答形式的标准知识。创建后如果发现类型选择错误，建议重新创建知识库并迁移知识内容。
维护知识存储
知识库存储是 AI 实际检索和回答的内容。
- 在知识库列表中点击知识库卡片，或点击表格操作列中的「知识存储」。
- 进入知识存储页面后，点击「新增」。
- 填写「问题」和「答案」。
- 点击「确定」保存。
维护建议：
- 问题尽量写成客户真实会问的表达。
- 答案保持准确、完整，避免写入过长的内部说明。
- 同一类问题可以拆成多条知识，便于后续维护和命中。
- 修改或删除知识前，先确认该知识库是否正在被智能体或流程使用。
批量导入知识
知识库存储支持通过 Excel 批量导入。 
- 进入某个知识库的「知识存储」页面。
- 点击「导入」。
- 点击「下载模板」获取知识库模板。
- 按模板填写问题和答案。
- 上传
.xls或.xlsx文件。 - 根据需要勾选「是否更新已经存在的知识数据」。
- 点击「确定」开始导入。
- 查看导入结果。
如果知识库处于发布中状态，只允许导入新增知识，不允许覆盖已有知识。正式批量导入前，建议先少量导入验证模板格式。
导出知识
在知识库存储页面点击「导出」，可以导出当前筛选条件下的知识内容。导出文件适合用于备份、线下校对或批量整理后重新导入。
发布和更新
知识库需要发布后才能在业务配置中稳定使用。发布状态包括： 
- 未发布：知识库已创建，但还不能作为正式知识库使用。
- 已发布：知识库已发布，可以在智能体或流程配置中选择。
- 待更新：知识内容发生变更，需要重新发布后新内容才会生效。
- 发布中：系统正在处理发布任务，此时不建议继续维护知识内容。
常见操作：
- 新增或修改知识后，回到知识库管理列表。
- 点击「发布」或「重新发布」。
- 等待发布状态更新为「已发布」。
- 到智能体或流程配置中选择该知识库。
如果不希望某个知识库继续被业务使用，可以点击「取消发布」。取消发布后，业务配置中通常无法继续选择该知识库。
热点问题关联
知识存储中的「热点问题」用于把通话中反复出现、但表达方式不同的问题关联到现有知识上。关联后，客户使用相似问法时更容易命中对应知识。
使用方式：
- 进入某条知识的操作区域。
- 点击「热点问题」。
- 查看已关联的热点问题。
- 点击「手动关联」追加新的问法。
- 如不再需要，可删除已关联的问法。
知识库发布中时，暂不允许维护热点问题。
在智能体和流程中使用
发布后的知识库可以在相关业务配置中选择。
- 大模型智能体：进入智能体配置的「知识库」页签，选择已发布的问答知识库。
- 话术流程：进入话术流程配置的「知识库」页签，选择已发布的知识库，用于补充固定流程外的问答内容。
知识库配置是可选项。没有配置知识库时，AI 会主要依赖提示词、流程节点和已有上下文回答。
权限和数据范围
知识库按租户隔离。普通租户用户只能查看和维护当前租户下有权限访问的知识库。
如果看不到知识库管理入口，或无法新增、发布、导入、删除知识，请联系管理员确认以下权限：
freeswitch:knowledge相关权限freeswitch:knowledgebasestorage相关权限
使用建议
- 优先使用问答知识：当前新建知识库建议选择问答知识，先覆盖高频问题和标准答案。
- 先小规模验证：正式接入业务前，先选取少量客户常见问题进行测试。
- 修改后及时发布：知识内容变更后，关注「待更新」状态并重新发布。
- 答案保持业务口径统一：不要在不同知识条目中写入互相冲突的说法。
- 定期清理无效知识：过期活动、下线产品和废弃政策要及时更新或删除。
常见问题
新建知识库时应该选择哪种类型？
当前建议选择「问答知识」。话术知识暂时不作为推荐的新建类型，除非管理员或项目负责人明确要求使用。
为什么智能体里选择不到某个知识库？
请先确认该知识库是否已经发布。未发布、发布中或权限不可见的知识库通常无法在业务配置中选择。
修改知识后为什么没有生效？
修改知识后，知识库会进入待更新状态。需要重新发布后，新内容才会在业务配置中生效。
发布中还能修改知识吗？
不建议。发布中状态下，页面会限制部分修改、删除和热点问题维护操作。请等待发布完成后再继续维护。
可以批量导入已有知识吗？
可以。请在知识存储页面下载模板，按模板填写问题和答案，再上传 .xls 或 .xlsx 文件导入。