Use this guide to diagnose common issues during guardrail setup, deployment, and runtime operations.
Quick Triage Flow
Creation and Setup Issues
”Add Guardrail” button not visible
Likely cause: Missing required permission. Fix:- Verify your role has guardrail management permissions.
- Refresh session and retry.
Provider list is empty or missing expected provider
Likely cause: Provider access not configured or unavailable. Fix:- Confirm provider credentials/licensing.
- Validate provider availability in your environment.
- Retry after configuration update.
Probe Selection Issues
Cannot find expected probe
Likely cause: Active filters/search narrowing results. Fix:- Clear search and status filters.
- Switch to broader tags (for example, All).
- Verify provider selection in the workflow.
Deployment Issues
Deployment remains pending
Likely cause: Incomplete target selection or backend processing delay. Fix:- Confirm project and endpoint are valid.
- Re-open deployment details and check status transitions.
- Retry deployment if no progress occurs.
Guardrail not applied to endpoint
Likely cause: Wrong deployment type or mapping mismatch. Fix:- Confirm you selected Add to Existing Deployment if needed.
- Check deployment mapping in guardrail detail and project tabs.
- Redeploy with corrected target.
Runtime Quality Issues
Too many false positives
Fix:- Reduce severity slightly.
- Disable or refine over-sensitive rules.
- Validate changes in a limited rollout.
Unsafe content still passing
Fix:- Increase severity for key probes.
- Add missing probes for uncovered categories.
- Ensure both input and output guard types are enabled.
Escalation Checklist
Before escalating, collect:- Guardrail profile name and ID.
- Selected provider and probes.
- Deployment target and current status.
- Example prompts/responses showing the issue.
- Timestamp of the most recent failure.