Quickstart
Three commands with the Roark CLI. Find your agent and the metric that defines success, then hand Roark the objective:The objective metric should produce a pass/fail verdict per call: either a boolean metric, or a threshold on a scale metric (for example “Instruction Follow >= 4”). Create one in the dashboard’s metric studio or with
roark metric definitions create.How it works
- Stage. Roark clones your production agent inside your provider account (Vapi or Retell) as a clearly-marked shadow, gives it its own phone number, and registers it for simulations. Your production agent is never modified by the loop.
- Author. It writes caller scenarios for the objective: the failure case it is hunting, an easy case, an edge case. Each becomes a real simulation flow with success criteria, graded by your metrics.
- Measure. A baseline batch of simulated calls establishes where things stand. Every later change is measured against it.
- Change and re-test. Roark edits the staging configuration through an audited funnel, then proves or disproves each change with more calls. It reads the graders’ evidence, not its own opinion of the transcripts.
- Verify and hand over. When the objective passes its target with repeated trials, the job waits for you: review the diffs and the numbers, then promote or dismiss.
What Roark can change
The whole provider configuration document, not just the prompt: the system prompt, the underlying model and temperature, the voice, the transcriber, timeouts and endpointing, the first message, tool definitions. Credentials, URLs, webhooks, and privacy settings are protected and refused by the platform.The safety model
Staging-only writes
The loop only ever writes to the staging copy. The one write path to production is the promote, and only you trigger it.
Rollbackable promotes
A snapshot of the production configuration is taken immediately before a promote, so every promote can be fully rolled back.
Guaranteed cleanup
Whatever the outcome, everything the job set up is removed: the shadow agent, its phone number, the authored test flows and run plan.
Hard budgets
Decision turns and simulated calls are capped (10 turns and 200 calls by default, tunable at create). Roark cannot exceed them.
Job statuses
Go deeper
Running a job
The full lifecycle over the CLI and API: creating, watching, steering, answering, promoting.
CLI
Install and authenticate the Roark CLI used throughout this section.