Skip to content

Commit a085a21

Browse files
chore: update docs and add info on new MultiDeviceAgent
1 parent 070710d commit a085a21

1 file changed

Lines changed: 21 additions & 1 deletion

File tree

docs/02_using_agents.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Using Agents
22

3-
AskUI Vision Agent provides three predefined agent types for different automation targets. All agents share the same core API (`act()`, `get()`, `locate()`) but are optimized for their respective platforms. Each agent comes with its own system prompt tailored to its platform-specific tools and capabilities.
3+
AskUI Vision Agent provides four predefined agent types for different automation targets. All agents share the same core API (`act()`, `get()`, `locate()`) but are optimized for their respective platforms. Each agent comes with its own system prompt tailored to its platform-specific tools and capabilities.
44

55
## ComputerAgent
66

@@ -47,10 +47,30 @@ with WebVisionAgent() as agent:
4747

4848
**Default tools:** All `ComputerAgent` tools plus `goto`, `back`, `forward`, `get_page_title`, `get_page_url`
4949

50+
## MultiDeviceAgent
51+
52+
Use this agent when you need to control a desktop computer and an Android device within the same task. The agent has access to both the full set of computer tools (via AskUI Agent OS) and Android tools (via ADB), and can switch between devices seamlessly during execution.
53+
54+
This is useful for cross-device workflows, such as triggering an action on the desktop and verifying the result on a mobile device, or transferring data between devices.
55+
56+
```python
57+
from askui import MultiDeviceAgent
58+
59+
with MultiDeviceAgent(android_device_sn="emulator-5554") as agent:
60+
agent.act("Open the web app on the computer and send a push notification, then verify it appears on the Android device")
61+
```
62+
63+
If you have multiple Android devices connected, pass the serial number of the target device via `android_device_sn`. You can find serial numbers by running `adb devices`. If omitted, no device is preselected and the agent will select one at runtime.
64+
65+
Requires the `android` dependency installed (`pip install askui[android]`) and a connected device (physical or emulator).
66+
67+
**Default tools:** All `ComputerAgent` tools plus all `AndroidAgent` tools. Additional tools can be provided via the `act_tools` parameter.
68+
5069
## Choosing an Agent
5170

5271
| Target | Agent | Backend |
5372
|--------|-------|---------|
5473
| Desktop (Windows/macOS/Linux) | `ComputerAgent` | AskUI Agent OS (gRPC) |
5574
| Android devices | `AndroidAgent` | ADB |
75+
| Desktop + Android | `MultiDeviceAgent` | AskUI Agent OS (gRPC) + ADB |
5676
| Web browsers | `WebVisionAgent` | Playwright |

0 commit comments

Comments
 (0)