> ## 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 agent setup create

> Set up an agent

Generates flows, metrics and a run plan for the agent. Runs in the background: watch the agent.setup.completed webhook, or poll GET /v1/agent/\{agentId}/setup. Refuses while another setup 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 agent setup create <agent-id> [options]
```

> [!NOTE]
>
> Calls `POST /v1/agent/{agentId}/setup`

## Arguments

**agent-id** `string` *required*

The agent-id.

## Options

**--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 setup. 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 agent setup create <agent-id>
```

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.