火山引擎大模型应用默认启用基于session_id和30秒窗口的文本哈希去重，需确保session_id稳定；支持自定义语义去重，可通过防火墙接口或AgentKit开启上下文指纹缓存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在火山引擎大模型应用中，若用户连续发送相同或高度相似的提问（如误触、刷新重发、前端未防抖），后端若不加甄别直接推入推理链路，会导致同一段输入被多次处理，徒增 token 消耗与响应延迟，尤其在高并发质检、客服会话等场景下极易引发费用异常激增。
识别重复消息的触发条件
系统默认仅对同一会话 ID（session_id）下、时间窗口 ≤ 30 秒内的相邻请求做去重判定；跨 session 或间隔超 31 秒的相同文本不会被拦截。该机制由火山方舟平台底层自动启用，无需额外配置，但【必须确保前端传入的 session_id 字段稳定且符合业务会话粒度】——若每次请求都生成新 session_id，去重逻辑将完全失效。
去重比对基于原始输入文本的标准化哈希值：自动去除首尾空格、合并连续空白符、忽略换行符差异，但保留标点与大小写。例如“你好！”和“你好！\n”视为重复，“Hello”与“hello”则不重复。
启用自定义语义去重（需开通高级防护）
方法一：调用大模型应用防火墙的语义相似检测接口
在请求模型前，先将待发送文本 POST 至 /v1/firewall/similarity/check，携带参数 text（必填）、session_id（必填）、threshold（选填，默认0.92）。返回 {"is_duplicate": true, "duplicate_id": "req_abc123"} 即表示命中近似重复，可直接跳过模型调用。
方法二：在 AgentKit 工作站中开启「上下文指纹缓存」开关
进入 AgentKit 控制台 → 目标智能体 → 配置 → 高级设置 → 勾选「启用输入语义指纹去重」→ 设置相似度阈值（0.85～0.98 可调）→ 保存。该功能依赖 OpenViking 的 L0 层轻量指纹索引，对 500 字以内文本比对延迟
注意：此功能仅对通过 AgentKit SDK 发起的请求生效，直连 /v1/chat/completions 接口不触发。
强制跳过重复检测的实操路径
第一步：在请求头中添加 X-Volc-Skip-Dedup: true
第二步：确保该请求 body 中包含字段 "skip_dedup": true
第三步：调用标准推理接口 POST /v1/chat/completions
这三步必须同时满足，否则仍会进入默认去重流程。该方式适用于调试阶段需反复验证同一 prompt 效果，或业务明确要求“宁可多花 token，也不能漏判”的强实时场景。
