> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getbifrost.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GraySwan Cygnal

> Integrate GraySwan Cygnal Monitor with Bifrost for AI safety monitoring with natural language rule definitions, violation scoring, and advanced threat detection.

Bifrost integrates with **GraySwan Cygnal Monitor** to provide AI safety monitoring with natural language rule definitions and advanced threat detection capabilities. This page covers the configuration and capabilities of the GraySwan Cygnal guardrail provider.

<img src="https://mintcdn.com/bifrost/7-e0pMZ8jGgd-Kc4/media/guardrails/gray-swan-config-on-bifrost.png?fit=max&auto=format&n=7-e0pMZ8jGgd-Kc4&q=85&s=53a53b6b2441f3fca43587d781ee77e1" alt="GraySwan configuration form" width="1928" height="2082" data-path="media/guardrails/gray-swan-config-on-bifrost.png" />

## Capabilities

* **Violation Scoring**: Continuous 0-1 scale violation detection with configurable thresholds
* **Custom Natural Language Rules**: Define safety rules in plain English without code
* **Policy Management**: Use pre-built policies from GraySwan platform or create custom ones
* **Indirect Prompt Injection (IPI) Detection**: Identify hidden instructions in user inputs
* **Mutation Detection**: Detect attempts to manipulate or alter content
* **Reasoning Modes**: Choose from fast ("off"), balanced ("hybrid"), or thorough ("thinking") analysis

## Configuration Fields

| Field                 | Type   | Required | Default | Description                                                                         |
| --------------------- | ------ | -------- | ------- | ----------------------------------------------------------------------------------- |
| `api_key`             | string | Yes      | -       | GraySwan API key                                                                    |
| `violation_threshold` | number | No       | 0.5     | Score threshold (0-1) for triggering intervention. Lower values are more strict.    |
| `reasoning_mode`      | enum   | No       | "off"   | Analysis depth: `off` (fastest), `hybrid` (balanced), or `thinking` (most thorough) |
| `policy_id`           | string | No       | -       | Single custom policy ID from GraySwan platform                                      |
| `policy_ids`          | array  | No       | -       | Multiple policy IDs for aggregated rule evaluation                                  |
| `rules`               | object | No       | -       | Custom natural language rules as key-value pairs                                    |

## Custom Rules Example

<img src="https://mintcdn.com/bifrost/7-e0pMZ8jGgd-Kc4/media/guardrails/gray-swan-custom-rule.png?fit=max&auto=format&n=7-e0pMZ8jGgd-Kc4&q=85&s=6eb9596264134cc8a0abddecd340f7e2" alt="GraySwan custom rules" width="1644" height="714" data-path="media/guardrails/gray-swan-custom-rule.png" />

Rules are defined as key-value pairs where the key is the rule name and the value is a natural language description:

```json theme={null}
{
  "rules": {
    "no_profanity": "Do not allow profanity or vulgar language",
    "no_pii": "Do not allow personally identifiable information",
    "professional_tone": "Ensure all responses maintain a professional tone"
  }
}
```

## Detection Features

* Real-time violation scoring
* Multi-rule evaluation
* IPI attack detection
* Content mutation monitoring
* Detailed violation descriptions with rule attribution

## Provider Capabilities Comparison

| Capability                    | AWS Bedrock | Azure Content Safety | GraySwan | Patronus AI |
| ----------------------------- | ----------- | -------------------- | -------- | ----------- |
| PII Detection                 | Yes         | No                   | No       | Yes         |
| Content Filtering             | Yes         | Yes                  | Yes      | Yes         |
| Prompt Injection              | Yes         | Yes                  | Yes      | Yes         |
| Hallucination Detection       | No          | No                   | No       | Yes         |
| Toxicity Screening            | Yes         | Yes                  | Yes      | Yes         |
| Custom Policies               | Yes         | Yes                  | Yes      | Yes         |
| Custom Natural Language Rules | No          | No                   | Yes      | No          |
| Image Support                 | Yes         | No                   | No       | No          |
| IPI Detection                 | No          | Yes                  | Yes      | No          |
| Mutation Detection            | No          | No                   | Yes      | No          |

For information on configuring guardrail rules and profiles, see [Guardrails](/enterprise/guardrails).
