Protect Agents

Dome configurations define which Guards and Detectors intercept your 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.

vijil dome default-config --json

`vijil dome config-create`

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

# 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:

export DOME_CONFIG_ID="d1e2f3a4-..."

`vijil dome config-list`

List Dome configurations for the active team.

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.

vijil dome config-get <config_id> --json

`vijil dome config-update`

Replace an existing Dome configuration with new Guard settings.

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.

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.

vijil dome config-apply <config_id>

`vijil dome config-delete`

Delete a Dome configuration.

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.

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:

export DETECTION_ID="f1a2b3c4-..."

`vijil dome detect-status`

Check the status of a detection request.

vijil dome detect-status <detection_id> --json

Get Started

Evaluate Agents

Protect Agents

Reference

Protect Agents

`vijil dome default-config`

`vijil dome config-create`

`vijil dome config-list`

`vijil dome config-get`

`vijil dome config-update`

`vijil dome config-patch`

`vijil dome config-apply`

`vijil dome config-delete`

`vijil dome detect`

`vijil dome detect-status`

​vijil dome default-config

​vijil dome config-create

​vijil dome config-list

​vijil dome config-get

​vijil dome config-update

​vijil dome config-patch

​vijil dome config-apply

​vijil dome config-delete

​vijil dome detect

​vijil dome detect-status

`vijil dome default-config`

`vijil dome config-create`

`vijil dome config-list`

`vijil dome config-get`

`vijil dome config-update`

`vijil dome config-patch`

`vijil dome config-apply`

`vijil dome config-delete`

`vijil dome detect`

`vijil dome detect-status`