> For the complete documentation index, see [llms.txt](https://docs.aqua-cloud.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aqua-cloud.io/documentation/aqua-intelligence/create-documents-with-ease-with-aqua-intelligence.md).

# Create documents with ease with aqua Intelligence

Effortlessly create documents with aqua Intelligence. Streamline workflows and boost productivity using intuitive, AI-powered document generation tools.

With aqua Intelligence, creating various types of documentation is a breeze, whether you're an experienced pro or just starting out.

You can create requirements with aqua Intelligence from multiple places using different approaches.

{% hint style="info" %}
To get started with aqua Intelligence, make sure you have AI features enabled for your account. If you haven't already, request access to the beta version by reaching out to us at **<support@aqua-cloud.io>,** and we'll enable it for you right away.
{% endhint %}

If you want to use AI right from the start, click the ‘Add requirement’ button on the main page and select 'With aqua Intelligence'

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FLr2QtdkFgSJxD1krlxaA%2Fimage.png?alt=media&amp;token=3e362d34-d2a2-49ee-a030-8dd2e5ffc088" alt=""><figcaption></figcaption></figure>

When the modal pops up, you have three options:

* create based on description: typed on narrated,
* create based on a file.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FJxJsssgQ9GClpE07oreG%2Fimage.png?alt=media&amp;token=0a397879-a049-4a76-b827-858110e6d018" alt=""><figcaption></figcaption></figure>

To create based on narration, click on the microphone icon and speak your ideas to aqua Intelligence to analyze and convert into text. You can modify it further if needed.

When you click on the icon, the system will ask you to grant access to your microphone. You need to enable it only once by clicking the ‘Allow’ button.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FhOyiwWEXDqzAQwIbWrj3%2Fimage.png?alt=media&amp;token=bfb65a3d-af97-4d77-96e4-560aaf5f987d" alt=""><figcaption></figcaption></figure>

Once you enable it, the recording will start automatically in 3 seconds without any other actions needed from your side.

Just start narrating your thoughts.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FPS6hCp0Eyeo0lUNhL1Fa%2Fimage.png?alt=media&amp;token=dc740cd4-2f0e-4d30-bd62-9ab3a03774fa" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Your recorded audio is kept temprorary to generate a document and then removed once it's done.
{% endhint %}

At first, it might be a bit unusual, 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 closing the popup. To stop recording, you need to click the ‘Stop’ button.

When the recording is stopped, aqua Intelligence will be triggered to analyse what has been said and in a few seconds start trsnascipting the text. Feel free to edit it or start creating the document immediately.

**Supported languages**

You can record in any popular language. aqua Intelligence will transcribe your speech and convert it into text. It will then use this context to create a document

{% hint style="success" %}
**aqua Intelligence nararrtion feature currrently support inputs in the following languages:**

Afrikaans, Arabic, Armenian, Azerbaijan&#x69;**,** Bosnian, Bulgarian, Catalan, Chinese, Croatian, Czech, Danish, Dutch, English, Estonian, Finnish, French, Galician, German, Greek, Hebrew, Hindi, Hungarian, Icelandic, Indonesian, Italian, Japanese, Kannada, Kazakh, Korean, Latvian, Lithuanian, Macedonian, Malay, Marathi, Maori, Nepali, Norwegian, Persian, Polish, Portuguese, Romanian, Serbian, Slovak, Slovenian, Spanish, Swahili, Swedish, Tagalog, Tamil, Thai, Turkish, Ukrainian, Urdu, Vietnamese, and Welsh.
{% endhint %}

{% hint style="info" %}
Please note that while you can speak to aqua Intelligence in any lanaguge, currently it can generate the document only in English or in German. The generation language is defined by your app settings.
{% endhint %}

**Option 2**

Alternatively, you can paste information or manually enter notes in the corresponding text box.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FKJqmaPVas0ET9ZpaP0e7%2Fimage.png?alt=media&amp;token=0e00b4f6-6ba3-4952-a9ba-396623ab06c7" alt=""><figcaption></figcaption></figure>

Give aqua Intelligence as many details as you like, but remember you're providing hints, not writing the entire document. Let aqua Intelligence do its magic.\
Once you've provided some details, choose the type of document you want to create and wait a few seconds.

If the initial document isn't quite what you're looking for, no worries. You can regenerate it as many times as needed until you're satisfied. You can also make adjustments to the output.

Once you happy with the document, click the button ‘Add’ to finish creating the ticket.

#### Option 3

In case you have designs of the app or UML diagrams, files with some data, you can upload this file and generate a document based on it.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2F15hCAapMZ8fPgksmL6vZ%2Fimage.png?alt=media&amp;token=274d2ec2-f44b-4053-bb69-11e64f1e620b" alt=""><figcaption></figcaption></figure>

First, upload your file and provide some additional details as a context for aqua Intelligence. This is information is optional, but helps AI understand better what needs to be generated.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FduI3XgncHH5SuBNwyIfs%2Fimage.png?alt=media&amp;token=07c166b8-29d0-4163-9a4e-068ddfa46a6a" alt=""><figcaption></figcaption></figure>

Once a document is generated, you can modify it or if you are happy with the results, add it as it to the project.

{% hint style="success" %}
aqua Intelligence is here to make your documentation tasks a whole lot easier, so have fun creating and editing your documents effortlessly!
{% endhint %}

{% hint style="info" %}
Please note that while this feature is in beta, it has a few limitations:

* It can process only 1-page PDF files.
* It can generate only one document at a time.
* Only 50 credits for generation are provided for the entire organization and are reset on the 1st day of each month.
* Regenerating a document uses one credit.
  {% endhint %}

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

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FCuaKuzTKWQZBQduyiyqc%2Fimage.png?alt=media&amp;token=5642931e-d355-443b-83f7-80232023a71a" alt=""><figcaption></figcaption></figure>

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.aqua-cloud.io/documentation/aqua-intelligence/create-documents-with-ease-with-aqua-intelligence.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
