docs(ai): Adds --analyze flag docs for TestCommand and update Ai Configurations (#110)

* docs(analyze): Adds new --analyze flag docs and assets

* docs(analyze): Removes unnecessary note

* Update cli/test-suites-and-reports.md

* docs(ai): Adjuts ai configuration to robin cloud

Author: luistak

Diff for: .gitbook/assets/analyze-report.png

@@ -16,37 +16,18 @@ commands, additional configuration is required.
 
 The default model is the latest GPT-4o.
 
-You can configure the model to use with the `MAESTRO_CLI_AI_MODEL` env var, for example:
-
-```console
-export MAESTRO_CLI_AI_MODEL=claude-3-5-sonnet-20240620
-```
-
-Currently supported:
-
-- GPT family of models from OpenAI
-- Claude family of models from Anthropic
-
 Support for more models and providers is tracked [in this issue](https://github.com/mobile-dev-inc/maestro/issues/1957).
 
 ### API key
 
-To use this command, an API key for the LLM service is required. To set it,
-export the `MAESTRO_CLI_AI_KEY` env var.
+{% hint style="success" %}
+To use these features, you must have an account on [Robin](https://www.robintest.com), the official Maestro cloud platform. Make sure to [create an account](https://signin.robintest.com/sign-up) and [**retrieve your API key**](MAESTRO_CLOUD_API_KEY) to set it up correctly by following this link:
 
-For example, to set the key for OpenAI:
-
-```console
-export MAESTRO_CLI_AI_KEY=sk-4NXxdLXY4H9DZW0Vpf4lT3HuBaFJoz1zoL21eLoLRKlyXd69
-```
+{% endhint %}
 
-or for Anthropic:
+To use this command, an API key for the LLM is required. With the latest changes, we have migrated hard-coded API calls and prompts to our cloud backend, allowing us to enhance these features dynamically without requiring new CLI releases. To set it,
+export the `MAESTRO_CLOUD_API_KEY` env var.
 
 ```console
-export MAESTRO_CLI_AI_KEY=sk-ant-api03-U9vWi8GDrxRAvA2RL2RMCImYCQr8BFCbNOq2woeRXLNz2Iy4PbY1X2137leSm92mitI7F9IwxKIrXtXgTIzj7A-2AvgbwAA
+export MAESTRO_CLOUD_API_KEY=rb_qikYa7g2y5LcDEwLaEDz258ykjRQW7tIaR9K8jLlz6ijqCLTNfnDla3Nd17JF2ealh8kcsYHYyg35M41obGaz85VJz4uqI1orj
 ```
-
-{% hint style="info" %}
-**You need to bring your own API key.** The keys above are just examples and are
-not valid.
-{% endhint %}

Diff for: api-reference/configuration/ai-configuration.md

@@ -112,3 +112,78 @@ Note that your Flows should **not** depend on device state and should be treated
 #### Configuring part of the Flows to run sequentially
 
 For instance, if you have three Flows, `flowA`, `flowB`, and `flowC`, but you want to run only `flowA` and `flowB` sequentially, don't add `flowC` and `flowD` to the list. Maestro will run these Flows in non-deterministic ordering **after** the Flow sequence has finished executing.
+
+#### Analyze
+
+{% hint style="warning" %}
+
+This is an **experimental** feature powered by LLM technology. All feedback is
+welcome.
+
+{% endhint %}
+
+Maestro introduces a new feature that leverages AI to analyze your end-to-end (E2E) mobile tests and provide actionable insights based on your test logs, commands, and screenshots captured during your test runs. The AI-powered analysis identifies potential issues in your app's functionality, UI, and internationalization, helping you improve app quality efficiently.
+
+**Login Requirement:** Before you use the AI analysis feature, ensure you are logged into Maestro. Run the following command:
+
+```bash
+maestro login
+```
+
+**Analyzing your tests**: To analyze your test flows with AI, use the --analyze flag with the maestro test command:
+
+```bash
+maestro test flow-file.yaml --analyze
+```
+
+{% hint style="info" %}
+
+While we aim for precision, please note that this is a beta release, and the results should be validated before making critical decision
+
+{% endhint %}
+
+This will enable AI analysis and provide a detailed report based on your test artifacts:
+
+##### Examples
+
+Successful Analysis
+
+Command:
+
+```bash
+maestro test flow-file.yaml --analyze
+```
+
+Output:
+
+```bash
+🔎 Analyzing Flow(s)...
+
+To view the report, open the following link in your browser:
+file:///path/to/your/insights-report.html
+
+Analyze support is in Beta. We would appreciate your feedback in our Slack channel: #community-chat
+
+```
+
+<figure><img src="../.gitbook/assets/analyze-report.png" alt=""><figcaption></figcaption></figure>
+
+No Issues Found
+
+If no issues are detected, you will see a message like this:
+
+```bash
+Hey, we analyzed your flow for spelling, grammar, and internationalization issues, and good news 🙌 we didn't find any issues!
+```
+
+##### Disabling Notifications
+
+To disable the AI analysis notification, set the `MAESTRO_CLI_ANALYSIS_NOTIFICATION_DISABLED` environment variable to true before running Maestro:
+
+```bash
+export MAESTRO_CLI_ANALYSIS_NOTIFICATION_DISABLED=true
+```
+
+##### Feedback
+
+The Analyze feature is currently in Beta. Share your feedback and suggestions in our Slack channel:[#community-chat](https://mobile-dev-inc.slack.com/archives/C083YB8N42G)