Act - 🤘 Stagehand

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",
  },
});

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

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

参数: `ActOptions` | `ObserveResult`

TypeScript
Python

ActOptions:

action

string

必填

描述要执行的操作

modelName

AvailableModel

指定使用的模型

modelClientOptions

object

模型客户端的配置选项

variables

Record<string, string>

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

iframes

boolean

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

domSettleTimeoutMs

number

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

timeoutMs

number

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

ObserveResult:

selector

string

必填

表示元素选择器的字符串

description

string

必填

描述可能操作的字符串

method

string

必填

在元素上调用的方法

arguments

object

必填

传递给方法的参数

ActOptions:

action

string

必填

描述要执行的操作

model_name

string

指定使用的模型

model_client_options

dict

模型客户端的配置选项

variables

dict

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

dom_settle_timeout_ms

int

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

timeout_ms

int

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

ObserveResult:

selector

string

必填

表示元素选择器的字符串

description

string

必填

描述可能操作的字符串

method

string

必填

在元素上调用的方法

arguments

object

必填

传递给方法的参数

返回值: `Promise<ActResult>`

success

boolean

必填

操作是否成功完成

message

string

必填

操作执行的详细信息

action

string

必填

执行的操作名称

​参数: ActOptions | ObserveResult

​返回值: Promise<ActResult>

参数: `ActOptions` | `ObserveResult`

返回值: `Promise<ActResult>`