Creating Raw Guardrails (in JSON)

• You want the same Guardrail checks but want to take different basic actions on them
• Your Guardrail checks definitions are dependent on an upstream task and are updated in code
• You want greater control over how you want to handle Guardrails

​

Example of a Raw Guardrail

"before_request_hooks": [{
    "type": "guardrail",
    "id": "my_solid_guardrail",
    "checks": [{
      "id": "default.regexMatch",
      "parameters": {
        "rule": "test"
      }
    }]
}]

• type: Specifies the type of hook, which is guardrail.
• name: Gives a name to the guardrail for identification.
• checks: Lists the checks that make up the guardrail. Each check includes an id and parameters for the specific conditions to validate.

​

Configuring Guardrail Actions

"before_request_hooks": [{
    "type": "guardrail",
    "id": "my_solid_guardrail",
    "checks": [{
      "id": "default.regexMatch",
      "parameters": {
        "rule": "test"
      }
    }],
    "deny": false,
    "async": false,
    "sequential": false,
    "on_success": {
        "feedback": {"value": 1,"weight": 1}
    },
    "on_fail": {
        "feedback": {"value": -1,"weight": 1}
     }
}]

• deny: Is set to TRUE or FALSE
• async: Is set to TRUE or FALSE
• sequential: Is set to TRUE or FALSE - when TRUE, guardrail checks run one after another instead of in parallel
• on_success: Used to pass custom feedback
• on_failure: Used to pass custom feedback

​

Forwarding Client Headers

"before_request_hooks": [{
    "type": "guardrail",
    "id": "my_solid_guardrail",
    "checks": [{
      "id": "default.webhook",
      "parameters": {
        "webhookURL": "https://my-guardrail.example.com/check",
        "forwardHeaders": ["x-session-id", "traceparent"]
      }
    }],
    "deny": true,
    "async": false
}]

• forwardHeaders: Optional string[] of client headers to forward to this check’s provider. If omitted, no client headers are forwarded. See Forwarding Headers for restricted headers and configuration details.