Configuration

.agentprey.toml

Full configuration template and field reference.

Default Template

toml
[target]# Optional target type: http | openclaw# type = "http"# Required for config-driven scansendpoint = "http://127.0.0.1:8787/chat"method = "POST"# Optional custom JSON request template with a {{payload}} marker# request_template = "{"messages":[{"role":"user","content":{{payload}}}]}"# Optional JSON pointer path for response extraction# response_path = "/choices/0/message/content"# Optional headers to send with every requestheaders = { }[scan]vectors_dir = "vectors"category = "prompt-injection"timeout_seconds = 30retries = 2retry_backoff_ms = 250max_concurrent = 2rate_limit_rps = 10redact_responses = true[output]# Optional default output artifact path# json_out = "./scan.json"# html_out = "./scan.html"[auth]# Optional entitlement API base URL override# api_url = "https://PLACEHOLDER.convex.site"

Precedence

When both are provided, CLI flags override values loaded from the TOML config file.

[target]

FieldTypeDefaultNotes
endpointstringnoneHTTP endpoint for config-driven scans. Required when --target is not passed.
methodstringnoneOptional HTTP method used for target requests.
request_templatestringnoneOptional JSON string template with a {{payload}} marker for payload injection.
response_pathstringnoneOptional JSON pointer path used to read model output text.
headerstable<string,string>{}Headers sent with every request, merged as KEY: VALUE pairs.

[scan]

FieldTypeDefaultNotes
vectors_dirpathvectorsDirectory containing vector YAML files.
categorystringprompt-injectionCategory filter for scans.
timeout_secondsu6430Request timeout in seconds.
retriesu322Retry attempts for transient request failures.
retry_backoff_msu64250Base retry backoff in milliseconds.
max_concurrentusize2Maximum concurrent vector execution (minimum effective value is 1).
rate_limit_rpsu3210Global request rate limit in requests per second (minimum effective value is 1).
redact_responsesbooltrueEnable response redaction in scan output and artifacts.

[output]

FieldTypeDefaultNotes
json_outpathnoneDefault JSON artifact path. Optional.
html_outpathnoneDefault HTML artifact path. Optional.

[auth]

FieldTypeDefaultNotes
api_urlstringnoneOptional entitlement API base URL override.

AgentPrey docs are intentionally calmer than the marketing site. Product flair stays on the homepage.