Browser CapabilitiesAgents

stagehand.act

View as Markdown

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

ArgumentTypeRequiredDescription
instructionstringYesNatural-language instruction for Stagehand.
optionsobjectNoStagehand-specific options.

Result

  • Type: unknown
  • Description: Stagehand action result.

SDK Example

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

HTTP Example

1{
2  "runtime": "crm",
3  "steps": [
4    {
5      "call": "stagehand.act",
6      "args": [
7        "Export the latest invoices"
8      ]
9    }
10  ]
11}