Skip to content

Managing guardrail policies↑

This page covers how to view, create, activate, and delete guardrail policies in the AQtive Guard (AQG) console. For details on policy structure and JSON configuration, refer to AI guardrail policies.

Accessing guardrail policies↑

To view the list of available guardrail policies:

  1. From the AQG main menu, expand the AI section.
  2. Select Rules, then AI guardrail policies.

The AI guardrail policies table provides a high-level overview of each policy:

  • Policy ID – The unique identifier used by the platform (for example, block_pii). IDs contain only alphanumeric characters, underscores, and hyphens.
  • Policy name – The human-readable name given to the policy.
  • Guardrails – A summary of configured guardrails, grouped by role: * User: Scans messages from humans before they reach the LLM. * Assistant: Scans AI responses before they are delivered to the user.
  • Status – Indicates whether the policy is currently Active or Inactive.

Note

The built-in AQtive Guard default policy is identified by the AQtive Guard icon. Built-in policies provide baseline protection and cannot be edited or deleted.

Create a policy↑

  1. Select Add policy.
  2. AQtive Guard loads a standard template in the JSON editor.
  3. Define a unique ID, descriptive name, and configure your guardrails, severity mapping, and triggers. Refer to AI guardrail policies for structure details.
  4. Select Add policy to save.

Activate or deactivate a policy↑

Only one policy can be active at a time. Activating a new policy automatically replaces the previous one.

  1. Select Details for your chosen policy.
  2. Toggle the Status switch.
  3. Review the confirmation dialog. If you are replacing an active policy, the dialog confirms the switch.

Safe policy switching↑

If the policy you are deactivating is in use by a running AI Gateway:

  1. Activate the replacement policy in AQG first.

  2. Restart the AI Gateway to load the new policy. There are two ways to do this:

    • Using the configuration script:
      Bash
      ./configure-gateway.sh --restart guardrails
    • Using Docker Compose:
      Bash
      docker compose restart guardrails

  3. Verify the gateway is healthy and enforcing the new policy.

  4. Return to AQG and deactivate the old policy.

This ensures continuous guardrail coverage with no gap in protection.

Caution

The gateway loads its policy at startup. Changing the active policy in AQG does not automatically update running gateways. Follow the safe policy switching procedure to avoid coverage gaps.

Delete a policy↑

To delete an AI policy:

  1. Select Details for a custom policy.
  2. Select Delete policy.
  3. Confirm in the dialog.

Note

You cannot delete the built-in AQtive Guard default policy or any policy that is currently active. Deactivate the policy first to enable deletion.