Run phone agent task
run-phone-agent-toolAsk the on-phone GUI agent to carry out a narrow task on a farm phone. Keep the task specific ("open Settings and turn on Wi-Fi"). Runs asynchronously: the call returns a run id at once; poll get-phone-run-tool with it until the run succeeds or fails, and use phone-snapshot-tool to see the screen.
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": {
"slot": "<slot>",
"task": "<task>"
},
"name": "run-phone-agent-tool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slot | Yes | Phone slot to run the agent on, given as the `slot` UUID from list-phones-tool (its display name like "slot12" is not accepted). The phone must show `video_live: true` there. | |
| task | Yes | Plain-language task for the on-phone GUI agent to carry out. |