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.
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