- 文档首页
大模型应用防火墙
用户指南
运营
通过接入调优提取有效送检内容
通过接入调优提取有效送检内容
接入调优用于从混合输入、输出日志中识别有效内容,并生成预处理提取规则。适用于请求体或响应体包含结构化字段、业务包装字段、上下文信息等冗余内容的场景。
前提条件
- 如果使用在线日志,目标资产需要在所选时间范围内产生可用于分析的日志。
- 如果使用离线样本,请提前准备 Excel 或 CSV 格式的样本文件。
接入调优说明
按样本来源选择调优方式:
- 已准备批量样本集,或需要覆盖特定数据结构:选择离线样本。
步骤一 创建接入调优任务
- 在调优资产下拉列表中选择需要调优的资产。一个调优任务仅支持选择一个资产。
-
适用于目标资产已经产生真实业务流量的场景。选择在线日志,设置日志范围。由系统识别输入、输出中的有效内容并生成提取规则。
说明
- 选择同时包含攻击日志和正常日志的时间范围。样本类型越完整,调优结果越能反映实际业务情况。
- 系统会从您选定的时间范围内,提取最多 2000 条最新的攻击日志和 8000 条最新的正常会话日志用于分析。
适用于已经准备批量样本集的场景。
上传 Excel 或 CSV 格式的样本文件。您也可以单击示例文件,参考示例准备上传内容。
说明
文件须包含 role 和 content 两列,每行一条待分析文本;role 支持 user(输入送检)或 assistant(输出送检)。每个待识别模板建议提供不少于 20 条样本,最大支持 5 万条样本数据。
- 确认配置后,单击底部开始调优。系统将创建调优任务并开始生成模板。
注意
接入调优的目标是让检测引擎看到“真正需要检测的内容”。如果日志结构复杂,建议优先选择覆盖典型业务场景的样本,避免只基于单一格式生成模板。
步骤二 数据提取与模板生成
开始调优后,系统将根据任务配置处理样本:
- 从所选时间范围的在线日志中提取任务日志,或读取已上传的离线样本。
- 分析输入和输出的数据结构,识别业务内容与固定包装字段。
- 根据重复出现的数据结构生成日志模板,并标注模板提取的用户输入和模型输出。
该阶段由系统自动完成。模板生成后,任务进入待确认状态,您可以开始筛选模板。
步骤三 筛选模板并处理冲突
在任务详情页中,结合业务请求和响应结构检查系统生成的模板:
- 模板标注的“用户真正输入”和“用户真正输出”是否为实际需要检测的用户输入或模型输出。
- 是否误将请求 ID、时间戳、状态码、路由参数等无关字段纳入检测内容。
- 同一资产的不同请求或响应格式是否都能被模板覆盖。
完成检查后,保留符合实际流量格式的模板,删除不需要的模板。如果同一样本同时命中多个模板,请调整模板优先级或删除重复模板。确认模板不存在冲突后,进入下一步。
步骤四 生成模板副本
完成模板筛选并处理冲突后,系统会创建当前配置的副本,将已选模板应用到副本环境,并使用已有日志执行回归测试。该过程不会直接修改生产环境中的配置。
回归测试会对比应用模板前后的内容提取和检测结果,并生成效果预览:
- 回归测试未通过:检查样本和模板筛选结果,或重新发起调优。重新调优后,需要再次筛选模板并处理冲突。
步骤五 审核与发布调优策略
回归测试通过后,请按以下步骤审核并发布调优策略:
- 在接入调优效果预览中查看模板覆盖率、日志内容裁剪率、误报已改善和漏报已改善等指标。
- 按已命中模板和未命中模板查看日志,抽查模板提取的内容是否符合预期。
- 确认效果符合预期后,单击发布策略。系统会将筛选后的模板应用到对应资产。
-
发布后,系统将按照新的提取逻辑处理该资产的输入和输出内容。
发布后持续观察
发布后,请继续观察攻击日志和正常日志:
- 如果误报减少且风险命中仍符合预期,说明提取规则符合当前业务场景。
- 如果仍存在明显漏检、误检或字段提取不完整,可以重新选择更具代表性的日志范围或样本再次发起接入调优。
常见问题
日志抽取失败是什么原因?
通常是因为所选时间范围内没有日志,或日志样本代表性不足。请先确认该时间段内同时包含一定数量的正常请求和风险请求;如果样本不足,请扩大时间范围后重新发起调优。
最近更新时间:2026.09.09 21:12:53