Skip to main content
Works out what to test for an existing agent, then creates the customer flows, metrics and checks to simulate it, and a run plan that runs them. It does not create or change the agent. It also reads the agent’s recent production calls and open issues. Run it again and it builds on what earlier generations made, adding only what changed; when nothing has, it finishes straight away and says so. Runs in the background: watch the simulation.resource_generation.completed webhook, or poll GET /v1/simulation/generations/resources/{generationId}. Takes one agent for now. Refused while another generation for the agent is running. Needs the ‘simulation:create’ and ‘metric:create’ permissions. Exploration also needs ‘simulation:run’, and is turned off for keys without it unless explore.enabled is set.
Calls POST /v1/simulation/generations/resources

Options

array
required
The agents to generate simulation resources for. One agent per generation for now. Repeatable.
string
The industry the agent serves. One of HEALTHCARE, FINANCIAL_SERVICES, INSURANCE, DEBT_COLLECTION, RETAIL, TRAVEL_AND_HOSPITALITY, TELECOMMUNICATIONS, TECHNOLOGY, PUBLIC_SECTOR, UTILITIES, LOGISTICS, AUTOMOTIVE, HOME_SERVICES, RESTAURANTS, EDUCATION, OTHER
string
A page Roark reads to learn about the business.
string
What you want tested, in your own words. Each scenario you describe becomes a flow.
array
The capabilities to test. Omit to let Roark work them out from the agent. One of APPOINTMENT_BOOKING, FAQ, IDENTITY_VERIFICATION, ACCOUNT_MANAGEMENT, BILLING_AND_PAYMENTS, ORDER_MANAGEMENT, TROUBLESHOOTING, CALL_ROUTING, LEAD_QUALIFICATION, COLLECTIONS, OUTBOUND_CALLING Repeatable.
string
The endpoint the run plan calls. Defaults to the agent’s newest endpoint.
object
Exploration settings.
switch
Whether Roark calls the agent to discover what it does before finishing the generation. Exploration calls are billed.
integer
The most exploration calls Roark places.
integer
The longest a single exploration call may last, in minutes.

Example

Every command also takes the global options and sets one of the exit codes.