Act

await page.act("click on add to cart");

await page.act("click on add to cart")

act() 允许 Stagehand 与网页进行交互。提供类似 "点击加入购物车按钮" 或 "在搜索栏输入'Browserbase'" 这样的 action 指令。您可以定义不会与LLM提供商共享的变量

await page.act({
  action: "fill in the form with %username% and %password%",
  variables: {
    username: "john.doe",
    password: "secretpass123",
  },
});

await page.act({
  "fill in the form with %username% and %password%",
  variables={
    "username": "john.doe",
    "password": "secretpass123",
  },
})

小而独立的目标能获得最佳性能。避免使用 act() 执行复杂操作。对于多步骤操作，请改用 Agent。

可以向 act() 传递 ObserveResult 来执行建议的操作，这将获得更快且成本更低的结果（无需LLM推理）。

参数: `ActOptions` | `ObserveResult`

TypeScript
Python

ActOptions:

string

必填

描述要执行的操作

AvailableModel

指定使用的模型

object

模型客户端的配置选项

Record<string, string>

操作中使用的变量。在操作字符串中通过%variable_name%引用变量

boolean

如果目标元素位于iframe内，请设置iframes: true

number

等待DOM稳定的超时时间（毫秒）

number

执行操作的超时时间（毫秒）

ObserveResult:

string

必填

表示元素选择器的字符串

string

必填

描述可能操作的字符串

string

必填

在元素上调用的方法

object

必填

传递给方法的参数

ActOptions:

string

必填

描述要执行的操作

string

指定使用的模型

dict

模型客户端的配置选项

dict

操作中使用的变量。在操作字符串中通过%variable_name%引用变量

int

等待DOM稳定的超时时间（毫秒）

int

执行操作的超时时间（毫秒）

ObserveResult:

string

必填

表示元素选择器的字符串

string

必填

描述可能操作的字符串

string

必填

在元素上调用的方法

object

必填

传递给方法的参数

返回值: `Promise<ActResult>`

boolean

必填

操作是否成功完成

string

必填

操作执行的详细信息

string

必填

执行的操作名称

Get Started

Concepts

Playbooks

Reference

Integrations

参数: `ActOptions` | `ObserveResult`

返回值: `Promise<ActResult>`

​参数: ActOptions | ObserveResult

​返回值: Promise<ActResult>

参数: `ActOptions` | `ObserveResult`

返回值: `Promise<ActResult>`