Skip to content

Chapter 9: Example AI Assistant Queries & Workflows

This chapter brings together everything we've learned by showcasing practical examples of how you can interact with DroidMind through your AI assistant. These scenarios demonstrate how to combine different DroidMind tools and capabilities to solve common Android development, debugging, and management tasks.

Remember to replace placeholders like your_device_serial, com.example.myapp, and file paths with your actual details.

9.1 Basic Device Checkup

Goal: Get a quick overview of a connected device.

Example Conversation with AI:

You: "Hey AI, I just connected a new test device. Can you give me a quick checkup on your_device_serial?"

AI (using DroidMind list_devices and device_properties): "Okay, your_device_serial (model: Pixel 6, Android Version: 13) is connected. Key properties:

  • Model: Pixel 6
  • Brand: google
  • Android Version: 13
  • SDK Level: 32
  • Build Number: TP1A.220624.014 Is there anything specific you'd like to know or do with it?"

9.2 Debugging an Application Crash

Goal: Investigate why an application is crashing.

Example Conversation with AI:

You: "My app com.example.myapp just crashed on emulator-5554. Can you help me figure out why?"

AI (using DroidMind app_logs, device_crash_logs): "I'm sorry to hear that! Let me check the logs for com.example.myapp on emulator-5554 and any general crash reports...

(After DroidMind provides data)

Okay, I found the following in the app logs for com.example.myapp around the time of the crash:

01-15 14:10:05.123 E AndroidRuntime: FATAL EXCEPTION: main
01-15 14:10:05.123 E AndroidRuntime: Process: com.example.myapp, PID: 12345
01-15 14:10:05.123 E AndroidRuntime: java.lang.NullPointerException: Attempt to invoke virtual method 'void com.example.myapp.SomeObject.doSomething()' on a null object reference
01-15 14:10:05.123 E AndroidRuntime:  at com.example.myapp.MyActivity.onCreate(MyActivity.java:42)
...

It looks like a NullPointerException occurred in MyActivity.java at line 42. You might be trying to use an object SomeObject that hasn't been initialized. Would you like me to check the device's ANR traces as well?"

9.3 Transferring Files and Verifying

Goal: Upload a configuration file to the device, then verify its contents.

Example Conversation with AI:

You: "Please upload /Users/bliss/Desktop/new_config.xml to /sdcard/AppConfig/ on your_device_serial."

AI (using DroidMind push_file): "Done! The file new_config.xml has been uploaded to /sdcard/AppConfig/ on your_device_serial."

You: "Thanks! Now, can you read back the contents of /sdcard/AppConfig/new_config.xml on that device?"

AI (using DroidMind read_file): "Certainly! Here are the contents of /sdcard/AppConfig/new_config.xml:

<config>
  <setting name="feature_alpha" enabled="true" />
  <timeout value="5000" />
</config>
```"

9.4 Cleaning Up an Application for Testing

Goal: Stop an app, clear its data, and then restart it for a fresh test run.

Example Conversation with AI:

You: "I need to re-test the onboarding flow for com.example.testapp on emulator-5554. Can you prepare the app for a fresh start?"

AI (using DroidMind stop_app, clear_app_data, then start_app): "Okay, I will perform the following steps on emulator-5554 for com.example.testapp:

  1. Force stop the application.
  2. Clear its data and cache.
  3. Start the application again.

(After DroidMind operations complete)

All done! com.example.testapp has been stopped, its data cleared, and it has been restarted. It should be in a fresh state now."

9.5 Basic UI Interaction

Goal: Navigate to a specific screen in an app using UI automation tools.

You: "On emulator-5554, I need to open the Settings app and then tap on the 'Network & internet' option. I'll need a screenshot first to see where it is."

AI (using DroidMind start_app, then screenshot): "Okay, I'll start the Settings app (com.android.settings) on emulator-5554. One moment... Here's a screenshot of the main Settings screen:

[AI displays screenshot]

Based on the screenshot, it looks like 'Network & internet' is near the top. Could you give me the approximate coordinates if you see it, or I can try to find it based on text if a future DroidMind version supports that."

You: "Okay, from the screenshot, it looks like it's around X 300, Y 500. Please tap there."

AI (using DroidMind tap): "Tapping at (300, 500) on emulator-5554... Done! Let me know if that opened the correct screen."

9.6 Checking Device Resources before an Update

Goal: Ensure a device has enough space and a good battery level before attempting a large app update.

Example Conversation with AI:

You: "I'm about to push a large update for com.mycorp.bigapp to your_device_serial. Can you check its available storage and current battery level?"

AI (using DroidMind shell_command for df -h, and device_battery_stats): "Let me check those for you on your_device_serial...

(After DroidMind provides data)

  • Storage: The /data partition has 2.5GB free.
  • Battery: Currently at 85% and charging.

It looks like you have sufficient storage and a good battery level for the update."

9.7 Investigating a Slow App

Goal: Get initial diagnostics for an app that feels sluggish.

You: "The app com.example.slowapp on emulator-5554 has been very slow lately. Can you get me some initial diagnostics? Perhaps its logs and a summary of its manifest?"

AI (using DroidMind app_logs, get_app_manifest): "I can help with that. I'll fetch the recent logs for com.example.slowapp and its manifest details from emulator-5554...

(After DroidMind provides data)

Here's a summary:

  • Logs: I see several 'Choreographer: Skipped X frames!' messages, which often indicate UI jank. There are also some network timeout errors.
  • Manifest: The app requests permissions for INTERNET, ACCESS_FINE_LOCATION, and READ_EXTERNAL_STORAGE. It has 3 activities, 2 services, and 1 broadcast receiver defined.

Based on this, the slowness might be related to UI performance issues or network problems. Would you like to dump the heap for this app or get a full bug report for more detailed analysis?"

These examples are just a starting point. The power of DroidMind lies in its flexibility, allowing your AI assistant to combine these tools in numerous ways to address your specific needs. Don't hesitate to experiment with complex requests and multi-step workflows!

This concludes the DroidMind User Manual. For a detailed list of all tools and their parameters, please refer to the MCP Reference.

Happy DroidMinding! 🤖✨