Run natural-language task on device
device_run_taskHave the on-device AI agent (Google's ARTEMIS) perform a task described in plain English, e.g. 'Open Settings, enable Developer options, and report the Android build number'. Waits for completion (up to min(wait_seconds, 25) seconds on this remote server) and returns the task with its steps and result; if it is still running, poll with task_status. profile 'flash' is fast for simple UI actions; 'pro' plans and verifies multi-step tasks. AI is included (no model key needed); optionally ?model_key=… on the connector URL uses your own key. One task per device at a time.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"device_id": "<device_id>",
"instruction": "<instruction>"
},
"name": "device_run_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| profile | No | flash | |
| device_id | Yes | ||
| instruction | Yes | ||
| wait_seconds | No | 0 = return immediately with the queued task |