act

Hands a natural-language goal to the AI agent, which performs whatever taps, types, and scrolls are needed to accomplish it. Reach for act when the exact UI path is unknown or brittle; use a single tap/type when you already know the step. The simplified form takes the goal as a single string.

Parameters

Parameter	Type	Required	Description
`goal`	`string`	Yes	What the agent should accomplish.
`version`	`string`	No	AI action version to run with (e.g. `"2"`).
`saveAs`	`string`	No	Variable to store this step’s return value on `env.<name>`.
`retries`	`number`	No	Times to retry the step on failure before failing the test.
`skipped`	`boolean`	No	Skip this step at execution time.

Shorthand

Goal as a single string.

- act: Complete the new-user signup flow using a fresh email

Examples

- act:
    goal: Add the cheapest in-stock item to the cart
    version: "2" # pin this step to a specific AI action version

Test format
Agentic testing

Overview

AI

Interactions

Device

Apps

Screen checks

Element checks

Visual

Network

Scripts

Files

Waits

Control flow

Debugging

Parameters

Shorthand

Examples

​Parameters

​Shorthand

​Examples

​Related

Parameters

Shorthand

Examples

Related