> ## Documentation Index
> Fetch the complete documentation index at: https://momentic.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# act

> Let the AI agent accomplish a goal autonomously.

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"`).                                                                                       |
| `cache`   | `false`   | No       | Set to `false` to disable caching. The AI agent runs on every execution instead of replaying previously generated steps. V3 only. |
| `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.

```yaml theme={null}
- act: Complete the new-user signup flow using a fresh email
```

## Examples

```yaml theme={null}
- act:
    goal: Add the cheapest in-stock item to the cart
    version: "2" # pin this step to a specific AI action version
```

Disable caching so the agent re-derives the flow on every run.

```yaml theme={null}
- act:
    goal: Open the most recent order and archive it
    cache: false
```

## Related

* [YAML format](/docs/core-concepts/test-format)
* [Agentic testing](/docs/core-concepts/agentic-testing)