Skip to main content
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

ParameterTypeRequiredDescription
goalstringYesWhat the agent should accomplish.
versionstringNoAI action version to run with (e.g. "2").
saveAsstringNoVariable to store this step’s return value on env.<name>.
retriesnumberNoTimes to retry the step on failure before failing the test.
skippedbooleanNoSkip 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