> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roark.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# roark simulation resource generate

> Generate simulation resources

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.

```bash Synopsis theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark simulation resource generate [options]
```

> [!NOTE]
>
> Calls `POST /v1/simulation/generations/resources`

## Options

**--agent-ids** `array` *required*

The agents to generate simulation resources for. One agent per generation for now. Repeatable.

**--industry** `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`

**--website-url** `string`

A page Roark reads to learn about the business.

**--testing-instructions** `string`

What you want tested, in your own words. Each scenario you describe becomes a flow.

**--capabilities** `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.

**--agent-endpoint-id** `string`

The endpoint the run plan calls. Defaults to the agent's newest endpoint.

**--explore** `object`

Exploration settings.

**--explore.enabled** `switch`

Whether Roark calls the agent to discover what it does before finishing the generation. Exploration calls are billed.

**--explore.max-conversations** `integer`

The most exploration calls Roark places.

**--explore.max-conversation-minutes** `integer`

The longest a single exploration call may last, in minutes.

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark simulation resource generate --agent-ids <value>
```

Every command also takes the [global options](https://docs.roark.ai/cli-reference/overview.md#global-options) and sets one
of the [exit codes](https://docs.roark.ai/cli-reference/overview.md#exit-codes).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.