***

title: stagehand.act
description: Execute a natural-language action using Stagehand.
---------------------------------------------------------------

`stagehand.act` is a browser runtime capability in the `stagehand` namespace.

## Availability

* Runtime: `browser`
* Kind: `agent`
* Category: `agents`
* Supported drivers: Stagehand

## SDK Surface

* SDK path: `runtime.stagehand.act`
* Async: Yes

## HTTP Surface

* Transport: `workspace.execute(...)`
* Call: `stagehand.act`
* Long-running: No

## Reference Semantics

* Requires refs: `page`

## Arguments

| Argument      | Type     | Required | Description                                 |
| ------------- | -------- | -------- | ------------------------------------------- |
| `instruction` | `string` | Yes      | Natural-language instruction for Stagehand. |
| `options`     | `object` | No       | Stagehand-specific options.                 |

## Result

* Type: `unknown`
* Description: Stagehand action result.

## SDK Example

```ts
await runtime.stagehand.act('Export the latest invoices');
```

## HTTP Example

```json
{
  "runtime": "crm",
  "steps": [
    {
      "call": "stagehand.act",
      "args": [
        "Export the latest invoices"
      ]
    }
  ]
}
```

## Related Capabilities

* [`stagehand.extract`](../agents/stagehand-extract)
* [`stagehand.observe`](../agents/stagehand-observe)
* [`stagehand.agent.execute`](../agents/stagehand-agent-execute)