Once your automation is ready, you can run it on connected devices through the dashboard. This guide covers the execution flow and data collection.

The Automation Runner

Access the runner from the DEVICES -> AUTOMATIONS section in your dashboard. The runner allows you to:

Execution Flow

1. Select automation from your available automations
2. Select devices to run on (must be connected)
3. Fill parameters as defined in your automation schema
4. Fill job variables for the specific task
5. Click Start to begin execution
6. Monitor progress via status updates
7. View/download results when complete

Parameter Validation

Parameters are validated against your schema before execution:

// Your schema definition
{
  "fields": [
    {
      "name": "maxRetries",
      "type": "number",
      "required": true,
      "min": 1,
      "max": 10,
      "integer": true
    },
    {
      "name": "targetUrl",
      "type": "string",
      "required": true,
      "pattern": "^https?://.*"
    }
  ]
}

// Validation errors shown to user:
// - "maxRetries: Value must be at least 1"
// - "targetUrl: Value does not match pattern"

Data Collection

Data submitted via submitTask() is collected and displayed in the runner:

// In your automation
await agent.utils.job.submitTask("success", {
  email: "user@example.com",
  orderId: "12345",
  itemsProcessed: 10,
  completedAt: new Date().toISOString()
});

// Don't forget to stop the automation!
stopCurrentAutomation();

// This data appears in the runner as:
// | Device     | email            | orderId | itemsProcessed | completedAt           |
// |------------|------------------|---------|----------------|----------------------|
// | Device-001 | user@example.com | 12345   | 10             | 2024-01-15T10:30:00Z |

Downloading Results

Collected data can be downloaded as CSV for analysis:

Start and Stop Commands

// When you click "Start":
POST /api/v1/device/automation
{
  "device_ids": ["device-001", "device-002"],
  "automationId": "automation-uuid",
  "command": "start",
  "automationParameters": { ... },
  "jobVariables": { ... }
}

// When you click "Stop":
POST /api/v1/device/automation
{
  "device_ids": ["device-001", "device-002"],
  "automationId": "automation-uuid",
  "command": "stop"
}

Multi-Device Execution

Running on multiple devices simultaneously:

Status Updates

The runner shows submitted data for each execution (click refresh to update).

Monitoring logs

On the devices page, click on top-right of device card to go to 'live control' page of that device. Click 'Live Automation Logs' to see real-time console logs from the automation running on that device.

Debugging Tips

Requirements Check

Before execution, the system verifies:

• Device meets minimum Android version requirement (only when running through a job)
• Device has minimum app version installed (only when running through a job)
• User has execution permission for the automation
• All required parameters are provided and valid

Next Steps