Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cloudcruise.com/llms.txt

Use this file to discover all available pages before exploring further.

The Click node performs click interactions on page elements. It supports various click types and execution strategies.

Parameters

ParameterTypeRequiredDescription
executionstringYesExecution type: STATIC (UI: “Static”), LLM_VISION (UI: “AI (Screenshot)”), or COORDINATES (UI: “Coordinates”)
selectorstringNoXPath selector (for STATIC) or JSON coordinates (for COORDINATES)
promptstringNoNatural language description of what to click (for LLM_VISION)
click_typestringNoType of click: click, double_click, right_click, or hover. Default: click
wait_timenumberNoMaximum time (ms) to wait for the element. Default: 15000
selector_error_messagestringNoCustom error message if element is not found
human_modebooleanNoIf true, use more human-like click behavior

Examples

Basic Click with STATIC Execution

Click a button using an XPath selector:
{
  "id": "abc123",
  "name": "Click submit button",
  "action": "CLICK",
  "parameters": {
    "execution": "STATIC",
    "selector": "//button[@type='submit']",
    "wait_time": 10000
  }
}

Click with LLM_VISION

Click an element using natural language:
{
  "id": "abc123",
  "name": "Click login button",
  "action": "CLICK",
  "parameters": {
    "execution": "LLM_VISION",
    "prompt": "Click the blue 'Login' button in the top right corner"
  }
}

Click with COORDINATES

Click at specific screen coordinates:
{
  "id": "abc123",
  "name": "Click at position",
  "action": "CLICK",
  "parameters": {
    "execution": "COORDINATES",
    "selector": "{\"x\": 450, \"y\": 320}"
  }
}

Double Click

Perform a double-click action:
{
  "id": "abc123",
  "name": "Open file",
  "action": "CLICK",
  "parameters": {
    "execution": "STATIC",
    "selector": "//div[@class='file-item'][1]",
    "click_type": "double_click"
  }
}

Right Click (Context Menu)

Open a context menu:
{
  "id": "abc123",
  "name": "Open context menu",
  "action": "CLICK",
  "parameters": {
    "execution": "STATIC",
    "selector": "//tr[@data-row-id='item-1']",
    "click_type": "right_click"
  }
}

Hover

Hover over an element to trigger tooltips or dropdowns:
{
  "id": "abc123",
  "name": "Hover over menu",
  "action": "CLICK",
  "parameters": {
    "execution": "STATIC",
    "selector": "//nav//li[contains(text(), 'Products')]",
    "click_type": "hover"
  }
}

Notes

  • Use STATIC execution when possible for speed and reliability
  • The hover click type is useful for revealing dropdown menus or tooltips before interacting with them
  • Add descriptive names to help the maintenance agent understand the purpose of each click