Skip to main content
The AI Task node uses natural language instructions to perform actions inside a real browser. It is the most flexible node type and is ideal for handling dynamic UI, multi-step interactions, and workflows that benefit from LLM reasoning. Common actions include:

Navigate

Navigate to and through pages

Fill forms

Enter and submit structured data

Use files

Read, upload, or download files

Extract data

Scrape data from a webpage

Configuration

Instructions

The core of an AI Task node is a natural language instruction block. You describe what the agent should do, and the LLM executes those steps in the browser. To achieve the most reliable behavior, structure your instructions with:
  • Goal: What the node is trying to accomplish
  • Ordered steps: A sequence of specific actions
  • Edge cases: Known variations the agent must handle
  • Success criteria: Observable conditions indicating completion
Example:
Your goal is to submit the consultation form for the current patient:
1.	Click “New Consultation”
2.	Fill the form fields with the provided data
3.	Upload any provided attachments
4.	Click “Create”

Edge cases:
- If a modal appears, close it before continuing
- If the page asks for confirmation, accept it

Success criteria:
Once you see the “Consultation Submitted” banner, the task is complete.

Dynamic Variables

Dynamic variables make your instructions reusable across multiple runs with different inputs. Variables are passed at execution time and referenced with the {{.var_name}} syntax. Example:
Navigate to the patient search page:
1.	Enter {{.patient_name}} into the search bar
2.	Select the matching result
3.	Fill {{.diagnosis}}
4.	Click Submit
...

Naming Rules

Variable names must:
  • Start with a letter or underscore
  • Contain only letters, numbers, and underscores
  • Not include special characters such as @, -, ., or spaces
Valid: {{.user_name}}, {{.email}}, {{.api_key}} Invalid: {{.user-name}}, {{.my@var}}, {{.1st_item}}

Advanced Templating

AI Task instructions support full Go Template syntax, enabling conditionals, loops, and structured data.
Use if statements to conditionally adjust behavior:
{{if .is_premium}}
Navigate to the premium dashboard and enable all features.
{{else}}
Navigate to the free dashboard.
{{end}}
The corresponding variable values should be:
{"is_premium": true}
Iterate through lists or arrays.Simple array:
Fill the form with the following items:
{{range .items}}
- Enter "{{.}}" in the next field
{{end}}
Array of objects:
Add products to the cart:
{{range .products}}
- {{.name}}: {{.price}}
{{end}}
The corresponding variable values should be:
["Item 1", "Item 2", "Item 3"]
Via SDK, you’d pass:
{
  "dynamicData": {
    "products": [
      {"name": "Widget A", "price": "$10"},
      {"name": "Widget B", "price": "$20"}
    ]
  }
}
Inside a range, {{.}} refers to the current item. For objects, use fields like {{.name}} and {{.price}}.
Access nested JSON structures:
User: {{.user.name}} ({{.user.email}})

{{if .user.verified}}
Proceed to checkout.
{{else}}
Please verify your email before continuing.
{{end}}
The corresponding variable values should be:
{"name": "Jane Smith", "email": "[email protected]", "verified": true}

Model Selection

Choose the model that best fits the complexity of the task:

Asteroid Fast

Lowest latency. Best for simple, fast interactions.

Asteroid Balanced

Default model. Balanced speed and accuracy.

Asteroid Max

Highest intelligence and reasoning depth for complex flows.

AI Capabilities

Enable specific capabilities depending on what the node needs to perform:

Web Browsing Essentials

Basic navigation, clicking, typing, and interaction

Advanced Web Browsing

Complex navigation, dynamic UIs, and robust action handling

Computer Vision

Visual understanding of the page and image-based interaction

Communication

Exchange messages and emails with the user during execution

File System

Upload, download, read, and write files

Memory & Storage

Store and retrieve data across execution steps

Google Sheets

Read from and write to Google Sheets

Authentication

Generate and manage authentication tokens

Context & Utilities

Access contextual data and system utilities
Explore all available features in AI Capabilities.

Additional Settings

Batch Actions

Enable parallel steps for faster execution when the workflow allows it.

Snapshot Compression

Reduce context size by compressing browser snapshots captured during execution.

Learn & Compile

Convert successful executions into a deterministic script for future runs. If the script fails, the agent falls back to AI and automatically updates the script. Scripts can include variable placeholders using the <<.VARNAME>> syntax.