# 23.70.0 - public and private clouds

Guidelines

Version  23.70\
Date: 04.07.2023

<br>

### AI | Narrate the ideas and convert your speech to a requirement <a href="#ai__narrate_the_ideas_and_convert_your_speech_to_a_requirement" id="ai__narrate_the_ideas_and_convert_your_speech_to_a_requirement"></a>

Useful when:

* You don’t have time to create or update documentation for your project
* You want to create comprehensive documentation for the tech team&#x20;
* You need to make sure that all aspects of the product requirement document are covered
* You are looking for a tool that provides an option to help junior specialists to write high-quality documentation

Guide:

First, you need to create a new requirement.

<figure><img src="https://lh6.googleusercontent.com/R_61-ZCl98FdJ63iiPBZji-XMp0USWSkYa11fnz7Piz6dOBIgXDOBdS730mox3DASZjNKlwpDqmAKnoSOjls7PBNaveQ_XszuVltg1zqTBFzkJ_s02fNUG6-jhBk74qItZiRE5fhkfYfEnlwlE-ZkoM" alt=""><figcaption></figcaption></figure>

Once the requirement is created, click the ‘Narrator’ button on the ribbon.

<figure><img src="https://lh4.googleusercontent.com/yTkTGDT_4v0zf3vFASxoLQyWD5pQvg7mYw8kxHqVGZeV7TP6MSB7bKKoCSvrY1XrB0iTatjiTOgIdB1fW538WbZQovIN_I3Ex9G_lvZwyEn8Y24b-E4254YjJpph6pJhsQA3HpD1GnUhwScc9MDxkHw" alt=""><figcaption></figcaption></figure>

The system will ask you to grant access to your microphone. You need to enable it only once by clicking the ‘Allow’ button.&#x20;

<figure><img src="https://lh4.googleusercontent.com/TnTL3NeqsFYAiIyaxFwe3xlm27fiAeQW7RqAv8tEN-k2JrjMwF2769MPSz-9yZPf8mjREhCKcec_bP3vFdRp7ASWyKqa0QPf6z8SENZijmDCQJljbn0N7fWYiAI_pqd1X2bl1UxzjqV49EWQ1_xZFzE" alt=""><figcaption></figcaption></figure>

Once you enable it, the recording will start automatically without any other actions needed from your side. Just start narrating your thoughts. At first, it might be a bit awkward, but just give it a few tries until you get used to it. As soon as you record a few thoughts, you'll see how easy and convenient it is.

You can always discard recording by clicking ‘Cancel’ or simply closing the pop-up. To stop recording, you need to click the ‘Stop’ button.

<figure><img src="https://lh5.googleusercontent.com/vPwsaaKv4dTWeFABeV-O5hMriek5VulryFEDZV2esn5PoYBRNZisI8CyleZyYDKSKCQKHPkawP1Ci_ZJCfy-VFHbsl0umdPlSPUubJjLkd9Pxxg0kYduweNd1VhezeeqntFKVGU8FmRBFhZc2q8P_kg" alt=""><figcaption></figcaption></figure>

When the recording is stopped, the aqua AI will be triggered to analyse what has been narrated and in a few seconds start generating the product requirement document. Your recorded audio is kept temporary to generate a PRD and then removed once it's done.<br>

<figure><img src="https://lh6.googleusercontent.com/FjNVpE-G6bKwR6IJEd2a90uTKqZlhkgtkEJ3vM1LWMME7QV1FGjs-ZW8xXgsKuMYWGMx__PjBU_fIoaEyJ-7UyI37zmtYxAUsR53rv6aayDvmhqK_LX1QEuvPzf4pNvZDmjDKyL1dzF4pAT6v4sZS6E" alt=""><figcaption></figcaption></figure>

Wait for a few seconds and then review the result. If you are happy with the created PRD, click the ‘Apply’ button.

<figure><img src="https://lh5.googleusercontent.com/uqxk_qWL1g75L0Xhe2kQ0Tl-qOvRnM2DZaafhsd0xBULqAiU0gfemolVAqW3O1HLRap0jmwatTAY415HFW0Yy5-ILhLaaouWD-klJ0ri4ISa7_qTPk3QDUb6G2GnFXdgPmcDtyjs0dBfkU7cD8XnOuc" alt=""><figcaption></figcaption></figure>

The generated document will be automatically added to the description field of the requirement. You can easily extend or edit the created document.&#x20;

<figure><img src="https://lh4.googleusercontent.com/JHOZfC2hSpuVsbh7ocMs5RggAx6705XJxRBO1fcAtdTqfOlo1i7nrArF4gRi4Pm-HfeqlhtM5xk7w-KVXO3-KGHRZ2wTSH1090rDKHy80dnqR2i9HAB9GUxFuVsASlG6_M_gx5U-WpnGDqhap1MsiyU" alt=""><figcaption></figcaption></figure>

Moreover, aqua AI also adds the narrated notes as a ‘Background’ to the requirement, so you can always read what you have said, tweak it or extend it the text and then narrate it once again while reading the text, but already with the added details to create another version of PRD.

<figure><img src="https://lh4.googleusercontent.com/Ja5a9fCwJXkKTijemCvpu2tnjsfOJeEXlgWE11YOgojRQTHGVr_0lvYGx3Ru73q2wjZ_jK3VtI_pkr86yHEvkSkDg2EKdW2L5xESbY6yaaut6TjaXebTMidM-Nb_YHpYEw6efLKBD5VLSLM8RbeXceQ" alt=""><figcaption></figcaption></figure>

\
Last but not least, don’t forget to save a requirement to keep the document.<br>

Besides, if you want to create a test case based on this requirement, click the ‘Copilot’ button. aqua AI will start analysing the document and create a test case based on it.

<figure><img src="https://lh5.googleusercontent.com/iXgPov-tEBG1AMF-XnLoC44zUnFJPLOLT5RKJNPbsPJ5yaeWZP7Nl1QC0PnRFgnw4miJDIfzlrNdTSnPqufHqfQWRn_8i3S5SNuKRpa-BJzRsog6aAtnuuJYi8IPUrLBuAxGv89VzvJaG2B4eKJ42vo" alt=""><figcaption></figcaption></figure>

<br>

{% hint style="info" %}
Note: aqua doesn’t store your recorded audios, and they are kept for PRD generation only. When the requirement is generated and saved, the audio recording is deleted.&#x20;
{% endhint %}

### AI | Saving context provided to the AI Copilot (test case generation) on a project level <a href="#ai__saving_context_provided_to_the_ai_copilot_test_case_generation_on_a_project_level" id="ai__saving_context_provided_to_the_ai_copilot_test_case_generation_on_a_project_level"></a>

Useful when:

* You have a complex or unique project with special terms that are essential for proper test case generation, and you want to save this data
* You want to provide some additional data for AI Copilot to make test case generation more accurate, and it’s permanent.
* You have many projects, but you want to preserve the provided data for test cases generation for each project individually and want aqua to save it.

Guide:

When you generated a test case, before quitting the pop-up, click on the ‘Expand’  button.

The section with the context will open.

Provide all information that you want aqua to store for further test case generation and either close the pop-up or simply trigger the test case creation once again.<br>

<figure><img src="https://lh6.googleusercontent.com/1-eU1aBFVyg_sUwQ_CdjO7FU8lllXa85tslxFGREmHLH1QvTGPAR7sQcpgei6WcW_qbR8UQg1sW_63kDpBEsuYgyr9yi6GB8-FkM_F-WWUGGbnFbeIxJV2QVYqDUlJ07HVrfcWRUizbw5ySGeAxzkC8" alt=""><figcaption></figcaption></figure>

From now on, whenever you’ll start the AI Copilot, it will take the context into account.

In case you need to modify or update the background information, just substitute the previous data with the new one. AI Copilot will incorporate the recent information for future test case generations.<br>

### Jira | Improved flows for connecting Jira issues with aqua test executions and aqua items  <a href="#jira__improved_flows_for_connecting_jira_issues_with_aqua_test_executions_and_aqua_items" id="jira__improved_flows_for_connecting_jira_issues_with_aqua_test_executions_and_aqua_items"></a>

Useful when:

* You want to connect an already existing Jira issue to the test execution
* You want to create a Jira issue from aqua item and add it as a dependency
* You want to connect multiple Jira issues at once to aqua test execution or aqua items

<br>

Guide:

To connect existing Jira issues to aqua tickets, you need to set up the integration with Jira first. Follow this [guide](https://aquacloudio.zohodesk.eu/portal/en/kb/articles/configuration-in-aqua) to get started in less than 5 minutes.&#x20;

Once the integration is in place, open the desired aqua item, navigate to the ‘Dependencies’ tab, and then click the ‘Connect Jira issue’ button.

<figure><img src="https://lh3.googleusercontent.com/yJGYjoM6ScHSrK1y82TE-iK3cvPeD0YvkpKxVfrQfWXGmNf1XHjagZRlQZaNe79xTKD9cg-golv-pOT4-EnYeWC6obfHbc0cjl2HhRLC45TRkuLmYcZVHI7Qsqg6KRou1uMje3yRe7WrCV2NapHJkpE" alt=""><figcaption></figcaption></figure>

When the popup opens, provide the IDs of the Jira issues (separated by commas) and then click the ‘Connect’ button.&#x20;

<figure><img src="https://lh4.googleusercontent.com/XGeDvpfl6-JZ20AJFpyTDTrl9SNosgFQdLkW7nXn49cFRK8cJZnh5aNWL2yfAHxMMr7xCC6QIB9yIbGmZWyyuZblEkzCqtO4IVTiaPUD_cUJAbuLCtZlBuqURDoCg61eenha20yUgkUe0XzyNkxSpUA" alt=""><figcaption></figcaption></figure>

\
All referenced issues will be linked to the target aqua item.

{% hint style="info" %}
Please note, there is a limit of 10 IDs that you can provide at once. You will be able to link more items by going through the same steps again.
{% endhint %}

<figure><img src="https://lh4.googleusercontent.com/rjTJwzV-0UoZseFI_t65JgP71jr3jkfcAQwLzl0hdB1Ns67l7Ej3OoZUOt5PfgDehiQWG1PmUeWrSPPNDeVxo-vDW9mcWanRSCJQGqe2j68OT94uR85hbupPErK4rkwWzNMiC7uzuh-3r9HdP0wMAVw" alt=""><figcaption></figcaption></figure>

In case you want to create a new Jira issue and link it to the aqua item, just click the ‘New issue’ button and, once you save it on the Jira side, go back to aqua and provide the ID.\ <br>

You can use the same flow to connect multiple existing or new Jira issues to aqua’s test executions. Just click the same ‘Connect Jira issue’ button on the test execution or test execution details page.

<figure><img src="https://lh4.googleusercontent.com/I9liPI9akWcc4ksa47FQN76cz20xhZHSe_cUNdNTtgte2ZuqPX7QHLYrIpX9OUzM9UZxPvG-4brPLDkzQBhBI-Sako_3txoyPtMBIhfiNPiZxTMfhHUvSCNd3koIDUVHM_Vzs7eZqesvbfi65rkDr1c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh3.googleusercontent.com/y06DmzMuHfY6B-az0lRu_8kSUTQMZy88E4zzlQ9farkc3po0HDLNzpGjF5hvXaFeKGNN5rArqkTPNye2NiU3WCfHCNConBOmG-5JggnpGeObjiZ7yBe1z0e36_7BbdoxMHL-i7q9GNjrAD8lCUVYeaM" alt=""><figcaption></figcaption></figure>

<br>

### Ranorex | Handle links in project to external files in Ranorex scripts <a href="#ranorex__handle_links_in_project_to_external_files_in_ranorex_scripts" id="ranorex__handle_links_in_project_to_external_files_in_ranorex_scripts"></a>

Useful when:

* You want to link to external files in your project in Ranorex scripts

Guide:

In Ranorex Studio, open the desired  project and navigate to the script's subfolder. Then right-click the subfolder and select the ‘Add’ option.

<figure><img src="https://lh4.googleusercontent.com/VmK3mVR8j-JSVfXG8WHIHJI5jFob7s34QE9C0XX_K-vC5J2unziKArtUVoMi8IQa3MBjWFngfzwNCe6dVB-7ceg1wvaSkYixf6392QoHwou9tV9p79ORz6fOMo4xq9vaxAx3alfEyYpUaeVQOo6J5sY" alt=""><figcaption></figcaption></figure>

From the context menu, pick ‘Existing item’ and, once you select the file, click the ‘Link’ button.

<figure><img src="https://lh5.googleusercontent.com/kR276qVkwRk8OEUbX5BfiZhxBFWBQTjLBM4_IItBHX18WTu_j8su1GFjUflwYGPy7FH9D9o-fVSJFAJNas6ENzJs3EYZKbplVwQ-cQAL-HBgquRcut0N9xpbHfG-X-Xq2qHUowUmQu2qCkhK9bkIzXI" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Please note: when you link external files to multiple projects, you need to remember that it’s now dependent on the linked files that are not managed by aqua. As a user, you need to make sure that these files are located in the same place where they were originally linked from.&#x20;
{% endhint %}

For example, if you developed the script on machine A, the linked file must be accessible in the exact same location on machine B in order to run the script there. aqua only establishes the link to the file and doesn't handle actual access to the file.&#x20;

### New change log widget for Cloud users <a href="#new_change_log_widget_for_cloud_users" id="new_change_log_widget_for_cloud_users"></a>

The new changelog widget is available for all Сloud users and doesn’t require any action from the user side.

It was introduced as a part of aqua renovations. We will be notifying you about important changes, planned releases, new features, upcoming events and other updates in aqua to keep you informed and stay open to feedback.<br>

Whenever the news is published, there will be a red dot next to the button, indicating that there is an unread message.

<figure><img src="https://lh5.googleusercontent.com/sSKaflwJLKo3YzAPIooNEV6tLb4zotJKGpAe3wUvvdOltLP29E-XkIVMpBDe97LtcS-EGQU47SZRoLZwLLdyQRGbfBwBZj6FiFd7ktBcsDW6HnZoy3C_eL4nXZk8ogwsNesRtmsFKqZa8UCpCSqXVhI" alt=""><figcaption></figcaption></figure>

<br>

Click the ‘What’s new’ button, and the pop-up with the recent updates appears. Click on the title to see the full details.

### New aqua home page <a href="#new_aqua_home_page" id="new_aqua_home_page"></a>

<br>

<figure><img src="https://lh6.googleusercontent.com/bm8QYieuNUf2QmSiqSpDcR8X8WPCxJQBHqtn33fdqIFzQeq4-kVIffhBUk3RVvIpeScg9AgKGPqJ5K8h8EeB417g2cZDcVuFn_lcK-l5TcJQCQNKuvV7fnGLXuqFCbQQz-aWBT4UCwfvkZ_mKgyNI-o" alt=""><figcaption></figcaption></figure>

With the new aqua home page, you can get much easier access to all aqua offerings, partners and products. You can also find documentation or contact our customer support here.<br>

It doesn’t require any actions of cloud users, for on-premise customers we are preparing a separate document on how it can be configured and enabled.\
In case you don’t have these feature guidelines at hand in the future, we got you covered. You can find all the information on the new features in our [aqua wiki.](https://docs.aqua-cloud.io/documentation/web-client/getting-started)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aqua-cloud.io/documentation/product-updates-for-public-and-private-clouds-customers/product-updates/2023/23.70.0-public-and-private-clouds.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
