Skip to content

Prerequisites & licensing (required)

1. Purchase and bind USB device license

AI Agent automation steps (start environment, tap/swipe, run workflows, IME input, etc.) require a USB device license, same as EC scripts.

Steps:

  1. Purchase a license from official channels or resellers
  2. With the phone connected over USB, open License Center → Batch license (device ID on the left, card number on the right)
  3. Or on https://uc.ieasyclick.com go to My iOS devices → Batch bind license, then in the control center License Center → Refresh license

2. Configure runtime environment

Different workflow steps depend on different environments. You can draw flows slowly before saving, but before trial or production runs confirm the matching environment is ready.

Option A: USB automation environment (proxy IPA / standalone main app)

Use for most UI automation, for example:

  • Start automation environment (ensure_auto_env)
  • Tap, swipe, type text
  • Automation screenshot / OCR, UI node capture (fetch_nodes)
  • IME input steps

You need to:

  1. Install and sign the automation service IPA on the phone (iOS 15+ can also use the standalone main app v7.2.0+ per the screen tutorial as the automation service — more complete)
  2. Unpack the control center and configure the developer disk image
  3. Enter the proxy bundleID in the control center and enable automation successfully (service status Yes)
  4. Complete USB device licensing from the previous section

Full walkthrough: iOS USB screen tutorial · Sign IPA (Same page covers unpacking, flashing images, starting automation, screen control, etc. — read the proxy mode screen section)

Option B: BLE / OTG environment

Use for workflow ble_* steps (BLE peripheral tap, swipe, keys, etc.), or when you use BLE HID screen on the control center side.

You need to:

  1. Prepare a BLE module/board; on the device context menu BLE HID settings → Bind BLE, and pass Test BLE
  2. Follow the tutorial to enable Bluetooth, Accessibility, etc. on the iPhone
  3. For OTG simulated HID, prepare an OTG module, flash firmware, and complete binding separately

Detailed guides:

  • BLE tutorial — binding, testing, phone options, WiFi provisioning, shortcuts
  • OTG tutorial — OTG HID connection, board and shortcut setup

3. Pre-run checklist

CheckOK when
Device onlinePhone connected in new control center device list
USB device licenseBound in License Center, not expired
Automation env (flow has UI automation)“Enable automation” succeeded, service status Yes
BLE / OTG (flow has ble_*)Bound and Test BLE passed
LLM (AI chat / AI workflow authoring only)Model configured; pure run/trial does not consume Token

Still failing → FAQ quick reference · Troubleshooting