# run_agent_task

Give Silan's built-in agent a task in plain language, with a step and cost budget.

Give Silan's built-in agent a task in plain language, with a step and cost budget.

| | |
|---|---|
| REST operation | [`startAgentTask`](/reference/rest/agent/#startagenttask) (`POST /v1/agent/tasks`) |
| Needs a device | no |
| Read only | no |
| Profiles | `full` |

## Parameters

| Name | Required | Type | Goes to | What it is |
|---|---|---|---|---|
| `instruction` | yes | string | body `instruction` |  |
| `device_ids` | no | array of string | body `deviceIds` |  |
| `model` | no | string | body `model` | Provider/model id, such as "anthropic:claude-sonnet-5" or "local:ui-tars". |
| `max_steps` | no | integer | body `maxSteps` |  |
| `budget_usd` | no | number | body `budgetUsd` |  |

## Example call

```text
run_agent_task({ instruction: … })
```