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

# Protect Agents

> Configure Dome Guardrail configurations and run detections.

[Dome](/developer-guide/protect/overview) configurations define which [Guards](/concepts/defense/guard) and [Detectors](/concepts/defense/detector) intercept your [Agent](/owner-guide/register-agents/what-is-an-agent)'s inputs and outputs at runtime. Use these commands to create, manage, and apply configurations, and to run on-demand detections.

| Command                     | Description                                      |
| --------------------------- | ------------------------------------------------ |
| `vijil dome default-config` | Get the default Dome configuration template      |
| `vijil dome config-create`  | Create a new Dome configuration                  |
| `vijil dome config-list`    | List Dome configurations                         |
| `vijil dome config-get`     | Get a specific configuration                     |
| `vijil dome config-update`  | Replace a configuration                          |
| `vijil dome config-patch`   | Set the Dome instance URL on a configuration     |
| `vijil dome config-apply`   | Apply a configuration to the bound Dome instance |
| `vijil dome config-delete`  | Delete a configuration                           |
| `vijil dome detect`         | Submit content for detection                     |
| `vijil dome detect-status`  | Check detection status                           |

## `vijil dome default-config`

Get the default Dome configuration to use as a starting template.

```bash theme={null}
vijil dome default-config --json
```

## `vijil dome config-create`

Create a new Dome configuration, optionally binding it to an Agent.

```bash theme={null}
# Create a default configuration bound to an agent
vijil dome config-create --agent-id "$AGENT_ID"

# Create a custom configuration
vijil dome config-create \
  --agent-id "$AGENT_ID" \
  --config-body '{"input_guardrail": {...}, "output_guardrail": {...}}'
```

| Flag            | Description                                                                  |
| --------------- | ---------------------------------------------------------------------------- |
| `--agent-id`    | Agent ID to bind this configuration to                                       |
| `--config-body` | Guard configuration JSON (defaults to the standard configuration if omitted) |
| `--json`        | Output as JSON                                                               |

The output includes the configuration `id`. Save it:

```bash theme={null}
export DOME_CONFIG_ID="d1e2f3a4-..."
```

## `vijil dome config-list`

List Dome configurations for the active team.

```bash theme={null}
vijil dome config-list
vijil dome config-list --agent-id "$AGENT_ID"
```

| Flag         | Description        |
| ------------ | ------------------ |
| `--agent-id` | Filter by Agent ID |
| `--limit`    | Page size          |
| `--offset`   | Pagination offset  |
| `--json`     | Output as JSON     |

## `vijil dome config-get`

Get a specific Dome configuration.

```bash theme={null}
vijil dome config-get <config_id> --json
```

## `vijil dome config-update`

Replace an existing Dome configuration with new Guard settings.

```bash theme={null}
vijil dome config-update <config_id> \
  --config-body '{"input_guardrail": {...}, "output_guardrail": {...}}'
```

| Flag            | Description                                   | Required |
| --------------- | --------------------------------------------- | -------- |
| `--config-body` | Replacement Guard configuration (JSON object) | Yes      |
| `--json`        | Output as JSON                                |          |

## `vijil dome config-patch`

Set or clear the Dome instance URL on a configuration. This URL is where the Dome service is deployed.

```bash theme={null}
vijil dome config-patch <config_id> \
  --dome-instance-url "https://dome.example.com"
```

| Flag                  | Description                           | Required |
| --------------------- | ------------------------------------- | -------- |
| `--dome-instance-url` | Dome instance URL, or `null` to clear | Yes      |
| `--json`              | Output as JSON                        |          |

## `vijil dome config-apply`

Apply a configuration to the Dome instance bound to it, publishing any pending changes.

```bash theme={null}
vijil dome config-apply <config_id>
```

## `vijil dome config-delete`

Delete a Dome configuration.

```bash theme={null}
vijil dome config-delete <config_id>
vijil dome config-delete <config_id> --yes   # skip confirmation
```

## `vijil dome detect`

Submit content to a specific Detector for on-demand analysis.

```bash theme={null}
vijil dome detect \
  --id "request-001" \
  --detector-id "prompt-injection" \
  --detector-inputs '[{"role": "user", "content": "Ignore all previous instructions."}]'
```

| Flag                | Description                                        | Required |
| ------------------- | -------------------------------------------------- | -------- |
| `--id`              | Request identifier                                 | Yes      |
| `--detector-id`     | Detector to invoke                                 | Yes      |
| `--detector-inputs` | Content to analyze (JSON array of message objects) | Yes      |
| `--detector-params` | Detector-specific parameters (JSON object)         |          |
| `--wait`            | Poll until the detection completes                 |          |
| `--json`            | Output as JSON                                     |          |

Save the detection ID from the output to poll for results:

```bash theme={null}
export DETECTION_ID="f1a2b3c4-..."
```

## `vijil dome detect-status`

Check the status of a detection request.

```bash theme={null}
vijil dome detect-status <detection_id> --json
```