***

title: browserUse.agent.execute
description: Run a browser-use agent task in the current runtime.
-----------------------------------------------------------------

`browserUse.agent.execute` is a browser runtime capability in the `browserUse.agent` namespace.

## Availability

* Runtime: `browser`
* Kind: `agent`
* Category: `agents`
* Supported drivers: browser-use

## SDK Surface

* SDK path: `runtime.browserUse.agent.execute`
* Async: Yes

## HTTP Surface

* Transport: `workspace.execute(...)`
* Call: `browserUse.agent.execute`
* Long-running: Yes

## Reference Semantics

* Requires refs: `page`

## Arguments

| Argument      | Type     | Required | Description               |
| ------------- | -------- | -------- | ------------------------- |
| `instruction` | `string` | Yes      | Browser-use agent task.   |
| `config`      | `object` | No       | Agent execution settings. |

## Result

* Type: `operation | result`
* Description: Immediate result or long-running operation metadata.

## SDK Example

```ts
await runtime.browserUse.agent.execute('Export the latest invoices');
```

## HTTP Example

```json
{
  "runtime": "crm",
  "steps": [
    {
      "call": "browserUse.agent.execute",
      "args": [
        "Export the latest invoices"
      ]
    }
  ]
}
```

## Related Capabilities

* [`browserUse.codeAgent.execute`](../agents/browser-use-code-agent-execute)
* [`stagehand.agent.execute`](../agents/stagehand-agent-execute)

## Notes

* This call may return an operation handle when the work runs asynchronously.