Skip to main content

assistant

This tool on every surface: CLI · MCP · Python · JavaScript · Go · Java · .NET

Ask the platform's assistant in typed text, and report what came back: Gemini or Google Assistant on Android, opened with the assist key, its field typed into and sent; Siri on a real iPhone. These call app_assistant.

assistant​

public Map<String, Object> assistant(String request, String app, double timeoutSeconds)

Asks the platform's assistant in typed text: Gemini or Google Assistant on Android, Siri on a real iPhone. The answer holds the assistant, the answer text it showed (empty when it showed none a screen read can see), the app in front afterward, typed (always true) and closed.

@param request what to ask, as a person would type it @param app the app expected to come forward, or null; reached says whether the assistant handed the request to it. Required for a request that acts for the owner — a call, a message, a purchase @param timeoutSeconds how long to wait for an app or an answer; 0 is 15 @return the assistant, its answer, the app in front, and with an app named, whether it was reached

Examples​

Ask the assistant to open an app, and check that it came forward​

Map<String, Object> got = device.assistant("Open Clock", "com.google.android.deskclock", 0);
if (!Boolean.TRUE.equals(got.get("reached"))) throw new AssertionError("in front: " + got.get("front"));

The same call from the command line, mobium assistant "Open Clock" --app com.google.android.deskclock, printed on an Android 15 emulator:

asked Google Assistant (typed, not spoken): "Open Clock"
it showed no text a screen read can see
in front: com.google.android.deskclock
com.google.android.deskclock came forward

mobium assistant &quot;Open Clock&quot; --app com.google.android.deskclock on an Android 15 emulator

mobium assistant "Open Clock" --app com.google.android.deskclock on an Android 15 emulator

Ask a question, and read the answer it showed​

Map<String, Object> got = device.assistant("What is 15 times 3", null, 20);
System.out.println(got.get("answer"));