尊敬的腾讯云用户,您好!
为了向您提供更完善的服务,腾讯云智能体开发平台将于北京时间 2025 年 12 月 24 日开始分批上线知识生效范围功能。该功能支持您按知识条目维度设置生效范围,在知识状态流转为“导入完成”后,将直接按照所设生效范围生效,无需额外执行发布操作。
1.功能现状
当前知识库在完成知识上传(包括文档、问答、数据库)并生成知识库 Schema 后,需手动点击“应用发布”,方可在发布域生效。
2.功能优化
为提升知识管理灵活性,现支持按知识条目维度设置“生效范围”(替代原“是否启用”功能),可选范围如下:
●不生效:该知识在开发域与发布域均不可被检索。
●仅调试生效:该知识仅在开发域可被检索。
●仅发布生效:该知识仅在发布域可被检索。
●调试/发布都生效:该知识在开发域与发布域均可被检索。
您可在上传或修改知识时调整“生效范围”,以直接控制知识的生效情况,无需依赖发布应用操作。当知识状态流转为“导入完成”后,将立即按所设生效范围生效。
3.历史数据兼容说明
●若某知识在开发域与发布域内容不一致(例如:知识发布后,在开发域修改但未重新发布),功能上线后将兼容保留两份独立知识,其生效范围分别为“仅调试生效”与“仅发布生效”。
建议在此期间尽量减少对已发布知识的修改,或在修改后及时发布,以保持内容一致。
○ 示例:在知识库上传文档 A 并发布后,将其到期时间从“永久有效”修改为“ 2025 年 12 月 30 日到期”。
功能上线后,文档列表将显示两个文档 A :一个生效范围为“仅发布生效”,到期时间为“永久有效”;另一个生效范围为“仅调试生效”,到期时间为“ 2025 年 12 月 30 日到期”。
○ 说明: 存在上述情况的用户,我们将通过发放为期 6 个月的知识库容量包的方式,解决因此额外占用的字符量。
您可以通过文档对比任务或冲突问答中,处理上述知识。
● 生成知识库 Schema 功能将调整为仅基于发布域内容生效,建议在此期间暂缓生成新的知识库 Schema 。
4.影响范围
●若默认知识库中存在“发布后修改、但未再次发布”的知识(包括文档、问答、数据库等),将按上述历史数据兼容说明进行处理,知识列表中将出现同名知识条目。
●通过 API 增删改查知识的用户,需调整 API 调用逻辑。在调用增删改知识 API 后,无需在查询知识流转状态后调用应用发布 API,调用录入 API 直接通过“EnableScope”字段传入对应取值即可设定知识生效范围(“EnableScope”为非必填字段,录入知识未填写此字段,目前兼容默认知识库为仅调试生效,知识库为调试/发布都生效)。字段请查阅相关 API 文档:
5.发布安排
本功能计划于 2025 年 12 月 24 日(星期三)至 2026 年 1 月 5 日(星期一) 期间分批灰度上线。
感谢您对腾讯云的理解与支持,若有任何问题可以 提交工单 反馈,我们将尽快为您核实处理!

2025-12-23