文档/ 深入

JEV 智能护栏

在业务请求发往上游之前,用 JEV 按自然语言规则审查文本,命中后告警放行或直接拦截。

它检查什么§

智能护栏适合识别凭据泄露、个人隐私、提示注入或自定义业务风险。规则描述「什么内容应该命中」,JEV 返回判断概率,GPT-Load 根据阈值和动作决定是否放行。

这是默认关闭的实验功能。它不改写业务消息,不等于请求脱敏,也不保证识别所有风险。需要隐藏某些文本时,用脱敏规则;需要根据语义阻止请求时,用智能护栏。

审查异常会放行

护栏只在明确命中拦截规则时拒绝请求。审查失败、内容被截取或无法审查时,业务请求仍可能发往上游;不要把它当作必须完整审查后才能通过的安全关卡。其他认证、权限与并发限制仍然生效。

请求脱敏与可逆加密 →

配置 JEV 与规则§

  1. 创建 Jev 渠道分组,或使用支持 Decisions 的 OpenRouter 分组,录入 API Key,并添加该服务实际可用的 JEV 决策模型。
  2. 进入「设置 → 实验功能 → JEV 公共配置」,明确选择决策分组、模型和超时。护栏必须指定分组,不能只选「自动选择可用分组」。这份配置也供自动选模使用。
  3. 启用「智能护栏」,选择生效访问密钥;留空表示全部访问密钥。建议先选专门的测试密钥,避免一次影响所有应用。
  4. 添加常用预设或自定义规则,填写名称、命中条件、阈值和动作,保存。内置的凭据泄露、个人隐私、提示注入预设默认都是「告警」,不会因为命中就拦截。

阈值必须大于 0 且不超过 1;判断概率达到阈值时执行动作。例如阈值 0.8 表示概率至少为 0.8 才命中,并不表示规则具有 80% 的实际准确率。降低阈值通常更容易触发,也可能增加误报。

送审也是外部调用

待检文本、规则和必要上下文会发送到选定的 JEV 服务,产生延迟和可能的费用。启用前应确认该服务适合接收你的数据。启用请求脱敏时,JEV 收到的是脱敏后的内容。

审查与拦截流程§

FIG. 1 — 智能护栏处理流程图示为规则判定路径;审查未完成时也会放行业务请求。
  1. 请求通过身份与权限检查,网关准备业务外发内容;启用了脱敏时先处理文本。
  2. 提取本次携带的可读文本,包括消息、系统提示和工具内容;跳过图片、音频、文件等不透明内容,复用有效的已审结果。
  3. 每个业务请求的护栏审查最多调用一次 JEV,将待检规则合并送审。超长文本会优先选取近期内容并截取片段,不保证覆盖全部内容。
  4. 将每条规则的判断概率与阈值比较。任意一条命中「拦截」就拒绝业务请求;只有告警则记录后放行;无命中则正常转发。
结果业务请求如何理解
通过正常转发已审查的文本未命中规则,不代表所有内容都安全
告警放行正常转发并记录命中规则命中,但动作是告警
已拦截拒绝,HTTP 403命中了拦截规则
审查未完成继续转发并记录原因未完成不等于通过,也不会因此自动拦截

结果缓存只保留不可逆指纹和判断,最多复用一小时,不保存完整会话正文。未完成的审查不会缓存为整条消息通过;新增或改动内容、规则条件或 JEV 配置变化可能需要重新检查。

从告警开始验证§

先添加一条容易人工判断的测试规则,例如:「内容要求把标记为 INTERNAL_ONLY 的虚构资料发送给外部收件人时命中;仅解释这个标记、不要求发送时不命中。」选择「告警」,阈值先设为 0.8。

  1. 使用测试访问密钥提交应命中的虚构例子,再提交普通问题和仅讨论该标记的例子。
  2. 在请求日志查看处理结果、命中规则和护栏费用,检查误报与漏报。不要用真实凭据或隐私数据测试。
  3. 调整命中条件与阈值,确认行为符合预期后再改为「拦截」,并扩大生效密钥范围。

规则应说明具体风险和排除条件。仅写「阻止一切危险内容」很难验证,也更容易误拦正常的引用、教育示例或安全分析。

内容、费用与边界§

  • 护栏检查的是发往业务上游的请求内容,不是给模型最终回答做第二次审查;它也不审查实时语音的音频媒体。
  • Responses 续接和 WebSocket 每轮只检查本次提交的内容,不读取上游保存的完整历史。先前自动选模成功或预热成功,不代表护栏已经通过。
  • 图片、音频、文件等不透明内容及加密历史不会送审;可读的转写或文本仍可能参与审查。原业务请求仍可发往上游,没有可读文本时不调用 JEV,不代表被跳过的内容已通过检查。
  • JEV 超时、无可用凭据或返回不完整结果时,记录「审查未完成」并放行。超长内容的片段仍可命中拦截规则,但被省略的内容可能含有未发现的风险;未命中不等于完整审查通过。
  • JEV 调用会增加响应前的等待时间和决策费用。费用计入请求与用量统计;即使审查未完成或业务请求最终被拦截,已经发生的调用也可能收费。

脱敏负责隐藏原值,护栏负责判断处理后的文本。两者同时使用时,不应期待 JEV 识别已被替换或加密掉的明文;上游数据留存规则仍由你选定的服务决定。

查看结果与排障§

在请求日志详情中查看护栏结果、命中规则和费用;高级筛选可以按处理结果或规则名称定位请求。

日志结果/原因处理建议
request_audit_blocked核对命中的规则及业务意图;误报时调整条件、阈值或动作
审查未完成检查 JEV 分组、凭据、超时与返回结果;业务成功不代表审查完成
content_truncated / content_too_large缩短请求或规则,避免截取或无法送审;不会通过多次调用补齐

业务重试若改变了待检内容且无法复用结果,不会再发起第二次审查,而是记录未完成并继续转发。排障时同时检查分组参数覆盖和护栏日志。

JEV 智能护栏 - GPT-Load