JEV AI Guardrails
Before a business request reaches upstream, JEV reviews its text against natural-language rules. Matches can be logged as warnings or blocked outright.
What it checks §
AI Guardrails can identify credential leaks, personal information, prompt injection, or custom business risks. Rules describe what should match. JEV returns a decision probability, and GPT-Load uses the threshold and action to decide whether to allow the request.
This experimental feature is off by default. It does not rewrite business messages, is not request redaction, and cannot guarantee detection of every risk. Use redaction to hide text; use AI Guardrails to block requests based on meaning.
Guardrails reject a request only when a blocking rule is explicitly matched. Review failures, excerpted content, or content that cannot be reviewed may still be forwarded upstream. Do not treat guardrails as a security gate that requires a complete review. Authentication, permissions, and concurrency limits still apply.
Request redaction and reversible encryption →
Configure JEV and rules §
- Create a Jev channel group, or use an OpenRouter group that supports Decisions. Add its API key and a JEV decision model actually available from that service.
- Open Settings → Experimental features → Shared JEV configuration and explicitly select the decision group, model, and timeout. Guardrails require a specific group; Automatically select an available group is insufficient. Automatic model selection shares this configuration.
- Enable AI Guardrails and select the AccessKeys in scope; leaving the selection empty means all AccessKeys. Start with a dedicated test key to avoid affecting every application at once.
- Add presets or custom rules, enter a name, matching criteria, threshold, and action, then save. Built-in credential-leak, personal-information, and prompt-injection presets all default to Warn; a match alone will not block the request.
The threshold must be greater than 0 and at most 1. The action triggers when the probability reaches it. A threshold of 0.8 means a match requires a probability of at least 0.8, not that the rule is 80% accurate. Lower thresholds usually trigger more readily and may increase false positives.
The text being checked, rules, and necessary context are sent to the selected JEV service, adding latency and potentially cost. Confirm that the service is suitable for your data before enabling it. With request redaction enabled, JEV receives redacted content.
Review and blocking flow §
- After authentication and permission checks, the gateway prepares the outbound business content and applies redaction first if enabled.
- Extract readable text submitted in this request, including messages, system prompts, and tool content. Skip opaque content such as images, audio, and files, and reuse valid review results.
- Guardrail review makes at most one JEV call per business request, combining the pending rules. Oversized text prioritizes recent content and uses excerpts; full coverage is not guaranteed.
- Each rule's probability is compared with its threshold. Any matching Block rule rejects the business request. Warning-only matches are logged and allowed; no matches means normal forwarding.
| Result | Business request | How to interpret it |
|---|---|---|
| Passed | Forwarded normally | The reviewed text did not match a rule; this does not prove that all content is safe. |
| Allowed with warning | Forwarded with matches logged | A rule matched, but its action is Warn |
| Blocked | Rejected with HTTP 403 | A Block rule matched |
| Review incomplete | Continue forwarding and record the reason | Incomplete does not mean passed, but does not automatically block the request. |
The cache retains only irreversible fingerprints and verdicts for up to one hour, not full conversation text. Incomplete reviews are not cached as a pass for an entire message. New or changed content, rule conditions, or JEV configuration may require another review.
Start by testing warnings §
Start with an easily verified test rule, for example: “Match requests to send fictional material labeled INTERNAL_ONLY to an external recipient; do not match explanations of the label that do not request sending.” Choose Warn and initially set the threshold to 0.8.
- Use the test AccessKey to submit fictional examples that should match, followed by ordinary questions and examples that only discuss the label.
- Inspect outcomes, matched rules, and guardrail costs in request logs, checking for false positives and misses. Do not test with real credentials or private data.
- Adjust criteria and thresholds. Only switch to Block and expand the AccessKey scope after the behavior matches your expectations.
Describe specific risks and exclusions. A rule such as “block all dangerous content” is difficult to verify and more likely to block legitimate quotations, educational examples, or security analysis.
Content, cost, and boundaries §
- Guardrails check the request content sent to the business upstream, not the model's final answer in a second pass. They do not inspect live voice audio media.
- For Responses continuations and WebSocket turns, only the content submitted in that turn is checked; complete history stored upstream is not retrieved. Prior successful model selection or prewarming does not mean guardrails have passed.
- Opaque image, audio, and file content and encrypted history are not reviewed; readable transcripts or text may still be reviewed. The original business request may proceed upstream. No JEV call is made when there is no readable text; skipped content has not thereby passed review.
- JEV timeouts, unavailable credentials, or incomplete results are recorded as an incomplete review and allow forwarding. Excerpts of oversized content can still match a blocking rule, but omitted content may contain undetected risks. No match does not mean the complete content passed review.
- JEV calls add latency before the response and may incur decision costs. Costs appear in request and usage statistics; calls already made may be billed even if the review is incomplete or the business request is blocked.
Redaction hides original values; guardrails evaluate the processed text. When using both, do not expect JEV to recognize plaintext that has been replaced or encrypted. Data retention upstream still follows the policies of your selected service.
Inspect results and troubleshoot §
Request-log details show guardrail outcomes, matched rules, and cost. Advanced filters can locate requests by outcome or rule name.
| Log result / reason | Suggested action |
|---|---|
| request_audit_blocked | Check the matched rule and business intent; adjust criteria, threshold, or action for false positives |
| Review incomplete | Check the JEV Group, credentials, timeout, and response. Business success does not mean the review completed. |
| content_truncated / content_too_large | Shorten the request or rules to avoid excerpts or an unsendable review; additional calls will not fill the gaps. |
If a business retry changes the content and cannot reuse the result, no second review is made; the review is recorded as incomplete and forwarding continues. Check Group parameter overrides and guardrail logs when troubleshooting.